🛡️ 渔芯 · 代码开发铁律 v1
华哥 2026-08-03 明确:"代码开发必须调用 claude code 或 codex,不成功才能自己直接开始" 华哥 2026-08-14 修正:"有代码要写时优先使用 Claude Code 或 Codex。同事不会调用 Claude Code 不应导致不写代码——不会用或失败时直接自写,不要卡住。" 范围:9 个 profile 全部遵守(玉芬 default + 8 同事 + community) 优先级:最高 — 高于任何其他 SOP
⚠️ 核心精神(2026-08-14 起):Claude Code / Codex 是优先选项,不是硬性门槛。"不会调用 Claude Code"绝不是不写代码的理由。会调就用,不会调或调失败就直接自写(加 TODO 标注),把活干完优先于工具洁癖。---
🚦 执行前 30 秒决策清单(每次写代码前必走)
按顺序回答,任一为"否"才可自写:
□ 1. 这件事是"代码/脚本/可执行文件"吗?(查下方"触发条件"表)
□ 2. 优先试 `claude -p "..."` — 会调就用;不会调 / 失败(工具异常/超时/无权限)→ 跳到下一步
□ 3. 优先试 `codex exec "..." --sandbox danger-full-access` — 会调就用;不会调 / 失败 → 跳到下一步
□ 4. 都不会调或都失败 → **直接自写,不要卡住**(文件首行加 `# TODO(tech-debt): 改由 Claude Code/Codex 重写`)
□ 5. 飞书通知华哥登记技术债(自写时建议,不强制)
自动豁免场景(无需走铁律,可自写):Markdown · AGENTS.md · 纯 JSON/YAML/TOML 配置 · 元数据 JSON(Dashboard 数据源)· 单行 shell · 调试 print · 数据迁移/批处理。
🏆 实操首选:claude -p --allowedTools 模式(2026-08-03 实测验证,5/5 任务成功)
结论:之前 v1.1 推荐"delegate_task 是 Hermes 场景下唯一稳妥路径" — 这个判断错了。实测 5 个任务全部成功用以下模式:
claude -p --allowedTools "Read,Edit,Write,Glob,Grep" -- "<精确聚焦的 prompt>"
为什么 --allowedTools 能绕过权限拦截:
claude -p默认对所有写操作要求人工 y 批准(进交互)--allowedTools白名单内的工具(Read/Edit/Write/Glob/Grep)自动执行,不需批准- 仅 Bash 命令(如
python3 ...语法验证)仍需批准 — 解决:让 Claude Code 用 Read 工具自己验证,或任务结束后玉芬手动python3 -c "import ast; ..."验证
实际 5 个任务(2026-08-03,华哥已拍板"a",10 分钟全跑完):
| 任务 | 产物 | 耗时 | 验证方式 |
|---|---|---|---|
| 1 修 deprecation | app.py 4 处 use_container_width → width='stretch' |
52s | python3 -c "import ast; ..." + grep -c |
| 2 重写铁律页 | pages/1_铁律.py 228 行 |
44s | wc -l + head -10 |
| 3 重写 tool 脚本 | tool_repo_manager.py v2 533 行 |
3m20s | python3 ... --help + head |
| 4 重写 Dashboard | app.py v2.0 499 行 + assets/styles.css 61 行 |
4m35s | wc -l + 3 端点 HTTP 200 |
| 5 评估 4 JSON | api_keys/products/community/tool_logs 全部"纯数据保留" | 44s | 4 文件 _meta 加 verified_by |
关键经验:
- 拆分任务 > 一次大任务 — 5 个独立 prompt 比 1 个大 prompt 强 N 倍(独立验证、错误隔离、出错易定位)
- 每个 prompt 必须明确:
- 用 Read 读哪个文件(避免误改)
- 用 Edit/Write 写到哪里(绝对路径)
- 严格限制:只改这 X 个文件,不要写其他文件
- 不要启动 streamlit / 不要做 syntax check(由玉芬事后验证)
- 输出 "✅ 任务 N 完成"
- 必须验证文件真的改了 —
md5sum/wc -l/python3 -c "import ast; ast.parse(...)",不要相信 "✅ 任务 N 完成" — Claude Code 退化行为会回声DONE但文件未变(只发生在无 --allowedTools 时) - Bash 命令触发"语法检查"会被卡 — 解决:让 Claude Code 用 Read 工具读文件验证,或任务完成后玉芬独立验证
完整工作模板见:references/***SECRET***.md
触发条件(什么算"代码开发")
| 类型 | 是否触发铁律 | 例子 |
|---|---|---|
| Python 脚本/服务(>5 行有业务逻辑) | ✅ 触发 | xxx.py 业务模块 |
| JS/TS/React/Vue 组件 | ✅ 触发 | 前端组件 |
| Shell 脚本(>5 行) | ✅ 触发 | xxx.sh 自动化 |
| Streamlit/Dash 业务代码 | ✅ 触发 | app.py 业务模块 |
| CAD macro/插件代码 | ✅ 触发 | 任何可执行 |
| 单行命令/print 调试 | ❌ 不触发 | 临时排查 |
| 纯 shell 批处理(<5 行) | ❌ 不触发 | mv / cp / ls |
| Markdown/AGENTS.md/SKILL.md | ❌ 不触发 | 文档类 |
| JSON/YAML/TOML 纯配置文件 | ❌ 不触发 | 配置类 |
| 元数据 JSON(只写不调逻辑) | ❌ 不触发 | Dashboard 数据源 |
| Streamlit 纯布局/渲染代码 | ❌ 不触发 | UI 布局 |
默认调用链(强制)
1️⃣ 第一选择: Claude Code
claude -p "需求描述: .... 写到 <路径>"
或交互模式
(不会调用 Claude Code → 直接跳 2️⃣,不要卡住)
2️⃣ 第二选择: Codex CLI
codex exec "需求描述: ...." --sandbox danger-full-access
或交互模式
(不会调用 Codex → 直接跳 3️⃣,不要卡住)
3️⃣ 兜底(不会调 / 调失败即可,不再要求"明确失败 3 次"):
✅ 文件首行加 # TODO(tech-debt): 改由 Claude Code/Codex 重写
✅ 飞书通知华哥登记技术债(建议,不强制)
⚠️ 核心:把活干完优先于工具洁癖。不会用工具不是停摆的理由。
违规案例(2026-08-03 已发生 → 已闭环)
| 越权产物 | 路径 | 8/3 状态 | 闭环方式 |
|---|---|---|---|
| Dashboard app.py | /Users/hua/hermes/dashboard/app.py |
✅ Claude Code 重写为 v2.0 (499 行) | --allowedTools 任务 4 |
| tool_repo_manager.py | /Users/hua/.hermes/tool-repo/tool_repo_manager.py |
✅ Claude Code 重写为 v2 (533 行) | --allowedTools 任务 3 |
| 4 个 JSON 数据源 | /Users/hua/.hermes/state/*.json |
✅ Claude Code 评估为"纯数据保留" | --allowedTools 任务 5 |
| collect_status.py | /Users/hua/.hermes/scripts/collect_status.py |
⚠️ 8/3 玉芬自写 + 加 # TODO 注释(未由 Claude Code 重写) | 仍待补做 — 优先级最低(数据采集脚本,影响小) |
已闭环教训:玉芬自写 + 加 # TODO 标注后,立即用 claude -p --allowedTools 重写,5 个产物 10 分钟搞定。这套流程以后可作为铁律"事后整改"的标准操作。
⚠️ 实操陷阱(2026-08-03 实测发现 + 修正)
陷阱 1:无 --allowedTools 时 Claude Code 会被权限拦截
现象:claude -p "请用 Write 工具改 X" 第一次会 300s 超时(等人工 y 批准);第二次会回声输出 "DONE" 但文件未变(更阴险)。
修正:永远加 --allowedTools "Read,Edit,Write,Glob,Grep"。白名单内工具自动执行,不再卡权限。
陷阱 2:有 --allowedTools 后,只剩 Bash 命令要批准
现象:Claude Code 改完文件后,经常主动想跑 python3 -c "import ast; ast.parse(...)" 验证语法 → 触发 "语法检查命令需要审批" 卡住。
修正(2 种方案):
- A. prompt 里写明 "不要做 syntax check,由玉芬事后验证"(推荐)
- B. 让 Claude Code 用 Read 工具自己读文件验证(不触发 Bash 权限)
陷阱 3:5 个产物一次性改必死
现象:claude -p "把 A/B/C/D/E 5 个文件都按 X 模式改" → Claude Code 注意力分散,经常改错文件或遗漏。
修正:5 个独立小 prompt,每个只动 1 个文件,每个 1-5 分钟完成。玉芬独立验证每个,出错易定位。
陷阱 4:信任 "✅ 任务 N 完成" 输出
现象:即使加了 --allowedTools,Claude Code 偶尔会回声输出完成标志但 Edit/Write 没真的执行(实测 ~5% 概率)。
修正:必做以下任一验证:
md5sum /path/to/file # 改前改后对比
wc -l /path/to/file # 行数变化
python3 -c "import ast; ast.parse(open('/path/to/file').read())" # 语法
grep -c "old_string" /path/to/file # 旧字符串应减少
grep -c "new_string" /path/to/file # 新字符串应增加
变体(2026-10-14 工作台修复实测):文件确实改了、回声也逐条报「任务完成」,但改出的代码带编译错——Claude Code 不跑 tsc/cargo,它自己不知道错了。md5/grep 只能证明「改了」,证明不了「改对」。编译型项目必须加跑对应编译门:
- TS/前端:
npx tsc --noEmit(本 session 一批 4 文件编辑回声全部报成功,tsc 抓出 TS2345 类型缺口 → 追加一份增量任务书才修掉) - Rust:
cargo check(顺带暴露死代码 warning) - Python:
python3 -c "import ast; ..."或 import 冒烟
节奏:每批委派完成 → 立即跑编译门 → 有错写增量任务书交回 Claude Code 修 → 再跑门到绿,然后才 commit。
陷阱 5(已废):codex exec 报 "not trusted"
v1.2 时的误判:codex exec "..." --sandbox danger-full-access 报 "Not inside a trusted directory and --skip-git-repo-check was not specified",即使加 --skip-git-repo-check 仍会进 read-only sandbox。
v1.3 实测推翻:加齐两个 flag 就 work — --skip-git-repo-check -s danger-full-access,243 行 iron_law.json 2 分 20 秒完成整合。Codex CLI 实际可用,只是 v1.2 没找到正确参数组合。
修正后的 Codex 工作模式(完整 reproduction 见 references/codex-exec-working-pattern.md):
cat /tmp/prompt.txt | codex exec --skip-git-repo-check -s danger-full-access
关键 3 个 flag(缺一不可):
--skip-git-repo-check— 跳过 git repo 信任检查-s danger-full-access— Codex 默认进 read-only sandbox,这个 flag 让 Codex 可写- prompt 必须用
cat管道输入,不要在命令行codex exec "..."嵌(避免 bash 转义 + 长度限制)
陷阱 6(2026-08-30 实测):/Users/hua workdir 的 trust dialog 陷阱导致 claude -p 静默挂起
现象:在 /Users/hua 或其下任何子路径(/Users/hua/6-产品研发/... 等)调用 claude -p "...",进程不退出、日志 0 行、CPU 不消耗、uptime 秒数不增长。即使加 --allowedTools 也无效。
根因:~/.claude.json 里该路径 hasTrustDialogAccepted=False,Claude Code 首轮触发权限审查并等人工确认;沙盒无 stdin,挂死。
错误日志特征(只有这一行,极容易忽略):
Ignoring 265 permissions.allow entries from .claude.json: this workspace has not been trusted.
Run Claude Code interactively here once and accept the trust dialog
workdir 选择(已实测可用 vs 不可用):
- ✅
/Users/hua/Documents/(trust=True) - ✅
/Users/hua/系统文件夹/Claude/(trust=True) - ✅
/Users/hua/6-产品研发/渔芯社区/渔芯工作台/(2026-10-14 实测:claude -p --allowedTools "Read,Edit"任务书模式连续 4 次成功——8-30 的「6-产品研发 继承 trust=False」结论已过时;路径黑名单会随信任状态漂移,以 30 秒探针实测为准,勿凭旧黑名单直接跳自写) - ❌
/Users/hua(trust=False)—— 别用它当 workdir
修复模式("拷到 trusted 目录再调"):
mkdir -p /Users/hua/Documents/claude_workdir
cp /Users/hua/6-.../template.py /Users/hua/Documents/claude_workdir/
cd /Users/hua/Documents/claude_workdir
claude -p --allowedTools "Read,Edit,Write,Glob,Grep" -- "$(cat /tmp/prompt.txt)"
# 完成后产物拷回原路径
cp /Users/hua/Documents/claude_workdir/*.py /Users/hua/6-.../scripts/
诊断命令(快速判断是不是这个坑):
python3 -c "
import json
d = json.load(open('/Users/hua/.claude.json'))
for k, v in d.get('projects', {}).items():
if 'hasTrustDialogAccepted' in v:
print(f'{k}: trust={v[\"hasTrustDialogAccepted\"]}')"
# 如果 workdir 路径对应 trust=False → 立即换 workdir
兜底时机(铁律实操版):
- 第 1 次 claude 调用超时 / 0 输出 → 排查 trust dialog / 换 workdir / 简化 prompt
- 第 2 次仍失败 → 立即自写 + 文件首行
# TODO(tech-debt): 改由 Claude Code/Codex 重写 — 失败原因: <原因> - 不要无限等:写脚本 + 跑测试任务 5 分钟必 kill 走兜底(不是网络抖动,是 trust 阻塞或代理排队)
- 简单读文件任务(< 1KB 输入)30 秒无输出 = 异常
claude -p偶发整批挂死,同一会话早前明明成功(2026-10-14 实测:前 4 个任务书 5-60s 全成,第 5 个 240s 零输出无进程残留;怀疑与华哥本机开着的交互式 Claude Code 会话互抢网关队列)。处置:kill/确认无残留 → 换纯 Bash 自写(任务书内容照搬),不要重试第三次;YAML/JSON/纯配置类本就在自动豁免清单里,直接自写完全合规~/.claude.json的 projects 信任表有容量上限,老条目会被挤掉——上周探针是 True 的路径这周可能变 False 或整条消失。所以探针必须每次会话现跑,禁止引用记忆里的旧结论
优先级(2026-08-03 实测后修正)
| 方案 | 适用场景 | 推荐度 |
|---|---|---|
A. claude -p --allowedTools |
玉芬写代码首选,5/5 实测成功 | ⭐⭐⭐⭐⭐ 默认推荐 |
B. codex exec --skip-git-repo-check -s danger-full-access |
写大型 JSON/数据整理(>500 行)Claude Code 偶有遗漏,Codex 更稳 | ⭐⭐⭐⭐ |
C. delegate_task 委派 subagent |
需要"无状态"隔离,subagent 上下文独立时 | ⭐⭐⭐ |
D. pty=true 交互模式 |
华哥本人在终端,愿意手动 y 批准 | ⭐⭐ |
E. ***SECRET*** |
完全信任场景,小修改可回滚 | ⭐ (慎用) |
| F. 自写 + TODO 兜底 | 真正"明确失败" — A/B/C/D/E 都不行时 | ⭐⭐ (合规但不推荐) |
反模式(确认会失败或低效):
- ❌
claude -p "请用 Write 工具改 X"(无 --allowedTools,会卡) - ❌
codex exec "..." --sandbox danger-full-access(缺--skip-git-repo-check报 not trusted,缺-s danger-full-access进 read-only sandbox 阻写入) - ❌ 在
codex exec "..."命令行嵌 prompt(触发 bash 转义 / 长度限制;改用cat /tmp/prompt.txt | codex exec ...) - ❌ 一次 prompt 改 5+ 个文件(注意力分散)
- ❌ 不做 md5/wc/ast 验证就以为成功了
- ❌ 反复重试同一条
claude -p命令(触发[Tool loop warning])
完整工作模板 + 实测 reproduction 步骤见:references/***SECRET***.md
🎨 UI 设计铁律(2026-08-29 新增,华哥定调"UI 开发要提升到设计的层面")
全文见
~/6-产品研发/公共组件/渔芯项目开发_习惯与准则_铁律.md第十八章 +~/6-产品研发/公共组件/UI调研与设计规范.md。要点:
- 设计定位四问(写 CSS 前强制回答,落盘产品 README):①什么内容(气质关键词)②什么类型(工具/记录/社交/交易)③什么风格(意象板法:产品像什么实物)④什么配色(必须过文化语境:朱砂=喜庆、素灰=丧仪、金=尊长)。判定:陌生人看截图能猜出产品是什么。
- 主题化架构:颜色全走 CSS 语义变量,禁硬编码;每产品出厂 ≥2 套主题(含深色),生活情感类 ≥6 套(参考:文房·宣纸/清雅蓝/暖砂陶/墨绿禅/胭脂红/青瓷/暗夜);选择持久化;对比度 ≥0.35 实测。
- UI 交付六项验收:模糊测试/灰度测试/对比度/主题全切换/零 JS 错误/真机窄屏。
- 审美进化:UI 前必做竞品调研(≥3 个同类)+查 Mobbin;交付后 vision 设计审查意见沉淀进 UI调研与设计规范.md。
- 正面首例:情商助手 38「文房·宣纸」(2026-08-29,vision 审查"设计意图 100% 落地")。
违反处置(自发现或被指出)
什么算违规(2026-08-14 更新):
- ❌ 因为"不会调用 Claude Code/Codex"就完全不写代码、停摆不干活 — 最严重违规,违反"把活干完优先"原则
- ❌ 既不调工具、也不加 TODO 标注、也不通知华哥,无痕自写并冒充工具产出
自写本身不算违规(兜底合法),但建议加 # TODO(tech-debt) 标注 + 飞书登记,便于事后统一用工具重写。
处置:
- 立即纠正(要么补调工具,要么补标注)
- 飞书报告华哥
- 写复盘到 ~/hermes/reports/yuxin_self_criticism/YYYY-MM-DD_<主题>.md
累计 3 次违规:对应 profile 自动降级(暂停 self-evolution 24h),等华哥手动重启。
实操 checklist(写代码前必走)
# 1. 思考:这是代码吗?查上面"触发条件"表
# 2. 第一选择
claude -p "需求: ... 写出可运行的 Python 脚本到 <绝对路径>,要求: ..."
# 3. 失败时第二选择
codex exec "需求: ..." --sandbox danger-full-access
# 4. 不会调用、或两次都失败时 → 直接自写(不要卡住)
# 建议: a) 文件首行加 # TODO(tech-debt) b) 飞书通知华哥登记技术债
为什么有这条铁律(华哥理由)
- 训练数据隔离 — Claude Code/Codex 产出的代码自动进入训练数据集(可作为嵌入式训练原料),玉芬自写无法蒸馏
- 质量保证 — 外部 LLM 代码质量上限高于玉芬
- 可审计 — 所有代码来源可追溯(Claude Code/Codex 都有日志)
- 避免重复造轮 — Claude Code/Codex 可能已有现成实现
- 逼玉芬聚焦高价值工作 — 玉芬时间是稀缺资源,不应浪费在写业务代码
不适用场景(可自写,不算违规)
✅ 文档/Markdown/方案/报告(玉芬本职) ✅ AGENTS.md / 记忆 / skill 文本内容 ✅ 配置文件(JSON/YAML/TOML,只写不调逻辑) ✅ 一行命令 / 临时修复 / 调试 print ✅ 数据迁移 / 纯 shell 批处理 ✅ 写元数据 JSON(Dashboard 数据源) ✅ Streamlit 界面文件(若只有布局/渲染代码,无业务逻辑)
🎨 UI 设计铁律(2026-08-29 华哥批准,同日生效)
来源:华哥 2026-08-29 指示(调研先行 / 提高审美 / 多主题给用户选 / 能力进化后列入铁律)。 首例验证:情商助手 38 六主题上线实测(对比度 0.82-0.86 全过门槛 0.35,vision 审查双主题通过)。 完整规范:
~/6-产品研发/公共组件/UI调研与设计规范.md(含竞品调研结论与验收清单)
五条铁律(所有产品 UI 开发必须遵守)
- 竞品调研先行:新产品 UI 开发前,必须做竞品 UI 调研(同类 ≥3 个产品截图分析)+ 参考 Mobbin 同类 pattern。
- CSS 变量主题化:所有前端颜色必须走 CSS 变量主题架构,禁止组件内硬编码色值;每个产品出厂 ≥2 套主题(含深色),生活情感类 ≥6 套性格主题。
- 用户选择权:必须给用户配色/风格选择权,选择持久化(localStorage + theme-color 同步)。
- 六项验收:UI 交付前过验收清单(灰度测试 / 对比度 ≥0.35 / 主题切换无破色 / JS 零报错 / 移动端安全区 / 模糊测试主次层级)。
- 审美进化机制:每次 UI 交付后记录 vision 审查意见与修正,沉淀进 UI 规范文档;每季度复扫一次竞品新趋势。
适用范围
- ✅ 所有新产品 UI / 重大 UI 改版(渔芯产品 + 社区产品 + 内部工具面向用户的界面)
- ❌ 不适用:纯内部运维面板的临时调试样式(可事后补主题化,不算违规)
配套文件
- 9 份 AGENTS.md:
/Users/hua/.hermes/profiles/*/AGENTS.md顶部都有铁律章节 - 玉芬 default v5:
/Users/hua/.hermes/profiles/default/AGENTS.md - 技术债清单:见
~/hermes/reports/yuxin_self_criticism/ - 执行配套 skill:
yuxin-coding-workflow—claude -p --allowedTools委派的具体模板 + 验证命令 - 🆕 Claude Code 实操:
references/***SECRET***.md— 5/5 任务成功的完整 prompt 模板 + 验证命令 - 🆕 Codex CLI 实操:
references/codex-exec-working-pattern.md— 2026-08-03 实测 Codex 写 243 行 JSON 整合任务的完整 reproduction - 🆕 铁律固化工作流:
references/***SECRET***.md— 新增/修改铁律并同步 9 profile 的标准流程(备份约定/插入点/幂等批量补丁/grep 验证),2026-08-29 UI 铁律固化实战验证 - 🆕 主文档编辑与同步:
references/iron-law-document-editing.md— 《渔芯铁律》主文档三层定位(事实源/同步仓库/remote)、24章结构、编辑SOP(改事实源→版本号→版本历史→sync.sh→验证)、sync.sh死锁坑(--force-local修复) - ❌ 过时参考:
references/***SECRET***.md— v1.1 误判 delegate_task 唯一论,已被 v1.2 实测推翻
版本历史
| 版本 | 日期 | 改动 |
|---|---|---|
| v1.0 | 2026-08-03 | 初版 — 华哥明确,9 份 AGENTS.md 同步写入 |
| v1.1 | 2026-08-03 | 加 30 秒决策清单 + 5 方案执行表 + 误判"delegate_task 推荐默认" |
| v1.2 | 2026-08-03 | 🔴 重大修正:实测 5/5 任务证明 claude -p --allowedTools 才是默认推荐;反悔 delegate_task 唯一论;加入"5 个小 prompt > 1 个大 prompt"模式;加入 Bash 批准绕过的 2 种方案;越权产物表全部闭环 |
| v1.3 | 2026-08-03 | 🔴 重大修正:实测 Codex CLI 加齐 --skip-git-repo-check -s danger-full-access 完全可用(2 分 20 秒写 243 行 iron_law.json),反悔 v1.2 陷阱 5 "Codex 仍不可用" 误判;新增 Codex 优先级 B;新增 references/codex-exec-working-pattern.md |
| v1.4 | 2026-08-29 | 🎨 新增 UI 设计铁律(华哥批准):竞品调研先行 / CSS 变量主题化 / 用户主题选择权 / 六项验收 / 审美进化机制。首例=情商助手 38 六主题。9 份 AGENTS.md 顶部同步追加一行。完整规范见 ~/6-产品研发/公共组件/UI调研与设计规范.md。固化流程沉淀至 references/***SECRET***.md |
| v1.4.1 | 2026-08-29 | 新增 references/***SECRET***.md(铁律固化 6 步标准流程,含幂等批量补丁脚本与 grep 验证法) |
| v1.5 | 2026-10-09 | curator 合并:原独立 skill yuxin-coding-workflow 整档收纳至 references/yuxin-coding-workflow/(玉芬执行编码/实现任务的直写工作流 — Hermes 工具直接写代码、不生成远程 CC SWITCH 指令包、Hermes 编码任务触发的加载入口)。关系:铁律定义「优先级链与合规边界」(本文件),coding-workflow 定义「玉芬自己动手时的具体执行流」(子参考)。触发词扩展:华哥说"你自己写吧"/"相信你"、想生成"给 CC 跑的开工 prompt"时 → 先读本文件调用链,确认走自写兜底后按 references/yuxin-coding-workflow/ 执行 |
| v1.5.1 | 2026-10-14 | 陷阱 4 增补「编译型项目必须跑编译门验证」变体——CC 回声报成功但代码带编译错(tsc/cargo/ast),md5/grep 只证「改了」不证「改对」;节奏=批完→跑门→错则增量任务书回修→绿才 commit |