简体中文 · English · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)
让 Codex 和 DeepSeek 在长任务中守住范围、控制验证，并在中断后继续。
Dev Flow 为 AI 编程任务提供一份独立于聊天记录的本地任务状态。它记住：
- 这次任务允许改什么，不允许扩展到什么；
- 当前进行到需求、设计、实现、测试还是交付；
- 约定了多少验证，哪些证据已经完成；
- 会话中断或写入结果不确定时，应该恢复、阻塞还是安全重试。
它不是另一个编程 Agent，也不是任务编排器。 Codex 和 DeepSeek 仍负责读代码、改代码和运行 命令；Dev Flow 只管理一个开发任务的范围、阶段、验证强度、证据和恢复。
从这里开始： 两分钟看懂一次完整任务 · 查看当前版本与真实证据 · 安装稳定版
本 README 介绍当前
main的能力。npm@latest是经过最终制品验证的稳定版，可能晚于main；稳定版、beta 和源码的准确差异见项目状态页。
| 直接使用 Agent 时 | Dev Flow 增加的能力 |
|---|---|
| Prompt 反复强调“不要扩大范围” | Task 保存原始意图，每一步明确允许做什么 |
| 会话重启后重新扫描仓库、猜测进度 | 当前阶段、证据和阻塞原因保存在本地，可直接恢复 |
| 定向检查逐渐扩成全量回归或平台矩阵 | 每个 Task 都有明确的 verification budget |
| 测试通过，但实现仍难以解释和接手 | 交付前经过 COMPREHENSION_REVIEW |
| 写操作响应丢失后直接重试，可能重复副作用 | 先读取权威状态，再依据 Recovery 结论行动 |
flowchart LR
A["描述任务与边界"] --> B["需求与设计"]
B --> C["实现"]
C --> D["定向测试"]
D --> E["理解审查"]
E --> F["交付"]
F --> G["DONE"]
D -. 发现实现问题 .-> C
E -. 过度复杂 .-> H["重构"]
H --> D
如果 Host 在实现后重启，新会话读取同一个 Task，仍能得到当前阶段、已完成证据、剩余验证预算和 合法下一步，而不是从聊天记录重新推断。仓库中保留了真实 Codex 与 DeepSeek Journey 的结构化证据； 详见两分钟演示。
| 工具 | 负责什么 |
|---|---|
| Codex / DeepSeek Harness | 读取仓库、修改代码、运行命令 |
| Spec Kit / OpenSpec | 提供需求、设计和任务拆分方法 |
| Dev Flow | 保存一个任务的范围、阶段、验证预算、返工路径和恢复状态 |
一个 Spec Kit 文档、OpenSpec checkbox 或成功的测试命令都不会自行推进 Task；状态只由 Go Core 在校验当前 Action 后更新。
当前稳定制品支持 macOS arm64 和 Node.js >=24。精确版本与 Host 兼容范围见
Support Matrix。
统一生命周期管理器完成独立发布后，安装、升级、修复、重装、卸载和清空后重装都使用下方的
create-dev-flow 入口。当前公开 npm 稳定版尚未包含该新 package；Host 原生命令继续作为发布前及
诊断恢复入口。
npx @imotong/create-dev-flow@latest进入 Git 仓库后，使用精确 selector 启动 Dev Flow：
$dev-flow-codex:dev-flow Fix idempotency in the order-creation endpoint and run targeted tests.
完整安装、升级和移除方式见 Codex 使用说明。
npx @imotong/create-dev-flow@latest重启 profile 后，在对话中输入：
/dev-flow Fix idempotency in the order-creation endpoint and run targeted tests.
完整说明见 DeepSeek 使用说明。
Dev Flow 适合：
- 需要经历需求、设计、实现、测试和交付多个阶段的真实仓库任务；
- 可能返工，并需要保留验证证据的修改；
- 会跨会话、跨天或在 Host 重启后继续的工作；
- 需要明确限制测试强度，或要求开发者在交付前真正理解实现的任务；
- 由一个主仓库和少量显式附加仓库共同完成的有界任务。
一次性问答、无需保留状态的机械性单文件修改，直接使用 Codex 或 DeepSeek 通常更简单。
TaskIntent 保存最初请求、验收条件和范围外事项。实质性需求或设计变化必须通过受控流转返回相应
阶段，不能悄悄扩大当前步骤的权限。
每个 Task 都保存 verification budget。检查应直接关联当前阶段、变更范围、验收条件或已知恢复风险； 完整回归、平台矩阵和压力测试不是默认动作。
当前阶段、需求/设计/任务基线、证据、阻塞原因和合法下一步保存在本地 SQLite。卸载 Host 集成时， Task 数据默认保留。
测试通过后仍需经过 COMPREHENSION_REVIEW。无法清楚解释或维护的实现可以回到设计、实现或重构，
任何仓库变更都必须重新通过测试。
写操作携带 revision、Action identity、source cursor 和 repository binding。响应丢失或中断时， 调用者先读取 Core 的五分类 Recovery 结论，再决定恢复、阻塞或安全重试。
允许写入的 Action 在结果中提交精确 changed_paths 或 no_file_changes。Core 以签发基线、当前
allowed_effects 和 fresh Git observation 验证；合法 worktree 结果可由原 Action 提交，branch、
HEAD、repository identity 或未声明路径变化仍返回 REPOSITORY_DRIFT。
当前源码允许一个 Task 显式声明一个主仓库和最多七个附加仓库。所有仓库共享同一个阶段、Action、 revision、验证预算和结果；系统不会扫描相邻目录、依赖或代码索引来自动扩大范围。该能力是否已进入 稳定版，请以项目状态页为准。
- Core 只对 Git 做有界、只读观察；不会执行 commit、push、merge、rebase、tag 或发布。
- 真正的文件修改和命令执行仍由用户授权的 Host 完成。
- Dev Flow 不会拦截 Host 的每一次文件读写，也不是通用安全沙箱。
- 当前源码包含仅监听 loopback 的共享 WebUI，前端支持简体中文/英文、首次跟随系统语言并允许浏览器内切换；不包含远程 MCP、遥测、用户自定义流程图或自动历史数据迁移。
- 可选代码索引只提供检索结果，不能决定仓库范围、权限、Recovery 或流程状态。
安全边界见 Security Policy 和 Threat Model。
| 产品 | 稳定版本 | Bundled Core | 已验证环境 |
|---|---|---|---|
dev-flow-codex |
0.7.2 |
0.6.1 |
macOS arm64、Node.js >=24、Codex >=0.147.0 |
dev-flow-deepseek |
0.7.2 |
0.6.1 |
macOS arm64、Node.js >=24、DSH >=0.1.0-rc.6 |
这些声明来自公开制品和最终 Host Journey，而不是只来自“源码可构建”或“测试通过”。完整证据与 beta/source 状态见 Project Status 和 Support Matrix。
| 想了解什么 | 入口 |
|---|---|
| 两分钟理解真实流程 | Demo |
| 当前稳定版、beta、源码和证据 | Project Status |
| 产品能力与边界 | Product |
| Core、Adapter、Store 与 Recovery | Architecture |
| 支持版本和平台 | Support Matrix |
| 用户命令与 MCP 工具 | Command Reference |
| 本地 WebUI 与 CLI-only reset | WebUI |
| 后续方向 | Roadmap |
| 安全报告与威胁模型 | Security · Threat Model |
| 提交 Issue 或 Pull Request | Contributing |
| 维护者发布流程 | Release |
需要 Go >=1.26、Node.js >=24 和 pnpm >=11 <12：
pnpm install --frozen-lockfile
pnpm run validate