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 只清理已下线的 mt-* 团队资产，绝不动个人资产。

团队私有 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-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生成单元 / 集成 / 端到端测试。
  • mt-security-review全面代码审查，覆盖 20+ 语言 / 框架的安全、性能、架构。

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？

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

更新后没生效？

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