Skip to content

Document Execution Audit

本文记录本轮“整体文档落地性核对”的问题台账,按 P0 / P1 / P2 标记风险级别,并说明当前处理状态与残余风险。

P0

问题影响处理状态
主链文档已引入 领域技能包启用建议技能装配清单领域扩展执行记录 等输出项,但没有统一输出合同上下游知道要产出什么,却不知道按什么结构交付已通过 team-command-output-contracts.md 补齐
handoff-contract.md 未承接 custom overlay 场景输出/team-* 与 handoff 之间断链,结果无法稳定回落已补齐 conditional 字段要求
多数 skills/ 含占位变量或“按需读取”,但缺少变量解析与输出回落说明实施者会卡在“变量怎么定、结果写到哪里”本轮为已挂载的 custom overlay 补齐任务输入合同

P1

问题影响处理状态
入口文档、规则、runbook 对三层技能结构虽基本一致,但缺少主链输出合同入口平台理解成本高,实施者不容易找到执行基线已在入口和使用手册中增加 runbook 引用
custom-overlay.md 说明了技能定位,但对“默认挂载 / 可选启用 / 结果回落”不够细custom overlay 接入方式理解不完整本轮补充默认挂载、输出回落和合同引用
架构设计主链、发布治理 runbook、frontend-engineering 和语言 / 后端规则已部分接入 custom overlay 场景,但没有完全说明与主链输出的关系角色知道要看 role skill 或 runbook,不知道如何把结果回写主链本轮补充相关回落说明

P2

问题影响处理状态
custom overlay 仍保留内部脚手架和过程文档约定,如 process.mdqa-pending.md对非组织内部脚手架项目可读性一般,但不阻塞本平台落地保留,已补充变量来源和主链回落规则
历史企业扩展导入区仍包含未正式接入的能力容易误认为可直接安装已在文档中强调其仅是历史导入区

残余风险

  • skills/ 中部分技能依然强依赖组织内部脚手架、私有权限中心 或集团内部 SDK;这属于领域限制,不属于文档缺口。
  • 若后续继续接入新的原始 skill,必须重复执行本轮核对流程,不能只复制文件。
  • 本轮只精修已挂载、已纳入正式层的 skills;原始导入区未接入项不在深度精修范围内。

Released under the MIT License.