ai-codespec

@ai/ai-codespec · Manifold Tech 团队内部 CLI

仅需一行指令，
让 AI Agent 装好团队规范与资产

统一分发团队 skills、workflows 与代码规范。
当前支持 Windsurf 和 Qoder，更多 AI 编程助手持续接入中。

立即安装 查看仓库

将下方提示词复制给你的 AI 助手（Claude Code / Codex / Cursor / Windsurf / Trae 等任意 Agent 均可执行），它会自动完成安装。
注：当前支持 Windsurf 和 Qoder 两种 Agent。

提示词
帮我安装 ai-codespec：http://ai-codespec.manifoldtech.cn/install.md

AI 会自动读取安装指南、配置 npm registry、安装 CLI 并同步团队 skills / workflows。

配置完成后，重启你的 AI Agent 即可开始使用 → 使用指南 · 仓库地址 · 更新日志
前置条件：Node.js ≥ 18 没装 Node？请先按团队 《Node.js 环境安装指南》安装。AI Agent 模式下，AI 检测不到 Node 时会主动引导你完成。

为什么需要 ai-codespec？

把团队的 AI 编程规范、Skills、Workflows 一次装齐，让每个人的 AI 助手都"懂团队"。

统一团队 AI 资产

Skills、Workflows、Slash Commands 集中维护，全员一行命令同步，避免每人手抄一份。

多 AI 工具兼容

当前支持 Windsurf 和 Qoder 全局 Skills / Workflows。Claude Code、Codex、Cursor 等正在评估接入。

自动备份 & 清理

覆盖前自动备份，最多保留 3 份；--clean 按 manifest 安全清理已下线的托管 skills，绝不误删个人资产。

团队私有 Registry

包托管在团队 Verdaccio 私有 Registry，安装无需任何 Token。

支持的 AI 编程助手

当前路线图：先把 Windsurf 跑稳，再陆续接入团队主力的其他 Agent。

AI 编程助手 状态 说明
Windsurf 已支持 同步全局 skills、workflows，覆盖 review / debugging / git 工作流等。
Qoder 已支持 同步全局 skills，覆盖 review / debugging / git 工作流等。
Claude Code 评估中 需要打通 skills / commands 同步路径，目前可手动复用 prompt。
Codex / Cursor / Trae 评估中 视团队使用情况推进，欢迎到 GitLab Issue 区反馈优先级。

内置 Skills 与 Workflows

安装后一键同步到 Windsurf 全局目录，AI 自动按场景调用。

Skills

  • mt-dev⭐ 推荐 — 从想法到上线的一条龙研发流程：Grill 压实想法、Spec 撰写规格、Tickets 拆工单、Implement 落地代码、Review 审查交付。可由 /dev 触发或中途进入。2026-09-17
  • mt-epic⭐ 推荐 — 持续实现一个由多个工作项组成的开发事项：Create 建 Epic 并拆依赖、Inspect 以 Git/执行器事实对账、Advance 有界推进一轮。状态存于 ~/.manifold。2026-09-16
  • mt-dispatch⭐ 推荐 — 安全执行一个已明确的工作项批次：Prepare 整理到无歧义、Dispatch 派发（隔离 worktree、并发上限）、Resume 幂等恢复。独立于 Epic 使用。2026-09-16
  • mt-devin-cli⭐ 推荐 — 完成一次 Devin CLI 执行：Start 新起一次执行、Resume 续接上一次、Inspect 检查执行事实。排查 Devin CLI 报错、认证、权限、会话问题。2026-09-16
  • mt-feishu-project飞书项目工单创建与排期统一入口：创建需求/工单、排期、补子任务、流转节点。含 l6wd5h 空间字段元数据缓存和团队成员岗位角色映射。2026-09-01
  • mt-meegle飞书项目（Meego/Meegle）原生操作：查询/管理工作项、节点流转、视图查询、个人待办、排期统计、MQL 搜索。写操作强制 --dry-run 预览确认。2026-05-26
  • mt-code-review⭐ 推荐 — 深度语义代码审查，覆盖生命周期/并发、能力边界、作用域、安全、测试强度等，适配自 DeepSeek Harness。2026-08-14
  • mt-prose-standard文案/注释审查标准：保留完整命题、删除冗余叙述、各位置必要覆盖范围。适配自 DeepSeek Harness2026-08-14
  • mt-trim-cot-leakage清理 AI 生成残留：推理链泄漏、设计会引用、审查视角叙述、控制流叙述等。适配自 DeepSeek Harness2026-08-14
  • mt-pre-push-checks推送前最小测试选择：只跑覆盖当前 diff 的最窄检查，避免全量跑。适配自 DeepSeek Harness2026-08-14
  • mt-find-simplifications发现简化机会：死代码、重复、投机性泛化、过度构建、手写轮子等。适配自 DeepSeek Harness2026-08-14
  • mt-neat-freak知识与规范收尾（洁癖）：盘点代码、运行态、文档、规则、记忆与工作区残留并逐一收口，清场前必须汇报并经用户确认。引自 KKKKhazix/khazix-skills2026-09-23
  • mt-security-review全面代码审查，覆盖 20+ 语言 / 框架的安全、性能、架构。2026-07-21
  • mt-grill-code-review双轴审查规范与规格，并检查正确性、安全和性能。引自 mattpocock/skills2026-07-29
  • mt-domain-modeling维护领域术语、上下文和关键架构决策。引自 mattpocock/skills2026-07-29
  • mt-grill-me / mt-grilling通过逐项访谈压力测试计划、设计和决策。引自 mattpocock/skills2026-07-29
  • mt-grill-with-docs → mt-to-spec从深度访谈与领域建模生成可执行规格。引自 mattpocock/skills2026-07-29
  • mt-handoff生成可供另一个 Agent 接手的会话交接文档。引自 mattpocock/skills2026-07-29
  • mt-implement根据规格或 tickets 实现，并结合 mt-tdd 和代码审查。引自 mattpocock/skills2026-07-29
  • mt-setup-matt-pocock-skills为工程链路配置 issue tracker 与领域文档。引自 mattpocock/skills2026-07-29
  • mt-tdd按预先确认的测试接缝执行红—绿循环。引自 mattpocock/skills2026-07-29
  • mt-teach在工作区内建立多阶段、可持续的学习流程。引自 mattpocock/skills2026-07-29
  • mt-to-tickets将规格拆成带阻塞关系的垂直切片 tickets。引自 mattpocock/skills2026-07-29
  • mt-writing-great-skills编写可预测、高质量 Skills 的原则与术语。引自 mattpocock/skills2026-07-29
  • mt-debugging按"复现 → 定位 → 假设 → 验证"流程排查 Bug。2026-05-24
  • mt-frontend-design生成更有设计感的前端页面、组件与交互。2026-05-24
  • mt-go-init基于 gin + gorm + redis + zap 的 Go 项目脚手架。2026-05-24
  • mt-refactoring不改行为下的代码重构（拆分、命名、去重）。2026-05-24
  • mt-skill-creator创建 / 优化 / 评估团队 AI Skills。2026-05-24
  • mt-test-generation生成单元 / 集成 / 端到端测试。2026-05-24

Workflows

  • /mt-git-commit标准化提交：Conventional Commits + 推送。
  • /mt-git-feature启动新功能分支并搭建基础结构。
  • /mt-git-release版本号、Changelog、Tag 一站式发布。
  • /mt-review审查当前代码变更，重点找 Bug 与风险。

有好的 Rules / Skills / Workflows？欢迎贡献！

如果你在日常工作中沉淀了通用的提示词、AI 工作流或团队规范，希望让全员都能复用，有两种贡献路径：

  • 直接联系软件团队
    发到群里 @ 软件团队人员，描述适用场景即可，我们来负责落地。
  • 提 Merge Request 或 Issue
    在 GitLab 仓库新建 MR 把资产加进 assets/shared/skills/ 或 assets/windsurf/workflows/；不确定怎么落地，先开 Issue 一起讨论。
提交 Merge Request 提 Issue 讨论

常见问题

没装 Node 怎么办？

请先按团队 《Node.js 环境安装指南》安装 Node 18+，然后重开终端，再回来跑安装命令。AI Agent 模式下，AI 检测不到 Node 时也会主动引导。

npm install -g 提示 401 / 403？

检查 npm config get @ai:registry 是否指向 https://npm.manifoldtech.cn/；若 registry 正确仍报错，请联系维护者确认 Verdaccio 服务状态。

会不会覆盖我自己的 Skills / Workflows？

--clean 只删除 manifest 曾记录但当前包已移除的 skills，不会清理未记录的个人 skill。第三方 skill 可以保留上游原名；如与安装包同名，覆盖前会自动备份。

更新后没生效？

重启你的 AI Agent（Windsurf / Claude Code 等），或执行 ai-codespec update --clean 清理过期资产。