dev-loop
/dev-loop
Prowadzi cały cykl pracy nad kodem: od wyjaśnienia wymagań przez plan i testy po przegląd, dokumentację i naprawę błędów.
- Autor
- BHLO ↗
- Repozytorium
- dev_loop ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 7
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi cały cykl pracy nad kodem: od wyjaśnienia wymagań przez plan i testy po przegląd, dokumentację i naprawę błędów.
Oryginalny opis (EN)
研发闭环总控。当用户提出新需求、要评估影响面、要按方案实现(TDD)、要判断改代码是否改全、要检查代码健康度、要同步文档、或贴出报错要定位并修复时使用。一个入口串起「需求澄清追问 → 影响面与方案 → TDD 实现 → 变更审计 → 文档同步 → 健康检查 → 缺陷定位 → 提交」八个阶段,需求先问清、实现先写失败测试、每个阶段都要你确认才往下走。
Jak działa
- 一、这个技能解决什么
- 二、铁律
- 三、每轮启动(固定动作)
- 四、路由表
- 五、S0 需求澄清(先问清,再设计)
- 六、S1 需求影响面与技术方案
- 七、S2 实现(TDD)
- 八、S3 变更审计(改全了,也写对了?)
- 九、S4 文档同步
- 十、S5 健康检查
Podgląd SKILL.md
---
name: dev-loop
version: 1.16.0
display_name: 研发闭环
display_name_en: Dev Loop
description: 研发闭环总控。当用户提出新需求、要评估影响面、要按方案实现(TDD)、要判断改代码是否改全、要检查代码健康度、要同步文档、或贴出报错要定位并修复时使用。一个入口串起「需求澄清追问 → 影响面与方案 → TDD 实现 → 变更审计 → 文档同步 → 健康检查 → 缺陷定位 → 提交」八个阶段,需求先问清、实现先写失败测试、每个阶段都要你确认才往下走。
description_zh: 一条从需求到提交的研发闭环:先用弹窗把需求问清(目标/边界/验收/约束四类),再出技术方案与影响面清单,然后按 TDD 先写失败测试再实现,接着审计改动是否改全、同步文档、检查代码健康度,最后定位修复缺陷。每个阶段都要你确认后才往下走,改完必测并回访验收,提交前先过目。
description_en: An end-to-end dev loop for AI coding agents — requirement clarification first, then tech plan and impact analysis, TDD implementation, change audit, doc sync, health check, and bug triage. Every stage stops for your approval; nothing is committed until you confirm.
agent_created: true
---
# 研发闭环(dev-loop)
## 一、这个技能解决什么
八个阶段串成一条链,**每步的产物就是下一步的输入**:S0 的验收标准是 S2 写测试的依据,
S1 的改造清单是 S3 判定漏改的验收标准,S3 的 diff 是 S4 判定哪些文档要改的输入,
S6 修完必须回 S3 重审。所以不用中途换技能、重复讲背景。
| 阶段 | 干什么 | 为什么必须有它 |
|---|---|---|
| S0 需求澄清 | 四类追问:目标范围/边界异常/验收标准/约束兼容 | 不问清就出方案,方案越漂亮越偏 |
| S1 影响面与方案 | 技术路线、实现流程、架构图、改造清单 | 不知道改哪、为什么改,就等于没设计 |
| S2 实现(TDD) | 先写失败测试,再实现到绿,重构 | 没有红阶段,测试只证明代码这么写 |
| S3 变更审计 | 漏改 / 越界 / 动作不符 / 实现质量 | 改得不全,比不改更危险 |
| S4 文档同步 | 文档判定,没有就新建 | 代码改了文档没改,下一个人就踩坑 |
| S5 健康检查 | P0/P1/P2 问题清单 | 隐患攒着,迟早集中爆 |
| S6 缺陷定位 | 现象 → 根因 → 最小修复 | 照着报错瞎改,改出新 bug |
| S7 提交 | 验证、清单、确认、推送 | 没测就提交,等于把风险推给全组 |
## 二、铁律
1. **单一入口**:命中本技能后,由本技能的检查项完成工作,不要再转去调用其他代码审查、测试设计、bug 诊断技能。
2. **先跑脚本,再下判断**:`scan` 只跑一次,其余阶段复用 `.devloop/项目画像.json`。凭印象列影响面是无效产出。
3. **每阶段必须有落盘产物**,统一写在 `<root>/.devloop/`,不写进源码目录。
4. **阶段状态写盘**:每阶段结束调用 `state --set`,下一轮先 `--show` 续做,不要重新开始。
5. **不臆造**:脚本没跑通、测试没跑过,就标 `NOT RUN` 并给出下一条可执行命令。
6. **默认只读**:S0、S1、S3–S6 只分析不改代码。**只有 S2 实现和 S6 修复环节动代码**,且都得先有方案。
7. **每条改造都要有理由**:只写「文件 + 动作」的清单是待办列表,不是影响面分析。
8. **敏感文件先问再改**:命中 `references/sensitive-files.md` 的清单,未获明确同意不得修改,见 §12。
9. **偏离清单先停再说**:实际改动与 S1 清单不符,先告知原因并等确认,不许静默跳过,见 §13。
10. **方案先给,清单后给**:S1 必须先出技术路线、实现流程、架构图,再出改造清单。只有清单没有方案,等于没做设计。见 §6.1。
11. **每阶段都过目**:S0–S6 每个阶段收尾都要把产出贴给用户,**明确同意后才能进下一阶段**;不适用也要显式跳过。见 §6.6。
12. **改完必测**:任何代码改动都要跑测试验证;未通过不得提交、不得宣布完成,见 §14。
13. **提交先过目**:先出清单和提交信息,贴给用户看,**用户明确同意后**才提交并推送;重大改动打标签。装有 hook 时,直接 `git commit` 同样会被拒。见 §15。
14. **盲区必须人补**:脚本报的调用方是「静态能看见的」,反射、DI、动态路由、跨服务调用
一律看不见。S1 的盲区一节不许留空,也不许拿「应该没有」糊弄,见 §6.2 第 5 步。
15. **实现质量有下限**:S1 定实现约束,S3 用 `quality` 逐条核。P0 必须改完,P1/P2 豁免要写理由。
16. **产出用清单和表格,给用户看页面**:Markdown 写盘,登记时自动出 HTML(留历史),
present_files 打开。每条结论必须带 `文件:行号`。
17. **需求先问清再设计**:新需求不许直接出方案。S0 四类追问(目标范围/边界异常/验收标准/约束兼容)
都有具体答案、验收标准至少一条可测,才算收敛;含糊的回答标 `ASSUMED` 并回头再确认。见 §五。
18. **实现走 TDD,不许先写代码后补测试**:每条验收标准对应一个测试,先跑出红色再实现到绿;
纯文档/配置/样式可显式豁免(`gate --stage S2 --skip --note`),S3 会复核这条豁免。见 §七。
19. **实现完回访**:逐条验收标准问用户「满足了吗」,原话记进 S2 报告;不满足当场打回 S2。见 §5.4。
## 三、每轮启动(固定动作)
脚本路径:本技能目录下 `scripts/devloop.py`,下文记为 `$DL`。
```bash
python $DL next --root <root> # 当前停在哪一阶段、下一步做什么
python $DL scan --root <root> # 首次运行,或目录结构大改后
```
**接手先跑 `next`**:它读状态与记录,直接说下一步。
**换个会话接手**:进项目目录(子目录也行)直接 `resume`——它向上找 `.devloop/状态.json`
认当前项目,并打印「识别依据」;不在任何项目里再用 `resume --all` 列全部,带上完整路径续跑。
**断了、回来说「继续」——先重放,不许推进。** `next` 报某阶段待确认时,打开
`看板-<阶段>.html`、复述 3 条结论、问一句具体的;「继续」不算确认(`gate` 返回 4)。
**新需求先判断是不是新一轮**(上一轮还有未闭环项、或主题不同):
```bash
python $DL state --root <root> --round "<需求一句话>"
```
归档上一轮清单、清空全部确认记录、重置到 S0。**不重置会把上一轮的文件混进这一轮的对账。**
## 四、路由表
| 用户说法 | 进入阶段 | 第一动作 |
|---|---|---|
| 新需求 / 需求变更 / 这个功能要改成… / 加个字段 | S0 | `state --round` → `stage --stage S0` → **弹窗四类追问** → 填问答表 → `gate` → **等确认** |
| 方案确认了,开写 / 实现一下 / 按方案改 | S2 | `stage --stage S2` → **先写失败测试** → 实现到绿 → 回访确认 → `gate` |
| 改完了 / 提交前看下 / 帮我 review / 有没有改漏 | S3 | `stage --stage S3` → `report` → **等确认** |
| 文档要同步 / 文档过期了 / 改了代码文档没更新 | S4 | `stage --stage S4` → 补判定 → `report` → **等确认** |
| 检查代码质量 / 有没有隐患 / 技术债 | S5 | 增量或全量扫描 → `report` → **等确认** |
| 报错 / 抛异常 / 线上 500 / 修一下 | S6 | 现象结构化 → 栈帧映射 → `report` → **等确认** |
| 提交 / 提一下 / 发版 / 打个标签 | S7 | `verify` → `commit`(出清单)→ **等确认** → `--apply --push` |
| 不知道下一步该干嘛 / 接手别人的进度 | 任意 | `next` |
| 只说了"帮我看看这个需求" | S0 → S1 | **先问清再出方案**,不问就写方案等于猜 |
**每个阶段之间都要停**:S0 问答表、S1 方案+清单、S2 红绿与回访、S3 对账单、
S4 文档清单、S5 问题清单、S6 修复方案,逐份过目后才往下走(§6.6)。
除阶段门之外还有两处必停:命中敏感文件(§12)、发现偏离清单(§13)。
阶段不适用时不要默默跳过,显式标记并说明理由:
```bash
python $DL gate --root <root> --stage S4 --skip --note "<用户原话>"
```
**需求变更(第二轮及以后)也一样**:先 `state --round "<需求名>"` 重置轮次,再从 S0 走一遍。
轮次重置会清空全部确认记录——上一轮的批准绝不带到这一轮。
需求中途变了(S1 之后才冒出新条件),回 S0 补一轮问答再继续,不要半路改方案。
## 五、S0 需求澄清(先问清,再设计)
**目标**:把「用户以为说清楚了」变成四条谈定的事——做什么、边界在哪、怎么算做完、有什么约束。
没走这一步就出方案,方案越漂亮越偏,最后一定要返工。
```bash
python $DL stage --root <root> --stage S0 # 生成问答表骨架(四类问题已列好)
python $DL check --root <root> --stage S0 # 改稿时反复体检,只校验不登记
python $DL gate --root <root> --stage S0 --files a.py,b.py --doc .devloop/S0-需求澄清.md
```
### 5.1 四类问题,一轮问一类
用弹窗问(AskUserQuestion),**每轮 3–4 个,问完立刻把答案写回 `S0-需求澄清.md` 的问答表**,
再问下一轮。一次抛八个问题,用户会挑着答,剩下的就悄悄丢了。
| 类别 | 必须问到的点 | 没问清的后果 |
|---|---|---|
| 目标范围 | 谁、什么场景、现在怎么难受;涉及哪些入口(接口/页面/任务/消息);明确不做什么 | 方案做偏,改了一堆没人用的地方 |
| 边界异常 | 空值/默认值/超大值;重复提交与幂等;失败、超时、重试;事务边界 | 上线后第一笔脏数据就出事 |
| 验收标准 | 逐条可测的标准(带数值或可观察结果);谁验、在哪验、用什么数据验 | 「做完了」无法判定,验收靠感觉 |
| 约束兼容 | 存量数据与老接口要不要兼容;能否加表/加字段/改签名;性能、权限、审计日志;能否引新依赖 | 动手时才发现表不能改、接口不能变 |
每一类具体问什么(含 Java/Spring、前端的追加追问点)、弹窗话术模板、含糊答案的追问阶梯,见 `references/clarify-playbook.md`。
### 5.2 追问节奏与停止条件
1. 四轮四类:目标范围 → 边界异常 → 验收标准 → 约束兼容。
2. 答案含糊(「差不多」「看情况」「你定」)就追问一次;追问后仍含糊,标 `ASSUMED`,
写进「待定与假设」,并在 S1 方案里作为「待确认项」再确认一次。
3. **停止条件**:四类都有具体答案 + 验收标准至少 1 条可测 + 待定项都有处置办法。
缺一条就继续问,不许自己替用户补。
4. 用户说「你按你的理解做」:把理解**压成三句话复述给他**,等一句「对」再往下走。
没有这句「对」,不算确认。
5. 需求在 S1 甚至 S2 阶段变了:回 S0 补一轮,**不要在半路改方案**——改了没人复看,
方案和代码就会各说各话。
### 5.3 收敛判据(脚本会核)
`gate --stage S0` 直接拒收这几种:
- 问答表少于 4 行;
- 答案列空着,或写着「待定」「待填」——问了没答不算问清;
- 四类覆盖不到三类(同一类问三次不算问清);
- 验收标准一条都没有;
- 没有原样引用用户的需求原话(改写过的需求,后面没法追溯谁说了算)。
### 5.4 实现完还要回访一次
S2 收尾时逐条念验收标准问用户「这条满足了吗」,原话记进 `S2-实现.md` 的「回访确认」。
**不满足的当场打回 S2**,不许先标完成再补。跑完这一步,「需求是否被满足」才算有证据,
而不是「我觉得做完了」。
## 六、S1 需求影响面与技术方案
**目标**:在动代码之前,产出「改哪些文件、为什么改、改动怎么传导」的清单,作为后续验收标准。
### 6.1 先出技术方案,再出清单(强制)
**只有清单没有方案,等于没做设计。** 清单答「改哪几个文件」,方案答「怎么改、为什么、改完长什么样」。
顺序不能反:**先定方向,再由方案推出清单**——反过来就是照现有代码凑改法。
方案必须包含五样,缺一样 `gate` 会拒绝登记(完整样例见 `references/example-output.md`):
**① 技术路线(至少两个候选)**:对比表写「做法 / 优点 / 代价 / 结论」,并说明淘汰理由。
只给一条路线等于没比较;数据结构、接口契约、并发、兼容性逐项写取舍,不要一句「综合考虑」。
**② 实现流程(可执行步骤)**:编号步骤,每步写清改什么、依赖哪一步、怎么验证,
并说明**为什么是这个顺序**(哪一步是前置阻塞)。
**③ 架构图(Mermaid,至少一张)**:必须是 ` ```mermaid ` 代码块,否则 `gate` 判不合格。
画清改动落在哪一层、新增了什么、数据怎么流;只画本次相关部分,
每个框都要能在改造清单里找到对应文件。
**图会真的画出来,不是贴一段代码**:登记时把 mermaid 渲染成 SVG——页面内联,
另存 `.devloop/S1-架构图.svg` 可单独打开;不依赖 CDN。
画不出来就保留源码,见 `references/example-output.md`。
**④ 验收标准(可判定)**:写成能直接判断真假的条件,不写「功能正常」。
**⑤ 实现约束(防止方案过关、代码乱写)**:动手前就定好,S3 按这个查:
| 约束 | 写清什么 |
|---|---|
| 命名与分层 | 新符号放哪一层、遵循什么命名;不新建平行实现 |
| 错误处理 | 哪些异常要转业务错误、哪些要上抛;禁止吞掉不记 |
| 日志 | 用什么组件、记哪些字段;禁止 `print` / `console.log` 进主干 |
| 测试 | 新增/修改的行为各补哪些用例,跑哪条命令 |
| 兼容 | 老数据、老客户端、老配置怎么过渡 |
具体判据见 `references/quality-rules.md`——那里是 `quality` 命令实际会查的清单。
### 6.2 定位与影响面步骤
0. **一条命令跑完机械部分**(影响面 + 依赖图 + 盲区 + 敏感预检):
```bash
python $DL stage --root <root> --stage S1 --files <锚点文件>
```
产出 `.devloop/S1-素材.md`(素材)与 `看板.html`。**素材不是方案**,
技术路线/实现流程/架构图/改造清单/实现约束仍要你写。
1. **拆变更意图**:`{新增|修改|删除} × {接口, 字段, 表结构, 业务流程, 权限, 配置开关, 前端页面, 定时任务, 消息, 缓存}`。
2. **定位锚点**:用需求里的业务词检索代码,顺着 import / 调用链收一层。锚点 3–10 个。
3. **算影响面**:
```bash
python $DL impact --root <root> --files <锚点文件逗号分隔>
```
4. **补人工维度**:按 `references/impact-rules.md` 的六维逐项核查,把脚本看不出的项补进清单。
5. **核对盲区**(脚本看不见的部分,必须人补):
```bash
python $DL blind --root <root> --files <清单文件>
```
反射、DI 容器、动态导入、`**kwargs` 转发、字符串拼的路由——这些位置影响面清单**不成立**。
逐条确认是否与本次改动相关,写进方案的「静态盲区」一节。
**跨服务的调用、配置驱动的行为脚本一律看不见,只能人工列。**
6. **清单定稿**:按 §6.3 写成表格,编号 C1…Cn。**待新建的文件也要进清单**,文件名后标 `(新)`。
7. **依赖图**(用定稿后的清单,不是锚点):
```bash
python $DL graph --root <root> --files <清单里的全部文件> --depth 2
```
产出 `.devloop/依赖图.md`(Mermaid 图 + 分层 + 边表)。待新建的文件会画成虚线,不会被丢掉。
图用来定**改造顺序**:被依赖的先改,新建的表/文件通常在最前面。
8. **敏感预检**(重要,别等到改的时候才问):
```bash
python $DL sensitive --root <root> --files <清单文件>
```
命中高危/中危的文件,直接写进 §6.5 的「需要授权项」,**在方案阶段就让用户知道哪些要单独点头**。
9. **产出 `.devloop/S1-影响面与方案.md`**(下节格式)。
10. **清单入 state**:每条一行 `--add`,格式 `C1 | 文件 | 动作 | 理由`,后续 S3 用 `audit` 逐条对账。
11. **登记并停下**:
```bash
python $DL gate --root <root> --stage S1 --files <清单文件> \
--doc .devloop/S1-影响面与方案.md --summary "<需求一句话>"
```
报错说缺哪一节,说明方案没写全——**回去补 §6.1**。
登记后跑 `report` 并 present_files 打开页面,**等明确同意**(§6.6)。这一步没走完,不许改任何代码。
### 6.3 改造清单格式(每条必须有理由)
| 编号 | 文件:行 | 动作 | 改造理由 | 依据 |
|---|---|---|---|---|
| C1 | `src/api/user.py:42` | 改 | 入参校验写死全额,部分退款会被拦掉 | `refund.py:42` 校验分支 |
| C2 | `src/model/refund.py:15` | 改 | 缺 `refund_amount` 字段,无法记录部分金额 | 表结构对照 |
| C3 | `migrations/0031.sql` | 增 | 存量数据需要默认值,否则读取报空 | C2 的依赖 |
| C4 | `src/service/order.py:88` | 改 | 状态机无 PARTIAL_REFUNDED,退款后订单状态错 | 状态枚举缺项 |
写作要求:
- **理由不能复述动作**。「新增 delete_user 方法」不是理由;「调用方需要按 id 删除且当前没有该能力」才是。
- 理由必须能回答 **不改会怎样**,或 **为什么必须改这里而不是别处**。
- `依据` 必须可核查:引用点、契约、表结构、数据流,带 `文件:行`。
- 拿不准的写「疑似,待确认」,不要编。
- 还没有的文件在「文件:行」写 `migrations/0031.sql (新)`,行号留空。S3 对账时按新增文件核。
### 6.4 清单太长怎么办(硬规则)
文件数决定呈现方式,**不许平铺一长串**:
| 规模 | 呈现方式 |
|---|---|
| ≤ 8 个文件 | 单表全列 |
| 9–20 个 | 按模块分组,每组一张子表(≤ 8 行),组标题写模块名与文件数 |
| > 20 个 | 先分层(接口层 / 业务层 / 数据层 / 配置层 / 前端),每层只列**必改**与**建议改**,同类合并成「本层另有 N 个同模式文件」并给代表样例 2 个 |
配套要求:每层先给一句结论(这层为什么要动)再上表;**必须同时出图谱**(`依赖图.md`),
超过 20 个文件时图谱只画层间边、层内折叠;清单末尾给「改动顺序」,从被依赖最多的开始列前 5 步。
### 6.5 S1 报告必须包含的九块
顺序不能调——**方案在前,清单在后**,因为清单是方案推出来的结果。
| # | 块 | 内容 |
|---|---|---|
| 1 | 需求理解与验收标准 | 一句话复述需求 + 可判定的完成条件 |
| 2 | **技术路线** | ≥2 条候选,对比表 + 选型理由 + 淘汰理由 |
| 3 | **实现流程** | 编号步骤表(动作 / 依赖 / 验证) |
| 4 | **架构图** | Mermaid,标明改动落点与数据流;登记时渲染成 SVG,页面/独立文件里都是图 |
| 5 | **静态盲区** | `静态盲区.md` 里与本次相关的条目逐条说明怎么兜;没有就写「无」 |
| 6 | **实现约束** | §6.1 ⑤ 的五项,S3 按这个查 |
| 7 | **接口契约** | 仅跨端改时必填:路径/方法/参数与必填性/返回;不写就各自猜 |
| 8 | **界面方案** | 仅含前端改动时必填:页面/组件/三态/断点/token 来源;细则见 `references/ui-quality.md` |
| 7 | 影响面矩阵 | `层级 | 对象 | 是否受影响 | 依据(文件:行)` |
| 8 | **改造清单** | §6.3 的六列表格,待新建标 `(新)` |
| 9 | 授权项 + 依赖图 + 回归范围 | `敏感文件预检.md` 命中的文件、`依赖图.md`、必测/抽测 |
### 6.6 阶段确认门(每个阶段都要过)
**七个阶段每个都要停,不只 S1。**
**确认用弹窗**(同意 / 按意见改 / 不适用三个选项);正文末尾问一句「这样可以吗」不算确认。
流程对每个阶段都一样:
```bash
# 1) 登记:脚本校验报告内容,并自动生成页面(第 N 版,留历史)
python $DL gate --root <root> --stage S1 --files <清单文件> --doc .devloop/S1-影响面与方案.md --summary "<一句话>"
# 2) 用户提了意见(不是同意)
python $DL gate --root <root> --stage S1 --revise --note "<意见原话>"
# ……按意见改报告,再重新登记,回到第 2 步……
# 3) 用户明确同意后
python $DL gate --root <root> --stage S1 --approve --note "<用户原话>"
python $DL state --root <root> --set S3
# 这个阶段不适用时(比如本次无文档变更)
python $DL gate --root <root> --stage S4 --skip --note "<用户原话>"
```
**给用户看页面,不是源码,也不用翻整本。** `gate` 登记时同时出两份:
`看板.html`(全局)和 `看板-<阶段>.html`(只含本阶段,打开即定位)。
**必须用 present_files 打开本阶段页**;`report --focus S1` 可随时重出。
状态一变页面自动重渲染(登记/确认/跳过/退回/切阶段),断线回来就是最新状态。
样式按 `references/ui-rules.md`:颜色字号走 token、焦点可见、窄屏不横滚。
机制约束:
| 情形 | 行为 |
|---|---|
| 没登记 / 登记了没确认 / 前面某一阶段没确认 | `state --set` 返回 3,查的是 **S0 到上一级整条链** |
| 报告缺内容 | `gate` 拒登,逐条列出差什么 |
| 报告在你确认后被改过 | `--approve` 和 `state` 都拒:你看的必须就是现在这份 |
| 已出过产出的阶段想标「不适用」 | 拒绝,作废要走 `--revise` |
| 不给原话、不说理由、参数组合想绕 | 拒绝。只认用户明确说的,agent 不能自己填 |
给用户的话术样例见 `references/example-output.md` 的「S1 贴给用户的话术」。
### 6.7 用户提了意见,就重做一轮
用户说「这里改一下」时,一轮 = 收意见 → 改方案 → 再确认,**不是改完就往下走**:
```bash
gate --stage S1 --revise --note "用户原话" # 退回待确认,记下意见
# ...按意见改报告...
gate --stage S1 --files ... --doc .devloop/S1-影响面与方案.md # 登记新版,自动出 diff
# 贴新版,再等一次明确同意
```
- **每条意见都要落到报告里**,只在对话里答应「好的我改」不算;报告一字未改就重登 → 拒绝。
- 版本 v1 → v2 → v3 一路往上,意见原话和「本版改了什么」diff 都在 `S1-确认单.md` 里,
贴给用户时一并给他看。
- 确认后又改报告 → `state` 拒绝进入下一阶段。来回几轮都正常,不许催「差不多就行」。
**S1 与 S3 的区别**:S1 从需求词出发给出「准备怎么改」;S3 从 diff 出发核对「实际改成什么样」。
## 七、S2 实现(TDD)
**目标**:把 S1 的清单变成代码,且每一行行为都有测试先失败过。
```bash
python $DL stage --root <root> --stage S2 --base HEAD # 把 S0 的验收标准抄进映射表
python $DL check --root <root> --stage S2 # 红绿证据齐了没有
```
### 7.1 一条验收标准走一遍红-绿-重构
| 步 | 动作 | 留什么证据 |
|---|---|---|
| 1 映射 | 把 S0 每条验收标准写进映射表,指定测试文件与用例名 | 映射表一行 |
| 2 先红 | 只写测试不写实现,跑一次,确认它**因为功能没做**而失败 | 「先红」列贴失败输出摘要 |
| 3 再绿 | 写最小实现让它通过,不顺手加需求外的逻辑 | 「后绿」列贴通过输出 |
| 4 重构 | 改名、抽方法、去重;**测试全绿之后**再动结构 | 全量测试仍绿 |
| 5 全量 | 跑全量测试与 `verify`,不是只跑新加的几个 | 「测试结果」一节给了命令和结果 |
顺序不能倒。先写实现再补测试,测试只会证明「代码是这么写的」,不会证明「需求是对的」。
### 7.2 什么情况可以豁免
只有三类:**纯文档**(`.md`)、**纯配置**(yml/properties/环境变量)、**纯样式**。豁免必须显式:
```bash
python $DL gate --root <root> --stage S2 --skip --note "只改文档与配置,无行为变更"
```
改了代码却想跳过 S2,等于跳过测试;S3 审计会把这条豁免翻出来复核,
S7 提交清单里也会标出来。
### 7.3 判据(脚本会核)
- 映射表里每条验收标准都要有测试名;
- 「先红」列不许空、不许写「一次过」「直接通过」——那是没走红阶段;
- 「后绿」列不许空;
- 「回访确认」必须有内容(用户对「满足了吗」的答复),只留一句「去问用户」不算;
- 并行时另核每条车道的回执(命令 + 红 + 绿),缺一份不登记;
- 前端改动另核「界面自查」(`ui` 结论或截图),只写「已实现」不算;
- 「测试结果」要给命令与结果。
### 7.4 能拆就并行(S2 的默认动作)
≥2 个**互不引用**的文件就要并行,先拆车道:
```bash
python $DL split --root <root> --max 3 --check
```
`--check` 不过(有交集或符号引用)就串行。≥2 条车道时 json 的 `dispatch[]` 给出
`name` / `files` / `prompt`——**同一条消息里并列发起 N 个子代理**;回来后先
`split --verify` 对账(越界 / 漏改),再跑全量测试、填红绿、回访。
脚本只管判冲突、出 prompt、对账;**起子代理是主代理的动作**。
判据见 `references/parallel-playbook.md`。
### 7.5 实现时的硬约束
命名分层照 S1 的「实现约束」;不新建平行实现;错误处理、日志、兼容性按 S1 的约定来。
`quality` 会在 S3 逐条核,P0 必须改完才能提交。
## 八、S3 变更审计(改全了,也写对了?)
**一条命令做完机械部分**(对账 + 实现质量 + 盲区 + 拼报告 + 登记):
```bash
python $DL stage --root <root> --stage S3 --base <HEAD|HEAD~1|main>
```
1. **对账**(`audit`):拿清单和实际 diff 比,给出**漏改 / 越界 / 动作不符 / 一致**四张单子。
未跟踪的新建文件也算变更。文档项留给 S4。
2. **实现质量**(`quality`):只看本次**新增行**,按 P0/P1/P2 分级:
- P0:硬编码密钥/口令、SQL 拼接、`eval`、吞异常、关掉校验 → **必须改完才能继续**
- P1:调试残留、新增 TODO、硬编码地址、阻塞等待、改了代码没补测试
- P2:超长行、注释掉的代码、单文件改动过大、函数过长
规则见 `references/quality-rules.md`。豁免 P1/P2 要在报告里逐条写理由,不许默默放过。
3. **盲区复核**(`blind`):S1 列过的盲区,这次有没有落进改动里;新出现的也要记。
4. **三方对齐**:在脚本结果上逐条判定——漏改补不补、越界改为什么、调用方需不需要跟改、
测试够不够。
5. **产出 `.devloop/S3-变更审计.md`**:漏改 / 越界 / 动作不符 / 一致 / 实现质量 / 静态盲区。
`stage` 会自动拼好前四块;判定理由要你补。
6. **门禁**:存在 P0 漏改或 P0 质量问题,不得进入 S4/S5。
7. **收尾停下等确认**:`gate --stage S3 ...` → `report` → present_files → 等同意。
`stage` 已经替你登记了,你只需把报告页面给用户看。
## 九、S4 文档同步
### 9.1 三分类,不是两分类
对每份相关文档,必须落到三类之一:
| 分类 | 判定 | 动作 |
|---|---|---|
| **新建** | 代码新增了对外能力/配置项/接口,但仓库里没有对应文档 | 产出新建方案,见 7.2 |
| **更新** | 文档存在,但内容与代码矛盾,或没跟上新能力 | 给段落级补丁 |
| **不改** | 只是提到文件名,语义未变 | 写明不用改的原因 |
### 9.2 没有现成文档时的输出(强制)
不许只说「建议补充文档」。必须给出可直接落地的五件事:
1. **路径**:按仓库现有约定推断(`docs/`、`docs/api/`、模块同级 `README.md`);没有约定时放 `docs/<模块名>.md`
2. **标题与定位**:一句话说明这份文档给谁看
3. **骨架**:章节结构(概述 / 接口 / 参数 / 示例 / 错误码 / 变更记录,按需裁剪)
4. **内容要点**:每节要写什么,带具体符号、字段、示例代码
5. **与代码的锚点**:文档里引用哪些文件名/符号,未来 `drift` 才能检测失效
然后**问用户是否创建**,同意后写入,并列入 S4 产物。
### 9.3 每次变动都要更新文档(强制)
文档与代码**同批次提交**,不留到「下次一起补」。S4 收尾记录文档基线(见 7.4),
下一轮 S3 结束时先 `drift` 复核基线是否仍成立,过期就回 S4。
### 9.4 文档项对账与基线
一条命令出初稿(漂移检测 + 文档项对账 + 页面):
```bash
python $DL stage --root <root> --stage S4 --base HEAD
```
它写出 `.devloop/S4-文档同步.md` 初稿,你只需填「逐文档判定」表。收尾再记基线:
```bash
python $DL baseline --root <root> --files <本次更新的文档>
```
基线记录每个文档的内容指纹和**锚点**(文档里引用的路径/符号/接口)。
下一轮 S3 之后跑 `baseline --check`:
```bash
python $DL baseline --root <root> --check
```
- 锚点丢失 → 文档已经不再描述当前代码,回 S4 重写
- 文档消失 → 回 S4 补
- 只是内容变了 → 正常更新,确认与本次代码改动有关即可
### 9.5 别漏这几类文档
README 的命令与参数、API 定义(openapi/swagger/proto/graphql)、数据库字段说明、CHANGELOG、配置项注释、架构说明。
**产出 `.devloop/S4-文档同步.md`**:三分类清单 + 补丁 + 新建方案 + 文档基线。
**收尾停下等确认**:
```bash
python $DL gate --root <root> --stage S4 --files <涉及的文档> --doc .devloop/S4-文档同步.md
```
登记会自动出报告页面,用 present_files 打开给用户看三分类清单和代表性补丁;同意后才进 S5。
本次确实没有文档受影响时,显式跳过:`gate --stage S4 --skip --note "<用户原话>"`。
## 十、S5 健康检查
**一条命令出初稿**(指标 + 本次改动质量 + 盲区 + 页面):
```bash
python $DL stage --root <root> --stage S5 --base HEAD # 增量(默认)
python $DL stage --root <root> --stage S5 --files <目录或文件> # 限定范围
```
它写出 `.devloop/S5-健康检查.md`,指标已填好,你负责填「问题」表。
**全量模式**只有用户说「整体健康度 / 技术债」时才用,按目录分批,先出热点排名。
**五个维度**(细则见 `references/diagnosis-playbook.md`):
| 维度 | 必查项 |
|---|---|
| 正确性 | 边界值、空值/默认值、异常路径、事务边界、并发与幂等、返回值一致性 |
| 安全 | 参数注入、越权校验位置、敏感信息落盘/入日志、密钥硬编码、反序列化 |
| 性能 | 循环内 IO、N+1、无界集合、缺索引、重复计算、未释放资源 |
| 可维护性 | 函数长度与圈复杂度、重复代码、魔法值、命名误导、死代码 |
| 架构 | 分层越界、循环依赖、模块强耦合、公共层被业务污染 |
**输出格式**:`等级(P0/P1/P2) | 文件:行 | 问题 | 影响 | 修复建议`。P0 只给会导致故障或数据错误的。
**收尾停下等确认**:
```bash
python $DL gate --root <root> --stage S5 --files <问题所在文件> --doc .devloop/S5-健康检查.md
```
登记会自动出页面,present_files 打开给用户看 P0/P1 清单(P2 可折叠),同意后再进 S6。
用户可能要求「先修 P0 再继续」,那就把选中的条目转成 S6 的输入。
## 十一、S6 缺陷定位与修复
固定七步,不许跳步猜根因:
1. **现象结构化**:报错原文、完整堆栈、发生时间、环境、触发操作、复现频率。
2. **栈帧映射**:
```bash
python $DL stage --root <root> --stage S6 --log err.log
```
它跑 `stackmap` 把堆栈映射成 `文件:行`,写出 `.devloop/S6-缺陷定位.md` 初稿,你补现象与根因。
3. **无堆栈时**:加日志/断点、对可疑区间二分、`git log -S` 找引入点、`git bisect`。
4. **根因分类**:数据 / 逻辑 / 并发 / 环境 / 依赖。分类决定修复方式。
5. **证据链**:一个能证明因果的最小实验。没有证据链只能标「疑似」。
6. **最小修复**:改一处、改最小面;给影响半径与回归项;**改动前先过 §12 敏感文件检查**。
7. **验证**:`verify` 跑测试 → 重跑复现步骤 → **回到 S3 重新审计** → 修完仍需按 §14 出具自测清单。
**产出 `.devloop/S6-缺陷定位.md`**:`现象 | 栈帧 | 根因 | 证据 | 修改点 | 回归项 | 遗留风险 | 是否涉及敏感文件`。
**收尾停下等确认**:
```bash
python $DL gate --root <root> --stage S6 --files <修改文件> --doc .devloop/S6-缺陷定位.md
```
登记会自动出页面,present_files 打开给用户看「根因 + 证据链 + 最小修复 + 回归项」;同意后才进 S7。
修复本身是一次变更,**改完必须回 S3 重新审计**,审计结果同样要过 S3 的确认门。
## 十二、敏感文件确认协议
命中 `references/sensitive-files.md` 清单里任一条,**先停下确认,不许直接改**。
> 判定规则只有一份:`references/sensitive-files.md` 末尾的机器可读块,脚本直接读它。
> 加规则只改那里,别去改脚本——两份规则必然漂移。
### 12.1 分级
| 级别 | 范围 | 确认方式 |
|---|---|---|
| **高危** | 数据库迁移、密钥与证书、CI/CD 流水线、权限/鉴权配置、生产环境配置、发布与回滚脚本、依赖锁文件 | 逐文件单独确认,一次只问一个 |
| **中危** | 公共基础库(common/utils/core)、依赖清单、Dockerfile、k8s/部署清单、构建脚本 | 可批量确认一次,但必须列全 |
| **低危** | 普通业务代码、样式、文案 | 不需要确认,直接按 S1 清单执行 |
### 12.2 询问格式(必须先给信息再问)
```
⚠️ 命中敏感文件,需要你确认
- 文件:migrations/0031_add_refund_amount.sql(高危 · 数据库迁移)
- 计划改动:新增 refund_amount 字段,默认 0,NOT NULL
- 为什么必须改:C2 改表结构后,不迁移会读取报空
- 影响:存量 12 万行;执行约 3 秒;大表需评估锁表
- 回滚:DOWN 脚本已备,删除字段即可
是否同意修改?同意后我才动手。
```
### 12.3 判定规则
- 只认**明确同意**(同意 / 可以 / 改吧 / 执行)。「先看看」「应该行吧」不算同意。
- 用户拒绝 → 不改,把该项写进 `state --add` 并给替代方案(只出报告 / 只改非敏感部分)。
- 同意后 → 在 `S6-缺陷定位.md` 或 `S3-变更审计.md` 标注「已获授权修改」,附上用户原话要点。
- 一次授权只管一次改动;下一轮再动同一文件需重新确认。
- 拿不准是否敏感 → 按敏感处理。
## 十三、偏离清单时的即时告知
改动过程中,只要出现下面任一情况,**立刻停下**,不许"先改完再说":
| 情况 | 例子 |
|---|---|
| 实际要改的文件不在清单里 | 改 C1 时发现还要动 `common/date_utils.py` |
| 清单里的文件决定不改 | C4 状态机改动做不了,需要等产品确认 |
| 改动范围超出清单描述 | 清单写"改校验逻辑",实际要动表结构 |
| 发现清单的理由是错的 | 打开代码发现不是校验问题,是并发问题 |
### 13.1 告知格式
```
⚠️ 偏离 S1 清单(C3)
- 清单原计划:迁移脚本新增 refund_amount,默认 0
- 实际发现:线上已有脏数据 refund_amount 为 NULL,默认值补不上
- 需要额外做:加一步数据回填 UPDATE
- 影响:多一次全表更新,执行时间从 3 秒到 40 秒,需在低峰执行
- 建议:补一条 C3.1 进清单,按新方案继续
是否继续?确认后我往下做。
```
### 13.2 规则
- 每停一次,`state --note` 记一条,保证下一轮能接上。
- 用户选择「继续」→ 把新认识补进 `S1-影响面与方案.md` 的清单(新增编号 C3.1),保持清单与事实一致。
- 用户选择「先不动」→ 记录到 open_items,跳过该项继续其他项,并在最终报告里标明「已跳过 + 原因」。
- **禁止静默跳过**:任何未做的清单项,必须在 S3 审计里出现,标 `SKIPPED + 原因`。
## 十四、验证门禁(改完必测)
**触发时机**:任何代码改动之后——S6 修复完、用户要求改代码后、S3 审计通过准备进 S4 前、提交前。**没有例外**。
### 14.1 跑什么
```bash
python $DL verify --root <root> # 用 profile 里检测到的测试命令
python $DL verify --root <root> --cmd "pytest -q" # 指定命令
python $DL verify --root <root> --files a.py,b.py # 只针对这些文件出自测清单
```
- 检测不到测试命令 → `验证报告.md` 标 **NOT RUN**,把「需要你提供测试命令」告诉用户。**不许用「应该没问题」代替**。
- 产物也要验证:改了文档要回读确认段落正确;生成了报告要检查不是空模板。
- **只改文档时**:不必跑代码测试,但要 `drift` 复核 + `audit --scope docs` 对账,自测清单里出「文档」项。
- **环境跑不起来别硬报失败**:先解决依赖再重跑,不许把「没装 pytest」写成「测试未通过」。
### 14.2 判定与返工
| 情况 | 处理 |
|---|---|
| 退出码 0 | 通过,进入 12.3 |
| 失败 | 修 → 重跑,最多 2 轮 |
| 第 3 轮仍失败 | 停下,汇报「改了什么 / 还失败什么 / 怀疑原因」,不要继续硬改 |
| 命令跑不起来(环境问题) | 标 **NOT RUN(环境问题)**,不算通过,也不算代码失败——`verify` 会自动识别 `No module named`、`command not found` 这类特征并单独归类 |
**未通过不得提交,也不得说"完成了"。**
### 14.3 必须把自测清单交给用户
自动化通过只证明覆盖到的部分。**必须**把 `验证报告.md` 的自测清单原样给用户,明确请他再手工验一遍,
并说明「你验完告诉我,我出提交清单」。
清单由两层叠加:**按文件类型**(接口/迁移/数据/定时任务/消息/配置/页面/权限/文档)
+ **按改动内容**(从 diff 识别签名变化、表结构改动、新增分支、异常处理、权限判断、配置读取)。
同一场景只留一条,最多 10 条;没覆盖的按 `references/diagnosis-playbook.md` 补。
### 14.4 产出
`.devloop/验证报告.md`:命令、退出码、耗时、用例统计、失败详情、**自测清单**、输出尾部 40 行。
## 十五、提交确认与推送
**规矩**:清单和提交信息先给用户过目,用户明确说可以,才提交并推送。
**不许自己在同一条回复里"生成完顺便提交"**——脚本也会拦你。
### 15.1 第一步:生成清单(绝不提交)
```bash
python $DL commit --root <root> --message "<建议的提交信息>" --bump patch|minor|major
```
产出 `.devloop/S7-提交清单.md` 和 `S7-提交清单.json`(含清单指纹)。这一步不碰 git。
### 15.2 第二步:把清单贴给用户,然后停下
必须原样贴出:文件分组与增删行数、敏感文件、**提交信息全文**、是否重大改动、建议标签。
````text
准备提交 4 个文件(+282 / -13):
- src/api/(2 个):refund.py、order.py
- migrations/(1 个):0001_refund_amount.sql(新)
- docs/(1 个):refund.md
建议提交信息:
feat(refund): 支持部分退款
- 入参增加 amount 并校验累计金额
- 订单状态新增 PARTIALLY_REFUNDED
重大改动:是(+282 行)
建议标签:v1.6.0
确认这份清单和提交信息吗?确认后我提交并推送。
````
**贴完就等。** 不许把"没反对"当同意,不许自行判断"差不多就行"。
### 15.3 第三步:用户确认后才提交推送
```bash
python $DL commit --root <root> --message "<用户确认过的那份>" --apply --push --tag vX.Y.Z
python $DL state --root <root> --set S7 --note "已提交 <sha>,标签 vX.Y.Z"
```
- 提交信息必须是清单里那份,**一个字都不改**。用户改了措辞 → 用他的原话重新出清单,再让他看一眼。
- 用户说"先不推" → 去掉 `--push`。
- 一次授权只管一次提交;用户说"以后都直接提交"也不算授权。
### 15.4 清单指纹:看过之后代码不能再动
清单里带一个指纹,覆盖三样:文件集合、提交信息、**工作区内容**。
用户看过之后任何一样变了,`--apply` 都会被拒绝,并告诉你具体是哪一样:
| 变化 | 提示 |
|---|---|
| 提交信息不一致 | 清单里是 X,你给的是 Y |
| 文件集合变了 | 新增 / 消失了哪些 |
| HEAD 变了 | 清单生成后有人提交过 |
| 文件内容变了 | 名字没变,但你看到的那版已经不是现在这版 |
被拒就重新出清单、再给用户看一次。**不许绕过**。
### 15.5 推送
- `--push` 执行 `git push`;没有 upstream 会自动 `git push -u origin HEAD`。
- 打了标签会一并推送标签。
- **没有配置远程地址时直接拒绝,既不提交也不推送**——避免"本地提交了却推不上去"的悬空状态。
- 推送失败时提交已在本地,如实告知并给出 `git push` 命令,不许说"已经发布"。
### 15.6 重大改动与标签
命中任一条即算重大:文件 ≥10 个 / 增减 ≥300 行 / 有删除 / 命中高危敏感文件。
标签用语义化版本 `v<major>.<minor>.<patch>`,仓库有自己的规范就跟随:破坏性变更 → major,
新增对外能力 → minor,修复与内部重构 → patch,没有 tag 历史从 `v0.1.0` 起。
必须带注释(`git tag -a`),写清这次发布的内容。
### 15.7 防绕过:让 git 本身也守规矩
`commit --apply` 只管得住走工具的路。agent 完全可以绕开它直接 `git commit`。装一次 hook 补上:
```bash
python $DL install-hook --root .
```
之后任何 `git commit` 都校验三件事:有没有清单、清单是否匹配当前改动、提交信息是否一致,
任一不对就拒。同时把 `.devloop/` 写进 `.git/info/exclude`,免得 `git add -A` 带产物入库。
- `git commit --no-verify` 能跳过 hook——唯一的口子,**明令禁止**,除非用户自己要求。
- 换机器或移动技能目录后 hook 路径失效,重装一次即可。
### 15.8 禁止
- 在一条回复里"生成清单 + 提交",不给用户过目的机会
- 用户没明确同意就 `--apply`
- 提交信息与清单不一致(脚本会拒,别试)
- 未跑 §14 验证就提交
- 提交信息写 "update"、"fix bug"、"提交" 这类无信息量的词
- 一个提交混多个不相关主题(要求拆分成多个提交)
- 重大改动(迁移 / 依赖 / CI / 300 行以上)不打标签
- 把"推送成功"说成"已经上线"
- 用 `git commit --no-verify` 跳过 hook(除非用户明确要求)
## 十六、闭环回退规则
| 触发情况 | 回到 |
|---|---|
| S3 发现漏改,且清单里本就没有该文件 | S1 补清单,再回 S3 |
| S4 发现文档描述的接口与代码不一致 | S3 确认代码是否改错,再回 S4 |
| S5 出现 P0 | S6 定位修复,修完回 S3 |
| S6 修复完成 | 必须重跑 S3,再按需 S4/S5 |
| 用户中途换需求 | `state --round` 归档并清空确认记录,新需求从 S1 起 |
| 用户不同意某阶段产出 | 改方案/清单 → 重新 `gate` 登记 → 再看一次,不许绕过 |
每次回退都要在 `state` 里记一条 `--note`。
## 十七、产物目录
```
.devloop/
├── 项目画像.json scan 生成,其余阶段复用
├── 状态.json 阶段、历史、未闭环项、轮次归档
├── 确认记录.json 各阶段确认记录:状态 + 指纹 + 用户原话
├── 确认状态.md 确认状态总览
├── 看板.html / 看板-<阶段>.html 全局看板 / 单阶段视图(打开即定位)
├── 影响面.md / .json 影响面 + 静态盲区段
├── 依赖图.md / .mmd / .json 依赖图(待新建为虚线)
├── 静态盲区.md / .json 反射 / DI / 动态导入 / 拼装路由
├── 实现质量.md / .json 新增行的 P0 / P1 / P2 硬伤
├── 敏感文件预检.md 敏感文件预检
├── 代码对账.md 代码项对账(S3)
├── 文档对账.md 文档项对账(S4)
├── 文档基线.json 文档内容指纹 + 锚点
├── 基线复核.md 基线复核结果
├── 文档漂移.md / .json 文档里写的路径、符号是否还在
├── S0-需求澄清.md 需求原话 + 四类问答表 + 验收标准 + 待定与假设
├── S1-素材.md stage 生成的素材(不是方案,不能直接登记)
├── S1-影响面与方案.md 技术路线 + 实现流程 + 架构图 + 盲区 + 实现约束 + 改造清单
├── S1-架构图.svg 登记时渲染出的矢量图
├── S2-实现.md 验收标准→测试映射 + 红绿证据 + 回访确认 + 豁免
├── S2-并行方案.md 车道划分 + 耦合证据
├── S3-变更审计.md 漏改 / 越界 / 动作不符 / 一致 / 实现质量 / 静态盲区
├── S4-文档同步.md 新建 / 更新 / 不改 三分类 + 补丁 + 文档基线
├── S5-健康检查.md 分级问题清单
├── S6-缺陷定位.md 现象→根因→证据→修复→回归
├── 调用链映射.md S6 栈帧映射
├── 验证报告.md 验证结果 + 失败详情 + 用户自测清单
├── S7-提交清单.md 文件分组 / 敏感提醒 / 建议信息 / 是否重大 / 建议标签
├── 历史版本/ 每次登记的报告快照(S1-v1.md、S1-v2.md …)
├── 归档/第NN轮/ 上一轮产物归档(state --round 时移入)
└── 看板历史/ 历史看板(看板-<时间戳>-<序号>.html,留最近 10 份)
```
`.devloop/` 建议加入 `.gitignore`。产物格式样例见 `references/example-output.md`。
## 十八、脚本参考
**日常用这 8 条**,其余都由 `stage` / `gate` 内部调用:
| 命令 | 用途 | 何时跑 |
|---|---|---|
| `next --root .` | 读状态直接说下一步做什么 | 接手、断点续做 |
| `stage --root . --stage S2 --base HEAD` | 一条命令做完某阶段的机械部分:S0 出四类问题骨架,S2 抄验收标准进映射表,S1/S4/S5 出初稿,S3 出完整报告,S6 加 `--log` 映射栈帧 | 每个阶段起步 |
| `check --stage S0/S2` | 只体检报告不登记:问答收敛、红绿证据齐不齐 | 改稿时反复用 |
| `resume [--root .]` | 跨会话续跑:列项目 / 看停在哪 | 换会话接手 |
| `split --max 3 --check` | 把 S2 的活拆成互不冲突的车道 | S2 开工前 |
| `split --verify` | 并行改完对账:越界 / 漏改 / 整条车道没动 | 子代理返回后 |
| `ui [--files a.vue]` | 业务前端 UI 检查,P0 不通过 | S2 自查、S3 审计 |
| `gate --stage S0/S1/S2 --files a,b --doc <报告>` | 登记待确认;校验报告内容(S0 核问答收敛、S2 核红绿证据),自动生成页面 | 每阶段收尾 |
| `gate --stage S3 --approve/--skip/--revise --note "..."` | 确认 / 不适用 / 退回修改,三者互斥 | 用户表态后 |
| `report --root .` / `--history` | 重渲染页面 / 列历史版本(默认留最近 10 份) | 报告被改过、要对比 |
| `verify --root . [--cmd "pytest -q"]` | 跑测试 + 生成自测清单 | 每次代码改动后 |
| `commit --root . --message "..." [--bump minor]` | 出提交清单(默认不提交);确认后加 `--apply --push --tag` | 提交前 |
| `install-hook --root .` | 装 commit-msg hook,直接 `git commit` 也要过清单 | 首次进项目 |
**底层命令**(`stage` 已经在调,排错或单点分析时才手跑):
| 命令 | 用途 |
|---|---|
| `scan --root .` | 项目画像:语言、构建/测试命令、文档清单、入口点 |
| `impact --root . --files a,b` | 影响面 + 风险分,末尾附静态盲区段 |
| `blind --root . --files a,b` | 反射 / DI / 动态导入 / 拼装路由逐条列出 |
| `quality --root . --base HEAD` | 只看新增行的 P0/P1/P2 硬伤(有 P0 返回 2) |
| `graph --root . --files a,b --depth 2` | 依赖图,`--format ascii/mermaid/both` |
| `audit --root . --base HEAD [--scope docs]` | 清单 vs diff:漏改 / 越界 / 动作不符 / 一致 |
| `drift --root . --changed a.py` | 文档漂移:文档里写的路径、符号是否还在 |
| `sensitive --root . --files a,b` | 敏感预检(返回 3 高危 / 4 中危) |
| `baseline --root . --files a.md` / `--check` | 记录 / 复核文档基线 |
| `state --root . --show/--add/--close/--round` | 阶段状态与轮次 |
| `plan ...` | 兼容别名,等同 `gate --stage S1` |
| `check-commit --root . --message-file <f>` | 供 hook 调用,校验提交清单 |
输出均为 UTF-8,Windows 下用正斜杠路径。
## 十九、反模式
- 用户说了需求就直接出方案,一个问题都不问——S0 没走,后面全是猜。
- 一次抛出七八个问题、或者只在最后问一句「还有别的吗」——四类要分轮问,答案要落表。
- 先写实现再补测试,回头把「后绿」贴成「先红」——顺序反了,测试就只是代码的复读机。
- 改了一行配置/文档也想跳过 S2 又不写理由——豁免要显式 `--skip --note`,S3 会复核。
- 凭经验列「可能受影响」——影响面必须带文件行号。
- S1 只给清单不给方案、技术路线只摆一条、架构图画成整个系统——三样都是「没做设计」。
- 把脚本的调用方清单当完整影响面——反射、DI、动态路由、跨服务调用它都看不见。
- 方案只谈「改哪几个文件」,没定命名/错误处理/日志/测试约束——代码质量就没人管了。
- S3 只靠肉眼对清单——先跑 `audit`,再判断,别用眼睛当 diff。
- 文档只说「建议补充文档」,或说「下次补」——必须给新建方案或补丁,且与代码同批次。
- 改了迁移脚本/CI/密钥却不吭声——先问,再改。
- 改到一半发现清单不对,闷头改完——先停,说清原因,等确认。
- 静默跳过清单项——未做的项都要在 S3 里以 SKIPPED 出现。
- 健康检查输出泛泛建议(「建议增加注释」)——必须带定位与可执行动作。
- 报错阶段跳过证据链直接给修复方案——根因没证实,修复就是碰运气。
- 改完不跑验证就说「完成了」;验证通过只回一句「测试已通过」,不交自测清单。
- 没给用户看提交清单就 commit;提交信息写「update」「fix bug」;重大改动不打标签。
Pliki w paczce (7)
- .gitattributes 1 KB
- .gitignore 1 KB
- CHANGELOG.md 46 KB
- LICENSE 1 KB
- README.en.md 7 KB
- README.md 9 KB
- SKILL.md 51 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · BHLO/dev_loop | 90 | MIT |
| synapt-dev/recall | 90 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 1e4860fa8d7c (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100workflow-dev
Prowadzi automatyczną pętlę deweloperską: uruchamia testy, zgłasza issue dla niepowodzeń, naprawia metodą TDD na gałęzi, otwiera pull request i obserwuje CI. - 95tl-dev-be
Prowadzi backendowy cykl TDD według specyfikacji zadania UC, od testów po kod serwera. - 96tdd-workflows-tdd-cycle
Prawdopodobnie pomaga przy cyklu TDD w przepływach pracy z testami, w tym przy pisaniu testów przed kodem. - 96tdd-workflows-tdd-cycle
Prawdopodobnie prowadzi przez cykl programowania sterowanego testami: red, green, refactor. - 96tdd-workflows-tdd-cycle
Prawdopodobnie prowadzi przez cykl programowania sterowanego testami: red, green, refactor. - 96tdd-workflows-tdd-cycle
Prawdopodobnie prowadzi przez cykl programowania sterowanego testami: red, green, refactor.