SuperAPI AI 工具集

spec-charter

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:spec/charter.md 是项目可选开启的规格参照轴,用于衡量 backlog 工作、冲刺计划与偏离。该技能可重复运行,核心是维护这一“什么算好”的基准文件。

三种模式:create——在既无 spec/charter.md 也无旧版根 CHARTER.md 时创建,依据 README、issue、CHANGELOG 等产品信号起草,并通过访谈完善问题、方法、非目标与初始目标,写入 revision: 1;amend——对已存在文件按三层门禁应用变更;reassess——只诊断不编辑,报告文件是否过时。

三层纪律:方向层(问题、方法、非目标)人类把关,慢变;谓词层(目标)状态从 active 推进到 validated/deferred 需证据;历史层(决策)仅追加,反转需新行 supersedes。目标使用 O<n> 编号,不复用已删 ID,记录来源。

用法:从已安装技能目录解析辅助脚本,始终显式传目标仓库,如 check-size.js --path <target-repo>/spec/charter.md,用于确认 5 分钟可读性。若辅助脚本不可用则报告 Missing Evidence 并改用有界文件读取。

限制:文件缺失是被支持的,其他技能会优雅降级;旧版根 CHARTER.md 仅作回退。承诺保持 5 分钟阅读时长,操作知识不属此处。brownfield 仓库建议先建 system map,再请 spec-grill 审查能力边界。具体收费、价格与平台信息资料未提供。