SpexCode¶
面向编码 Agent 的 spec 驱动编排。
SpexCode 让人、编码 Agent 和 Git 仓库共享同一份意图。人说明什么应当成立；Agent 同时修改代码与 spec；Git 保存历史；eval 通过真实产品表面度量结果。Agent 可以完成工作，但合并仍由人审阅。
完整的提示词与指南合集把系统契约、CLI 帮助、hooks、skills 和 review 指导集中在一个经过验证、便于阅读的位置。
一个项目，三层能力¶
- Spec 资产（L0）把意图作为普通、可审阅的 Git 文件留在代码旁边。没有服务或仪表盘，它依然有价值。
- 会话底座（L1）给 Agent 提供隔离的 worktree、明确的生命周期状态和可审阅的合并交接。
- 仪表盘（L2）只是同一份数据的共享视图：图谱、会话、issue、eval 和实时终端。它增加可见性，不会成为第二个真实来源。
三层刻意可以拆开使用。先在一个仓库里配合普通 Agent；只有并行工作确实需要时，再加入会话和仪表盘。
普通 Agent 仍是默认路径¶
在 Git 仓库里运行 spex init --harness claude,codex，然后照常启动你使用的 Agent。SpexCode 会把一小段契约 materialize 到各个 harness 自动发现的文件中，所以普通的 claude 或 codex 已经知道要先读治理 spec、让意图与代码一起更新、度量结果，并提出而不是自行合并工作。
你不需要学习另一种 prompt 语言。直接告诉 Agent 想改什么，再审阅它给出的 diff。
让意图、历史和证据各司其职¶
一个 spec 节点是包含 spec.md 的目录。正文只说明它所治理代码现在必须做什么。Git 负责保存意图何时、为何变化的持久记录。spex spec lint 捕捉断链、未认领源码、代码领先于 spec 等结构性漂移；当行为本身重要时，eval 会记录真实产品上的场景和证据。
这种分工让文档不会变成过期的进度汇报，也不让自动化越过尚未被人审阅的决定。
从已有仓库开始¶
快速上手给出安装和一条命令引入的路径。与 Agent 协作说明直接使用、托管会话和仪表盘。 参考从 SpexCode 自己的 spec 树逐字投影，是本指南背后的详细契约。