跳转至

当前权威事实源注册表

状态:active。表中的文件名是当前事实 Owner;其最初引入版本不决定当前适用范围。

1. 原则

同一事实只允许一个权威 Owner。其他文件可以引用或生成投影,但不能成为第二个可覆盖版本。

事实 唯一 Owner 允许的投影
包版本、Skill、Reviewer 目录 manifest.json README、Skill Matrix、校验报告
模型组合、代理单位、评分与根预算上限 runtime/cp_runtime/data/dispatch-policy-v3.json;旧任务保留各自固定的 v1/v2 策略 manifest、模型策略文档与校验报告
项目身份和稳定边界 project-profile.json Onboarding 报告、任务信封引用
项目当前阶段和基线 project-state.json 状态摘要
任务阶段、门禁、Evidence、动作 execution-state.json Finalization Report、Handoff
Reviewer 轮次、Finding 与复审状态 review-state.json Review Ledger
根任务统一预算、permit 与预占 仓库外 DelegationBudget V3 账本;V2 保留冻结续写;scripts/delegation-budget.py 管理 任务信封引用、成本摘要
Hook 注册入口 基础 hooks/hooks.json;增强 scripts/package_manager.py::hook_fragment 配置指南、架构说明
工作区能力定位与覆盖 Profile 同级 capability-index/<worktree_id>;CapabilityStore 管理 query 结果、任务决策引用
项目门禁启用与绑定 账户外部 capability-gates/<worktree_id>.json;GatePolicy 管理 status 读回
旧门禁任务与当前回执 Profile 同级 capability-gate/<worktree_id>;GateTask/Workflow 管理 prepare/finish/check 结果;仅为 schema 1 旧状态事实,不授予 Operation v2 写入权限
Operation v2 写前与结果回执 Profile 同级 capability-operation/<worktree_id>;Hook 创建起点并绑定真实 A/B,CLI 只消费引用 只约束显式启用策略下的规范 apply_patch;不授予 Git、发布、部署或业务写权限
Review 冻结输入 Review Packet manifest.json Packet Summary
当前任务恢复 CURRENT_TASK.md + PROGRESS.md Recovery Summary
项目长期事实 project-memory.md 项目文档引用
跨项目经验候选 Knowledge Candidate JSON 人工评估报告

2. 状态冲突处理

  • 机器状态与 Markdown 冲突:优先机器状态,并记录冲突;
  • 项目文档与实际 Git/运行结果冲突:优先当前可验证事实;
  • Checkpoint 与 Project Memory 冲突:Checkpoint 只说明任务当时状态,不能覆盖已审核项目事实;
  • Knowledge Candidate 与当前项目事实冲突:候选只作为输入,不能自动应用;
  • Approval 与 Evidence 冲突:两者职责不同,不能互相替代。

3. 文档状态

建议文档显式标记:

  • active:当前适用规范;
  • reference:按需读取资料;
  • historical:仅用于追溯;
  • generated:由机器状态生成,可重新生成。

历史文档不得覆盖 Active 规则,Generated 文档不得被当作独立事实源手工维护。

机器事实来源引用

  • repository-external DelegationBudget V3 JSONL via delegation-budget.py; frozen V2 continuation
  • review-state.json via review_controller.py