AI DevKit

English | 中文

你的 AI 编程助手团队虽然快速、积极，但往往鲁莽行事。让它们像资深工程师一样工作吧。

AI DevKit 将一次性的 AI 编程对话转变为可重复的软件交付工作流：需求分析、设计、规划、实现、测试、验证、记忆和评审。

• 杜绝“提示词撞大运”的编程方式 —— /new-requirement 指令强制 AI 在触碰代码前必须先理清问题。
• 拦截虚假的“完成”声明 —— verify 指令要求在声明任务完成前，必须提供最新的测试/构建输出。
• 保持项目知识的连贯性 —— @ai-devkit/memory 在不同会话间存储决策、约定和修复方案。
• 推送前捕获偏差 —— /code-review 指令会根据设计文档和需求文档对代码差异（diff）进行审核。
• 统一的控制台 —— agent console 是一个实时的 TUI 仪表盘，无论使用哪种 AI 服务商，都能集中管理所有正在运行的代理。

一套配置，适配所有编程代理：Claude Code、Cursor、Codex CLI、Gemini CLI、GitHub Copilot、opencode、Antigravity、Amp、Windsurf、Kilo Code、Roo Code。

运行 npx ai-devkit@latest init，你的代理将获得：

你需要什么	AI DevKit 安装了什么
编码前的规划	/new-requirement, /review-design, 和 /execute-plan
完成前的证据	与最新测试/构建输出绑定的 verify 门禁
跨会话记忆	通过 MCP 和 CLI 暴露的本地 SQLite 记忆
代理间行为一致	为你团队使用的编码工具生成统一配置

适用人群

对于那些每天使用 AI 编程助手，并厌倦了以下问题的开发者：

• 为每个项目重复配置 CLAUDE.md / .cursor/rules / AGENTS.md
• 代理总是忘记昨天的开发约定
• 代理一边说着“我已成功实现功能”，一边伴随着错误的构建结果
• 代理没有计划就直接开始写代码，导致产出与需求不符

在使用 AI DevKit 之前，你的代理只是一个能力强但表现不一致的聊天机器人。使用 AI DevKit 后，它将拥有随代码库同步的工作流、记忆、验证门禁以及可复用的技能。

无 AI DevKit 时	使用 AI DevKit 后
在每次对话中重复项目规则	代理首先搜索项目记忆和文档
代理从提示词直接跳到代码	代理按需经过需求、设计和计划阶段
“完成”意味着代理停止了编辑	“完成”需要最新的验证输出
每个代理需要单独维护规则	一套配置协调所有命令、技能和 MCP 设置

30 秒快速上手

npx ai-devkit@latest init

通过引导程序，选择你的代理，安装工作流，并赋予它们统一的运行模式。它会生成可评审并提交的项目本地配置文件。每当你变更代理列表或工作流时，均可随时重新运行该命令。

项目中将会生成以下结构：

your-project/
├── .ai-devkit.json              # 单一事实来源 (可随时重新运行 init)
├── .claude/                     # 或 .cursor/, .codex/, 等 (按你选择的代理生成)
│   ├── skills/                  # dev-lifecycle, verify, memory, tdd, ...
│   ├── commands/                # /new-requirement, /execute-plan, /code-review, ...
│   └── settings.json            # 已配置的 MCP 服务器 (包含 @ai-devkit/memory)
└── docs/ai/
    ├── requirements/            # 第一阶段 — 做什么，为什么做
    ├── design/                  # 第二阶段 — 如何构建
    ├── planning/                # 第三阶段 — 逐项任务规划
    ├── implementation/          # 第四阶段 — 执行记录
    └── testing/                 # 第五阶段 — 覆盖率策略

或者获取完整的工程工作流栈

将 templates/senior-engineer.yaml 保存到本地并运行：

ai-devkit init --template ./senior-engineer.yaml

这套模板整合了八种内置技能，并包含了来自 Anthropic、Vercel 等机构的精选内容 —— 包括 TDD、前端设计、Web 应用测试、文档共创、React 最佳实践、安全评审等。

功能演示：端到端工作流

你:     /new-requirement 添加 Google OAuth 登录

代理:   搜索记忆库中过往的认证约定。询问关于范围、用户、成功标准的澄清问题。
        在功能工作树中草拟 docs/ai/{requirements,design,planning}/feature-oauth-login.md。
        在编写代码前暂停。

你:     /review-design feature-oauth-login

代理:   根据需求文档审计设计文档。在编写任何代码之前，标记出缺漏并提出修复建议。

你:     /execute-plan feature-oaut