治理模型
本项目将重要技能视为受治理资产,而非一次性提示文件。
目标
- 随时间保持共享技能的可信度
- 使所有权明确
- 避免陈旧或过大的技能包
- 定义技能何时应演进、拆分或退役
必需治理元数据
对于可复用或库级技能,manifest.json应包括:
nameversionownerupdated_atreview_cadencestatusmaturity_tierlifecycle_stage
允许值
status
experimentalactivedeprecated
maturity_tier
scaffoldproductionlibrarygoverned
lifecycle_stage
scaffoldproductionlibrarygoverned
review_cadence
monthlyquarterlysemiannualannualper-release
治理规则
1. 需要所有者
任何用于复用的技能必须有具名所有者或拥有团队。
2. 需要审查节奏
如果技能被共享,它必须声明应多久审查一次。
3. 成熟度应与严谨性匹配
scaffold:轻量、个人、低治理production:带验证的可复用团队技能library:带明确打包和评估的精选共享技能governed:带回归、维护和审查预期的关键或元级技能
4. 弃用技能需要明确意图
弃用技能应在相邻文档或清单扩展中包含弃用说明或替代参考。
5. 漂移必须可观察
重要技能应保持:
- 回归历史
- 可见的评估结果
- 已知反模式或失败模式
治理行动
使用治理审查来决定技能应:
- 保持原样
- 收紧触发边界
- 拆分为兄弟技能
- 将细节移入
references/ - 将脆弱逻辑移入
scripts/ - 被弃用或替换
治理成熟度评分
scripts/governance_check.py还计算满分100的成熟度评分。
评分区间
治理检查器除声明的清单层级外,还计算评分区间。评分区间是诊断输出,不是声明生命周期层级的替代品。
90-100:受治理80-89:生产65-79:可复用45-64:新兴<45:草稿
声明层级的推荐最低分
scaffold:无硬性最低分production:80library:85governed:90
评分维度
- 元数据完整性
- 所有权和审查节奏
- 边界和评估证据
- 操作资产
- 维护证据
评分不是人工审查的替代品。它是一个快速信号,表明共享技能结构是否足够,可以被信任、维护和审计。scripts/governance_check.py在声明层级声称的严谨性超过评分当前支持时发出警告。
为什么这很重要
大多数技能系统止步于创建。世界级的技能系统还管理:
- 所有权
- 漂移
- 成熟度
- 弃用
- 持续质量的证据