 Qiu Yuzhou
|
be30f64f9f
|
docs(design): 移除 to-spec 产物，去掉 user-plugin 文档的 -spec 后缀
两类文档来源不同，处理方式也不同：
- system-proxy-runtime-control-spec.md、terminal-command-address-spec.md 是
to-spec 技能的原样产物（英文模板小节标题，无标题与日期头）。其内容已发布为
Issue #72 / #73，人类需要的信息已由同日提交的无后缀中文文档承载；在仓库里再
存一份，等于同一份规格有两个事实来源。删除后仍可从 git 历史追回。
- user-plugin-*-spec.md 四份来自 improve-codebase-architecture 会话：该技能把
报告写进 OS 临时目录、不写 docs/design/，因此这四份是模型模仿仓库既有
-spec.md 旧例命名（“猜测旧例”而非技能指令）。去掉后缀后仓库不再有该样板，
后续模型少了可模仿的命名来源。四份保留原名主体，内容不动。
影响面：这六份文件全仓库零入站引用（含 docs/ 内部），移除与改名都无需改写链接。
docs/design/ 现为 12 份，无一带 -spec 后缀，与 AGENTS.md 的定位一致。
有意不做：不加“docs/design/*.md 必须带可解析 日期：/状态： 头”的确定性检查。
AI 输出本就无法保证规范化；更关键的是这类文档的“状态”只描述某次改进上下文，
不跟踪现状，把它当可校验字段是假精确。日期是写作时点的事实，两回事。
|
2026-10-05 22:39:58 +08:00 |
|