SuperAPI AI 工具集

doc-chg

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:doc-chg 用于编写变更管理(CHG)记录,是对修改既有 SDD 制品的治理覆盖层,不是生命周期层,没有层编号和就绪评分;按需触发,质量门槛是门禁批准而非数值评分。跨层范围覆盖 BRD → PRD → EARS → BDD → ADR → SPEC → TDD → IPLAN → Code。

适用时机:既有制品需要修正、细化或跨层变更;生产事故需要紧急修复并留档;监管、供应商、市场等外部触发需要受控变更。新建制品应使用对应层技能,端到端起草可用 doc-chg-autopilot。

主要能力:先做变更级别分类——C1(错别字、格式、澄清,无需门禁)、C2(章节更新、需求细化,需同行评审)、C3(跨层变更、新需求,需正式门禁与 GATE_APPROVAL_FORM)、Emergency(P0/P1 生产问题,事后门禁与复盘,48 小时内完成)。再按来源路由入口门禁:上游→GATE-01,外部→GATE-01,中游→GATE-03,设计→GATE-06,执行→GATE-08,反馈→GATE-CODE,规范→GATE-SPEC。随后沿链路追踪级联影响,在 impact_assessment.affected_layers 记录制品 ID、变更内容与级联方向。

使用方式:先阅读模板与门禁定义,确认无 ID 冲突并预留下一个 CHG-NN(紧急用 CHG-EMG-YYYYMMDD-HHMM);填充 CHG-TEMPLATE.yaml 的 metadata、change_control、change_description、impact_assessment、implementation、verification,C2/C3 加 rollback_plan,C3 加 gate_approval,Emergency 加 emergency_change;同步登记 CHG-00_index.md;C3/Emergency 交由 gate-check 运行正式门禁;最后校验并一起提交。

限制:该技能本身是校验器,无运行时代码;校验错误码包括 CHG-E001 至 CHG-E004。规范变更基于目标而非层,设置 change_source: spec、entry_gate: GATE-SPEC 与 semver_impact,不级联到制品门禁。平台自身编写指南或运行时不属于规范变更。具体命令与安装方式资料未提供。