autonomous-dev

name

autonomous-dev

description

自主连续开发方法论（Codex 版）。把一个项目按「每轮一个最小可提交单元」的方式推进到完成： 每轮读真相源 → 选下一个未做项 → 做一个最小单元 → 过验证门 → 记录勾选 → 最小提交 → 报进度。 适用于"按需求/台账建功能、还原原型、修一批 bug、补测试、重构、迁移、清理"等需要反复同构推进的任务。 与 Claude Code 的关系：Claude Code 有内置 `/loop` 自动续期（`/loop /dev-loop`），Codex 没有—— 所以 Codex 端由你（或脚本 / cron）反复触发"继续下一轮"，方法论本身一致。 触发场景： - 想让 Codex 把某个项目/某个意图"一轮轮推进到完成" - 还原原型图、修一批 warning、补单测、重构模块等同构重复任务 - 需要"每步可编译、可回退、可恢复"的稳健推进方式 触发词：自主开发、连续开发、循环开发、一轮一提交、还原原型、批量修复、autonomous dev、continuous dev

autonomous-dev — 自主连续开发方法论（Codex 版）

这是什么 / 怎么用

把开发拆成一轮一个最小可提交单元的同构循环，每轮稳定产出、可验证、可回退、可恢复。

• Claude Code 用户：直接用 /loop /dev-loop（自动续期）或 /loop-gen <意图> 生成定制循环提示词。
• Codex 用户（本技能面向你）：没有自动续期，每次触发执行一轮，做完即停；由你或脚本再次触发"继续下一轮"。方法论与下面完全一致。

每轮标准流程（核心）

1. 读真相源（每轮必读，不可凭记忆）：需求文档 / 原型（prototype/*.html 或 docs/prototypes/）/ 任务台账（docs/tasks/ 的 [ ]/[x] 清单）/ 项目规约（AGENTS.md / CLAUDE.md / .claude/PROJECT.md）。上下文会压缩，但文件不会——每轮回读才不漂移。
2. 选一项：台账里「最靠前、依赖已完成」的第一个未勾 [ ]；没有台账（第 0 轮）就先按需求+原型拆出有序最小任务清单写进 docs/tasks/active/ 再结束本轮。
3. 只做这一个最小单元，遵守项目技术栈与架构规约，严禁一轮多做。
4. 验证门（必须过才提交）：
   • Tauri / web 前端：cargo check（后端）+ npx tsc --noEmit（前端），相关则 cargo test。
   • Qt / C++：cmake --build build + ctest。
   • 红了当场修绿。每完成 5 项或到里程碑边界跑一次全量。
5. 记录：台账该项 [ ]→[x]，补一行「实际改了什么 / 坑」。
6. 最小提交：逐个 git add 本轮改动的具体文件（禁止 git add -A），git commit（Conventional Commits 带 scope，一句话）。
7. 报本轮：✅做了啥 | 📊进度 X/总 | ⏭️下一个。然后停止本轮（Codex 等待下次触发）。

原型保真截图闭环（涉及 UI 的任务必过）

模型偏离原型，根因是"看不见自己渲染的结果"。给它装眼睛：

• 起前端 / 编译运行应用（用后台方式起，不 kill 已有进程）。
• 截运行界面 = 现状：web 前端用浏览器打开运行页截图；原生窗口（Qt）用桌面截图 / QWidget::grab() 导出 PNG。
• 打开对应原型 = 目标，逐条比对：布局分区 / 主辅状态色 / 间距留白 / 字号字重行高 / 控件类型 / 文案 / 交互态（hover/按下/禁用/空态）。
• 有差异只改视图层 → 重新截图确认消除；关键差异没消除就继续修、别急着提交。
• 颜色 / 间距 / 字号一律用设计令牌（CSS 变量 / QSS 主题），禁止硬编码；禁止"我觉得更好看"擅自改。

决策分流（遇模糊不瞎停也不瞎冲）

• 可逆 / 低风险（命名、文件位置、等价写法）→ 按合理默认继续，记一行 docs/BLOCKERS.md，不空等。
• 不可逆 / 合规 / 架构级 / 缺外部凭据 → 停下问用户。

卡点熔断 + 停止条件

• 连续 3 轮无实质进展，或同一项 2 轮验证门修不过 → 停止，报错误原文 + 判断 + 建议。
• 任务台账全部 [x] + 验收清单全绿 → 输出「✅ 完成」+ 自检，停止（不再继续）。

红线

• 不发明真相源里没有的功能；技术栈不换。
• 文件 UTF-8 无 BOM、中文注释可读。
• 不按名杀宿主进程（按端口 / PID 精准）；不 git add -A；不 git reset --hard / clean 丢改动；本地提交不推远端（除非用户明确要求）；私钥 / .env 不进 git。