spec-charter 用于维护项目方向与系统形态两类规格文档。
用途:负责 spec/charter.md(方向:什么是好的结果以及为什么)和 spec/system-map.md(系统形态:边界、流程、不变量、指针)。spec/capabilities.md 中的能力契约属于 spec-grill。文件角色、拓扑、harness 指针和旧版根目录 CHARTER.md 回退规则见 references/spec-axis.md。本技能不附带脚本:直接检查目标仓库,路径保持相对目标仓库。charter 保持在约 5 分钟阅读量;操作类说明应放在 harness 文件或操作笔记(如 _context.md)中。项目通过创建文件来选用,也支持不存在。
主要能力与模式:包含模式路由器与完成契约。模式词优先,其次按意图(系统形态、架构、运行时边界、流程、不变量或 spec/system-map.md 映射为 map;陈旧或规格健康检查为 reassess),最后按文件状态(无 spec/charter.md 和旧版根目录 CHARTER.md 时为 create,否则为 amend;概念变更走 reset 路径)。能力契约路由到 spec-grill。完成契约要求每次运行说明创建或修改的文件、被拒绝或搁置的内容(被拒绝的 harness 指针也算)以及一个下一步动作。
变更纪律:Tier 1 方向(Problem、Approach、Non-Goals)需人工确认:质疑→提出 diff→确认→应用。Tier 2 谓词(Objectives):增删需人工确认;ID 稳定且永不复用,退役通过删除该行并在 Retired IDs(永不复用)下列出 ID。Tier 3 长期决策(Decisions):需人工确认;决策翻转时就地重写该行,拒绝理由不再成立时删除。Objectives 是可验证谓词而非任务,格式如 - O1 — <predicate> · src: user|inferred|execution;默认无状态标记,已有状态标记则保留,但不得给精简 charter 添加标记。结构标签用英文,其余遵循仓库 README 语言与用户。
使用方式:Create 从产品信号(README、issues、changelog、已发布行为)起草,harness 文件仅影响工作流而非产品权威;信号冲突时须显式呈现。Amend 按层级纪律应用,旧版根目录 CHARTER.md 应有意迁移而非分叉。Map 依据仓库证据和已定稿 charter 构建,不从目录名推断,证据在对话中报告;包含 System Shape、Runtime Boundaries、Core Flows、Storage And External Systems、Project-Wide Invariants、Where To Go Next 等节。Reassess 只报告不编辑,默认结论为“no change”。
限制:本技能不提供脚本;不编造运行时边界,缺失时列入 Evidence Missing;map 不是 API 参考、运行手册或模块清单;charter 需保持约 5 分钟阅读量。平台、收费、价格、具体安装命令等资料暂未提供。