文档目录

核心概念

这一页把散落的名词串起来:制品、关系、上下文包、评审协议、方法注册表。读完应能对着目标仓库说出有哪些制品、它们怎么连、机器怎么验。先取一份上下文,再回头看定义。

现场取上下文 #

sh
artifact-graph context --target design:DESIGN-xxx
artifact-graph query --from feature:FEAT-xxx --format json

返回的是可复现的上下文包雏形。--target 使用 类型:ID。插件侧看能力清单用 artifact-chain-help,体检用 artifact-chain-setup。

制品类型 #

制品分两套口径,不要混用数字:

  • 基础类型:需求、场景、设计、决策、测试、实现。内核认识这些类型。
  • 扩展类型:按项目配置开启。扩哪一类,由目标项目的 artifact-graph.config.yaml 决定,不写进内核。新增类型是在配置里加 types 条目,而不是改内核。

扩展目录、目录层级与「基线文件数量」是三组不同口径。本站不把其中一组数字套到另一组上。

追溯边与关系锁 #

制品之间靠边连接(谁实现谁、谁验证谁)。关系锁里有两类边:

  • locks:实现或验证这类已确认关系,是可审计基线。CI 用 version-lock audit 卡住它。
  • artifactRelations:制品之间的泛化关系;缺该字段时视为空数组,需要 version-lock refresh --all 建立基线。

validate 检查的是这条链有没有接上、有没有断头引用。

评审结果协议 #

助手做完评审,应交回一份结构化结果,而不是一句「审完了」。要点有三:

  • 失败关闭:校验没过就当失败,不默认放行。
  • 稳定身份:每条结果用执行者与名称定位,重试也能对准同一条。
  • 尝试次数封顶:允许有限重试;禁止把「自己改自己」当成通过。

单独校验一份评审结果:

sh
artifact-graph validate-review-result --file review.json

方法注册表 #

Registry 是方法提供方的接入面,建立在契约内核之上,管身份、清单、绑定、投影与运行期选择。图管制品与关系,注册表管能力提供方,两者正交。细节见方法注册表。

profile、模板与 hook #

  • profile:按项目裁剪要加载的技能与模板。
  • 模板:制品起始骨架,写新制品不必从空文件开始。
  • hook:在 pre-commit / pre-push 自动跑校验。具体步骤在场景剧本。

搜索文档

↑ ↓ 选择 · Enter 打开Esc 关闭
文档目录