可交付代码规范
让 AI 写能过评审的代码:先定验收标准和改动边界,再出最小改动,缺陷要拿出修复前后证据。
功能与用途
让 AI 改代码最常见的结果是大段重写、顺手改了无关地方、说修好了却拿不出证据,review 阶段全还回来了。这个能力给 AI 编码套上一套纪律:开工前先把目标、验收方式、不能碰的范围和约束写成契约;改动只做局部最小集,行为变更和格式整理分开;修缺陷必须先复现失败再改,改完用同一条命令证明修好;收尾交一份说明动了哪些文件、验证结果、遗留风险和回滚办法。连试两次还搞不定就停下来请示,而不是继续乱试。
适用场景
- 让 AI 修一个线上缺陷,它一口气改了几百行还说修好了,评审:让 AI 修一个线上缺陷,它一口气改了几百行还说修好了,评审时完全看不出哪些是真需要的改动
- 要改核心支付链路,任何越界改动都可能出事,需要在动手前就把不:要改核心支付链路,任何越界改动都可能出事,需要在动手前就把不能碰的范围写死
- 线上回归问题有时序依赖,需要先能稳定复现,才谈得上修:线上回归问题有时序依赖,需要先能稳定复现,才谈得上修
适用人群
- 用 AI 协作提交生产代码的后端/客户端开发
- 带团队做代码评审的技术负责人
- 做 iOS/macOS 交付的 Swift 开发
使用步骤
- 动手前先写一份简短契约:一句话目标、怎么算验收通过、哪些不碰、有什么约束
- 按四步循环执行:复述问题与假设、先定验收检查、产出最小改动集、留痕并说明残余风险
- 缺陷类任务先复现失败条件,再改,再用同一条检查证明修好,不凭感觉宣称已修复
- 收尾交出交付说明:改了什么、动了哪些文件、跑了什么验证、有什么风险、怎么回滚
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- 1.0.0
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Ship production code with AI agents through acceptance contracts, micro diffs, red green loops, and deterministic handoff checkpoints.
使用前准备
- 需要安装 git
- 过程记录写在 ~/agentic-coding/ 目录下,首次使用按 setup.md 初始化并自行决定是否持久化
依赖与权限
- 读取用户主动提供的内容