Artifact-native reconciliation
让图从事实中长出来¶
HarnessGraph 用 Slot 表示工件的位置,用 Rule 表示工件之间的生成关系。你声明想得到什么,内核负责让当前状态向目标状态收敛。
为什么会有 HarnessGraph¶
许多 Agent 工作流从步骤开始设计。先做 A,再做 B,失败就跳回 C。随着分支、人工确认、重试和缓存增多,流程控制很快挤满业务定义。
HarnessGraph 换了一个起点。项目中的计划、代码、评审、批准和发布包都看作工件。每个工件进入一个 Slot,每条 Rule 只说明它读取哪些 Slot,又写入哪些 Slot。依赖关系由读写关系确定,调度器只处理事实是否已经更新。
这个模型只有两个作者需要直接使用的原语。
Slot
一个有名字的工件位置。文件、目录和 Git 仓库都可以成为 Slot。
Rule
一条从输入 Slot 生成输出 Slot 的声明。Shell、Agent 和 Human 都沿用同一种形状。
从哪里开始¶
第一次使用时,先完成 Quick Start。它不调用 Agent,只用一条确定性的 Shell Rule 演示 Revision、执行和复用。
接着阅读 核心哲学 和 两个原语。如果你更关心循环,直接进入 番茄钟教程。并行、条件、汇合与更奇怪的拓扑集中在 图语义实验室。
安装页提供公开发行包;教程中的命令、Slot 与 Rule 名称均与当前发行版本保持一致。