核心概念
这一页把散落的名词串起来:制品、关系、上下文包、评审协议、方法注册表。读完应能对着目标仓库说出有哪些制品、它们怎么连、机器怎么验。先取一份上下文,再回头看定义。
现场取上下文 #
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 自动跑校验。具体步骤在场景剧本。