ai-codespec

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

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

统一分发团队 skills、workflows 与代码规范。
当前仅支持 Windsurf，Qoder 等其他 AI 编程助手待接入。

立即安装 查看仓库

将下方提示词复制给你的 AI 助手（Claude Code / Codex / Cursor / Windsurf / Trae 等任意 Agent 均可执行），它会自动完成安装。
注：当前同步的资产仅在 Windsurf 中生效。

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

AI 会自动读取安装指南、配置 npm registry 与 token、安装 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 全局 Skills / Workflows。Qoder、Claude Code、Codex、Cursor 等正在评估接入。

自动备份 & 清理

覆盖前自动备份，最多保留 3 份；--clean 只清理已下线的 mt-* 团队资产，绝不动个人资产。

GitLab 私有 Registry

包托管在公司 GitLab Package Registry，团队只读 Token 一次配置即可。

内置 Skills 与 Workflows

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

Skills

  • mt-code-review系统化代码审查，覆盖逻辑 / 安全 / 性能。
  • mt-debugging按"复现 → 定位 → 假设 → 验证"流程排查 Bug。
  • mt-frontend-design生成更有设计感的前端页面、组件与交互。
  • mt-go-init基于 gin + gorm + redis + zap 的 Go 项目脚手架。
  • mt-refactoring不改行为下的代码重构（拆分、命名、去重）。
  • mt-skill-creator创建 / 优化 / 评估团队 AI Skills。
  • mt-test-generation生成单元 / 集成 / 端到端测试。

Workflows

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

常见问题

没装 Node 怎么办？

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

npm install -g 提示 401 / 403？

检查 npm config get @ai:registry 是否指向公司 GitLab；若 registry 正确仍报错，说明只读 Token 未配置或失效，请到飞书 Wiki 安装指南重取 Token，或联系维护者。

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

不会。团队资产统一以 mt- 前缀命名，安装、更新、清理只处理 mt-*，绝不动你个人的 skills 与 workflows。

更新后没生效？

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