JohnXu22786/spec-driven

README excerpt

龙骨（keel）——规格驱动开发纪律技能包 先立规格，再谈代码。把「防翻车」从口号变成技能、工具与门禁。 keel 是一个自包含的插件化技能包：以五个技能（锚定 → 立规 → 探针 → 建造 → 审计） 约束 agent 的编码行为，以三个工具提供规格生成与纪律审查，以模板变体适配任务规模。 适用于 dsh（DeepSeek Harness）等一切皆插件的 harness，也可脱离 harness 单独使用。 为什么需要它 编码翻车的三大主因： 1. 规格缺失 ——需求含糊就动手，实现方向错了返工最贵； 2. 假设未验证 ——把「以为」当「事实」，方案建在流沙上； 3. 工程失控 ——做得太多（过度工程）或做得偏了（范围蔓延）。 keel 的应对： 先写规格并验证假设，规格不过门禁禁止动手；实现期间用守则防过度工程、 用变更单防范围蔓延；交付前逐条验收审计。 纪律以技能/提示词形式约束 agent 行为， 以工具形式提供确定性检查，不以人的自觉为依赖。 五步纪律环 步骤 技能 动作 产物 门禁 1 锚定 keel-anchor 边界三问：要做什么、不做什么、成功长什么样 三句话 三句话均可验证 2 立规 keel-spec 按规模选模板，生成规格书 SPEC.md keel review 零错误 3 探针 keel-probe 登记假设、标注风险、高风险先行验证 ASSUMPTIONS.md [高] 假设全部有结论（KEEL-0303 强制） 4 建造 keel-build 按规格实现，遵守十条守则与范围护栏 代码 规格冻结、变更走变更单 5 审计 keel-audit 逐条核对验收标准，记录偏差与复盘 AUDIT.md 无未处置的 ❌（KEEL-0403 强制） 失败复盘也走同一套纪律：先写失败原因规格，再验证假设，再动手修。 快速开始 方式一：接入 dsh（插件化 harness） 1. 将本目录放入项目，或复制到任意位置； 2. 创建 cordis.yml 补丁（可复制仓库根目录的 cordis.example.yml ），指向本插件入口： 3. 启动 harness 并加载补丁： 加载后模型获得三个工具（ keel catalog 、 keel spec 、 keel review ）与 五个技能（keel-anchor、keel-spec、keel-probe、keel-build、keel-audit）。 详细说明见 docs/INTEGRATION.md。 方式二：脱离 harness 裸用（CLI） 值含空格时须加引号（如上）。 review 退出码 0 表示无错误（可接入 CI 门禁）， 1 表示存在错误。零依赖，Node ≥ 22.18 直接运行。 工具接口 工具 作用 keel catalog 列出技能与模板清单（路由入口） keel …

Category