The Problem
AI 辅助开发 ≠ 无规范开发
没有约束的 AI 编程助手就像没有刹车的高速列车 — 速度惊人,但随时可能翻车。
- 需求漂移 — AI 在长任务中逐渐偏离原始意图,交付的东西与需求无关
- 安全盲区 — hardcoded secrets、SQL 注入、XSS 漏洞被 AI 像写注释一样随意生成
- 质量坍塌 — 没有测试、没有 review、没有 linting,代码能跑但不可维护
- 知识蒸发 — 每次对话结束,设计决策和踩坑经验随之消失,无法积累
The Solution
6 阶段门禁流水线
每个阶段都设有闸门审批 — 不通过则不能进入下一阶段。流水线即标准,标准即质量。
需求 · Spec
需求审讯协议
interview-me
interview-me
架构 · Plan
技术方案评审
DDD 对抗审查
DDD 对抗审查
脚手架 · Scaffold
项目模板生成
5 种开箱模板
5 种开箱模板
编码 · Build
自主构建模式
/build auto
/build auto
门禁 · Review
4 层 Code Review
Quick→Auto→Deep→Human
Quick→Auto→Deep→Human
沉淀 · Ship
知识归档
.learnings → CLAUDE.md
.learnings → CLAUDE.md
Hard Rules
15 条硬性规则 · 无例外
安全、质量、规范三个维度各 5 条规则。不是建议,是门禁 — 任何一条未通过,流水线冻结。
安全规则
5 条
- 禁止 hardcode secret / token / password
- 所有用户输入必须经过验证和清理
- 第三方依赖必须审计许可证和已知漏洞
- API 端点默认要求认证,不允许匿名写操作
- 敏感操作必须有审计日志
质量规则
5 条
- 新功能必须包含测试,覆盖率不低于 80%
- 变更前必须通过 lint + type-check + format
- 关键路径必须有集成测试
- 破坏性变更必须有迁移指南
- 错误信息必须可操作,不能只是 "Something went wrong"
规范规则
5 条
- 每个项目必须有 README 和贡献指南
- 命名遵循项目约定,不使用拼音或无意义缩写
- 所有设计决策必须记录为 ADR
- Git 提交遵守 Conventional Commits
- 每个阶段结束后自动归档知识到 .learnings/
Capabilities
不止是规则,是一套完整的开发操作系统
需求审讯协议
interview-me 模式:一次一个问题 + 信心指数 + 信号词检测。不等 AI 猜测你的需求,而是让它来问你。消除需求歧义。
自主构建模式
/build auto — 一次批准后完全自主执行。AI 按流水线阶段逐一完成,每阶段自动门禁检查,无需反复确认。
4 层 AI Code Review
Quick AI → Auto Checks → Deep AI → Human。从 lint 到架构,层层递进。前 3 层全自动,Human 只审查 AI 标记的高风险变更。
Doubt-Driven Development
5 步对抗性审查流程,在架构阶段系统性地寻找假设漏洞。不是确认你做对了什么,而是找出你做错了什么。
10 大反模式清单
流程/认知/质量三维反模式,每个模式附带检测方法和修复方案。AI 在写代码时自动对照检查。
知识沉淀体系
三个层级:.learnings/(实时记录)→ patterns/(提炼模式)→ CLAUDE.md(规则固化)。每一次开发都在让下一次更高效。
Getting Started
一行命令,开始规范化
npx ai-dev-steward init
# 在你的项目根目录自动生成 CLAUDE.md + .learnings/ + 规则配置