更少上下文，更少仪式感，更多交付。

面向编码 agent 的设计先行、五步开发循环。

安装之后 · 五个步骤 · 快速开始 · 演示 · 隔离 · 与 OpenSpec 的区别 · 中文

dev-circuit-ultra 是面向独立开发者的功能开发循环，以 skill 形式交付给 Claude Code、Codex、pi 和 DeepSeek-Harness 等编码 agent。它把一个功能拆成五个步骤：设计澄清、一个切片、构建与验证、独立审查、收尾。

它不维护 proposal、任务列表或归档，也不保留长期的设计档案。当前的设计就是唯一来源。设计变更时，旧文本被覆盖或删除；决策历史存放在项目之外的私有账本中，开发 agent 永远不读它。

图 1. 项目与私有账本相互分离；开发容器没有挂载账本。 D:\code\my-app 是项目；D:\ledgers\my-app 是项目之外的私有 git 账本。开发 agent 只读写项目；归档者只向账本追加内容；人是唯一的桥梁。

图 2. 五步循环：当前设计流入，历史流出。

1. 同步 skill（Claude Code / agents / DeepSeek-Harness 目录）

pwsh -NoProfile -File sync.ps1

2. 创建项目

pwsh -NoProfile -File skills/dev-circuit-ultra/scripts/new-project.ps1 ` -Path D:\code\my-app -Name "My App"

3. 在项目之外创建私有账本

pwsh -NoProfile -File skills/dev-circuit-ultra/scripts/new-ledger.ps1 ` -Path D:\ledgers\my-app

然后在项目内开始设计澄清。第一个功能时，skill 会询问一次如何运行独立审查（同一模型、指定的 reviewer agent，或每个功能都重新询问），并把选择保存到 .dev-circuit/reviewer.json。账本是独立的步骤；项目中不会出现 ledger/ 目录。

实现：Markdown skill + Python 3（doc_guard / spec_check）+ PowerShell 7（bootstrap）+ git；无服务端组件，Docker 隔离可选。

同一个仓库既是 DSH 插件包，也是一组兼容 DSH 的 skill。安装该包即可一次性注册全部三个 skill：

dsh plugin --profile web add dev-circuit-ultra

或者通过 SkillHub / ClawHub 把各个 skills/<name>/ 文件夹发布到 Skill Store。dev-circuit-archivist 和 dev-circuit-ledger 仅限人工调用；开发模型无法自动加载它们。安装、商店发布和列表文案见 docs/dsh.md。

60 秒演示：五个步骤，外加与 OpenSpec 的开放式 A/B 对比（WebM，无音频）。

python demo/run_demo.py

演示会创建一个一次性项目和外部账本。它会演练破坏性设计编辑、只存在于账本中的被弃想法、收尾时的 card 删除，以及 doc_guard 拒绝项目内 ledger/ 目录。它不调用 LLM；强隔离来自 Docker 挂载边界。见 demo/README.md。

一句“不要读账本”的提示词不构成隔离。要保证隔离：

推荐强隔离。见 docker/compose.yaml：

完整边界和验证命令：docs/ledger.md 和 docker/README.md。

OpenSpec Dev-circuit-ultra 设计 proposal/design/tasks/spec delta，长期保留 当前设计；变更时覆盖/删除 决策历史 在 change/archive 中，不断增长 外部私有账本，仅限人工 开发 agent 读取的内容 可能是全部历史 仅当前设计/代码 收尾 归档保留 card/设计删除；仅保留当前状态 目标 审计轨迹、跨人员交接 快速迭代、精简上下文、不漂移

当你需要审计轨迹、跨人员交接或跨仓库规划时，OpenSpec 更合适。对于一名开发者用 agent 持续交付的场景，dev-circuit-ultra 更轻。

一个开放式任务简报，每个 skill 一个会话，对最终仓库做一次盲审。n=1；请结合注意事项来理解，不要当作普遍结论。

文档数涵盖需求 + 使用指南 + OpenSpec 主 spec；OpenSpec 的 proposal/design/tasks 文件不计入。token 数字是观测到的用量，不是供应商中立的账单。Dev 的 1 分优势主要来自干净的收尾和 Decimal 合计；OpenSpec 的测试和错误处理更强。完整产物审查见 bench/README.md。

图 3. 开放式 A/B（n=1，盲审产物）：Dev 27/30，OpenSpec 26/30。Dev 快 3%、便宜 30%，且收尾干净；OpenSpec 测试更多、错误处理更强，但留下了 11 条未提交条目和一个浮点合计。这不是普遍结论。见 bench/README.md。

先改设计：覆盖/删除旧文本；然后改代码/测试。归档者在外部账本中记录旧决策和被否决的选项。

如果开发 agent 需要旧决策怎么办？

停下来问人。人用 dev-circuit-ledger 查询账本，得到一份最小简报，只把当前约束传给开发 agent。

强隔离下不会：无挂载、无路径、无凭据。弱/中等隔离设置只是约定，不是保证。

设计是实现依据，不是历史。没有它 agent 只能猜；账本向人解释过去的猜测，而不是向 agent 解释。

由你决定。第一个功能时，skill 会询问：是在独立上下文中使用同一模型、使用指定的只读 reviewer agent，还是在每个功能开始时重新询问；它把答案存到 .dev-circuit/reviewer.json。skill 中没有固定的 reviewer 模型。如果配置的 agent 缺失或失败，它会停下来询问，而不是悄悄替换成一个实现工人。

足以覆盖设计的边界/契约即可。测试是证据，不是决策档案；一次性测试没问题，只有用户可见的契约/回归测试需要保留。不要测试矩阵。

SKILL.md：完整工作流、规则和模板 docs/ledger.md：边界、隔离和验证命令 docs/dsh.md：DeepSeek-Harness 安装、兼容性和 Store 发布 docker/README.md：dev / archivist / ledger 容器参考

（原文较长，此处译出前 6000 字，完整内容请点「打开原文」。）