Personal Dev Workflow v3（personal-dev-workflow）
> 一个指挥 + 隔离 Worker + 文件记忆 + 验证闭环。人只做提需求与拍板，搬运与转述全部自动化。
> 依据与出处：references/framework.md（可选阅读）。
何时用
- 开始开发项目 / 说"开工" / 拆任务 / 实现功能 / 修 bug
- 大需求要分解成可执行任务并持续推进
- 长期项目要稳定节奏与可追溯进度
核心五原则（每条一句）
- 一个项目 = 一个工作区 + 一个指挥会话（主会话只留「目标 + 文件指针 + 摘要」）。
- 任务卡落盘
tasks/（一张卡一个文件；执行者只认卡，不靠聊天记录）。 - 每张卡一个隔离执行器，干完交工作证明（diff + 测试 + 截图）。
- 干活的不打分：验证/评审用全新上下文，只见 diff 与验收标准。
- 记忆全在文件里（AGENTS.md / docs/ / tasks/）；对话会忘，文件不会。
六步循环
- 拆卡：模糊需求先收敛一页纸（Problem / 关键假设 / MVP / Not Doing）；大功能写 SPEC（一句话能说清就跳过）；陌生代码库先探索（聚焦检索 3-5 次收手，查影响面：调用者/测试/接口）。
- 派活：一张卡 → 一个隔离执行器（子代理优先；想用 Codex 就 codex exec）。卡必含限制条件（不能改什么）与预期证据。派活三问：谁来协调？子任务独立吗？会改同一批文件吗？能单不多；外部副作用（发送/发布/删除）不默认授权。
- 交证：改动摘要（说不清改了什么，代码不要直接信）+ diff + 测试 + 截图，并引用依据来源。
- 验证：客观门禁（可执行标准，不是"觉得行"）；默认怀疑（假设代码是坏的，除非被证明能跑）；Review 五件事（超范围 / 改错文件 / 接口兼容 / 异常处理 / 可维护性）；大改动派评审子代理反向挑错；同一问题修复 3 次即熔断重来。
- 验收：用户拍板三选一：合入 / 打回 / 调整方向。
- 复盘：教训写进 AGENTS.md（对应真实犯过的错）；重复 3 遍的事停下来自动化；定期垃圾回收失效规则。
规则文件纪律（AGENTS.md / CLAUDE.md）
- 100 行原则，地图不是手册：只写 agent 猜不到的；每行问"删掉会导致犯错吗？不会就删"。
- 犯错驱动生长：空文件开始，每次犯错加一条规则（复利）；护栏用排除式不变量（「本项目不用 X」）。
- 建议 vs 约束：规则文件是建议；红线（删除/副作用/危险命令）用 DSH pre-execute 门禁硬拦并实测（黑/白名单各测一次）。
上下文与成本
- 仓库是唯一真相来源；对话只留指针。
- 污染三策略：compaction（连续性重要时）/ context reset（修正 2 次还错就清空重来）/ 开新会话（不相关任务）。
- 长循环设预算上限；通过率 <50% 停下复盘流程本身；>2 轮循环必须有落盘记忆。
- 每 2-3 周做一次全局对抗式审查（恶意用户视角）。
规模适配
- 小（几天）：一个会话 + 子代理按需 + 5-10 张卡；验证靠测试与自测。
- 大/长期（周-月）：tasks/ 当看板 + goal 续跑 + 并行 3-5 Worker + 每周复盘进 AGENTS.md。
- 生产级：验证进 CI；worktree 隔离；评审 agent 把关；PR 走最后一公里。
模板与参考
- 任务卡
references/task-card-template.md· SPECreferences/spec-template.md· 验证清单references/verify-checklist.md - 可选背景：
references/framework.md（五组件/出处/成本数字/规模细节）
自查清单（每张卡收尾核对）
- [ ] 卡含：目标 / 验收标准 / 涉及文件 / 限制条件 / 预期证据
- [ ] 交证含改动摘要 + diff + 测试 + 截图
- [ ] 客观门禁验证通过；大改动有评审（Review 五件事）
- [ ] 用户已拍板（合入 / 打回 / 改向）
- [ ] 教训已进 AGENTS.md；重复 3 遍的已自动化；长循环有预算上限
