本目录存放 mcpp 的规范性文档 —— 定义机制的语义与约束,而不是使用教程。
| 目录 | 性质 | 读者 |
|---|---|---|
docs/*.md |
使用文档:怎么用、有哪些字段 | 使用者 |
docs/spec/*.md |
规范文档:语义、约束、匹配机制、实现状态 | 索引作者、贡献者、下游工具作者 |
.agents/docs/*.md |
设计文档:某次改动的调研、取舍、实施计划 | 参与该次改动的人 |
规范文档同时描述目标规范与当前实现,每条规则都标注实现状态,因此可以直接用来判断「现在能不能这么写」。
按 RFC 2119:必须 / 禁止(强制)、应当(强烈建议)、可以(可选)。
| 标记 | 含义 |
|---|---|
| ✅ 已实现 | 当前实现与规范一致 |
| 已有实现,但语义或覆盖面有差异(差异已注明) | |
| ❌ 未实现 | 规范要求但尚未支持;当前行为已注明 |
标注 ❌ 的条款尚未生效。在其落地前,请按各文档中「当前应当怎么写」一节书写。
| 编号 | 标题 | 状态 | 最后修改 | 对应实现 |
|---|---|---|---|---|
| SPEC-001 | 包身份(package.namespace / package.name)、[dependencies] 选择器与匹配机制 |
评审中 v1.1 | 2026-08-03 | mcpp >= 0.0.106 |
每份规范必须在开头提供元数据表:规范编号、标题、状态(草案 / 评审中 / 已接受)、版本、最后修改日期、对应实现版本、相关设计文档与 issue;并必须在结尾提供变更记录。
状态流转:草案(Draft) → 评审中(Review) → 已接受(Accepted);被后续规范取代时标 已废弃(Superseded by SPEC-NNN)。