用途:ctx-spec 是 spec/ADR/设计文档的“怎么写”层,目标是产出智能体读一次即可直接构建的文档。它由四条正交轴控制:Status(规范性 vs 说明性)、Strength(RFC 2119 的 MUST/SHOULD/MAY,全大写可检索)、Why-discipline(按 IRB 分类理由:INTENT 留在规则内,RATIONALE 进 ADR,BACKGROUND 删除)、Granularity(只写约束不写机制)。
主要能力与用法:按 target 分类为 subsystem-spec、decision(ADR)、design、architecture、theory 并分别处理。spec 模板分层:Tier A 精确(EARS 验收标准、接口、数据模式、不变量、安全约束、明确的 out-of-scope),Tier B 宽松(仅 HLD 草图、代码地图、实现提示)。要求含不可变 REQ-### 编号,任务 T### 放在 progress/ 而非 spec 内,形成 story→REQ→验收/设计→T### 的追溯链。ADR 独立成文,顺序 4 位编号(0001)、永不重用、一旦决定不重写,只通过双向 supersede 指针就地替换。写前先扫描 decisions/ 与 reject-log,避免重复讨论。
适用场景:需要为 AI 编码智能体编写可构建规范的软件项目;区分原型(宽松)与交易/受监管系统(收紧契约)。
限制:资料未提供安装命令、收费、价格与具体平台支持信息;任务列表不属于 spec;不手写 LLD;理论内容需拆分为规范性提取与 scratch/ 原始资料。