用途:这是给 AI 代理使用的一种执行纪律,适用于任何涉及多个文件的改动、按任务拆解开发新功能、重构已有代码,或即将在未测试前写超过约100行代码的场景。单文件单函数的小改动不属于此范围。
主要能力:规定一个增量循环——实现最小完整功能、运行测试、验证(测试通过、构建成功、人工确认)、用描述性信息提交,然后进入下一片。提供三种切片策略:纵向切片(优先,让每个切片端到端可用,如先做任务的创建、再做列表、编辑、删除);契约优先切片(先定义 API 契约,前后端并行开发再集成);风险优先切片(先验证风险最高的部分)。还给出实现规则:简单优先,避免过早抽象;限定改动范围,不顺手清理无关代码;一次只做一件事,不在同一提交里混合功能与重构;保持可编译、现有测试通过;未完成功能用功能开关隐藏;新代码默认安全保守;每片可独立回滚,数据库迁移配回滚。
使用方式:给代理下指令时明确说明本次增量包含什么、不包含什么,并让它实现后运行测试与构建命令验证,例如 npm test 和 npm run build,以及 npx tsc --noEmit、npm run lint。每片完成后可对照清单检查:只做一件事、测试全过、构建成功、类型检查通过、功能符合预期、已提交。
适用场景:多文件新功能开发、重构、需要合并小增量到主分支的进行中工作。
限制:不适用于单文件单函数的极小改动;具体项目使用的测试、构建、类型检查与 lint 命令需按项目实际情况确定,本资料仅给出示例;工具链与语言支持等细节暂未提供。