القائمة
将 Speculo 多文件能力（skill/command/workflow）合并为自包含单 MD 文档，上传到网页 AI 平台（ChatGPT Projects、Claude Projects、NotebookLM）使用。触发：用户要求生成 canonical 文档、要求将能力打包为单文件、或要求上传能力到 AI 平台时。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | speculo-write-canonical |
| description | 将 Speculo 多文件能力（skill/command/workflow）合并为自包含单 MD 文档，上传到网页 AI 平台（ChatGPT Projects、Claude Projects、NotebookLM）使用。触发：用户要求生成 canonical 文档、要求将能力打包为单文件、或要求上传能力到 AI 平台时。 |
将 Speculo 多文件能力合并为自包含的单 MD 文档，可直接上传到网页 AI 平台作为知识附件。输出是纯 Markdown 文档，不使用 <canonical> XML 容器——它就是一份普通 MD 文件，平台直接解析。
读取能力目录，识别：
SKILL.md、workflow 的 INDEX.md、work entry 的 <Name>.md、command 的单文件 .mdreferences/*.md、routes/*.md、atomic-skills/*.md 等——在主入口中搜索 ](references/、](routes/ 等链接模式找到它们_state/、.speculo/、.gitkeep、.DS_Store、node_modules/完成标准：主入口已识别，所有被引用文件清单完整，排除列表正确。
逐个读取主入口和所有被引用文件。记录每个文件的：
.md 扩展名，kebab-case）完成标准：所有文件内容已读取，frontmatter 块已标记待去除。
按以下结构输出单个 MD 文件：
# <能力名称>
<主入口文件的正文，已去除 YAML frontmatter。其中所有 <Path>...</Path>
标签替换为纯文本描述，所有文件引用替换为指向文末隔离标签的说明。>
---
## 参考内容
<每个被引用文件的内容，用 XML 隔离标签包裹。>
具体规则：
--- 块。这是 Speculo 内部元数据，网页平台不需要。<Path> 替换为纯文本：将 <Path>{roots.xxx}/path/to/file</Path> 替换为自然语言描述。例如 <Path>{roots.state}/specdev/changes/{change}/LOG.md</Path> → "同步更新 LOG.md"。{change} 等变量直接描述其含义即可。[某文档](references/xxx.md) 替换为 "参见下方 <xxx> 标签中的完整内容"。目标是将所有需要的外部知识内联到本文档中。<文件名（去.md）>...</文件名> 包裹。标签名取自文件名去扩展名，kebab-case。例如 references/grilling-protocol.md → <grilling-protocol>...</grilling-protocol>。输出格式示意：
# 设计访谈（带文档）
组合 work——grilling 访谈技术 + domain-modeling 领域建模规程...
## 流程
### 1. 启动变更
创建变更目录，初始化三个文档：ADR.md、LOG.md、CONTEXT.md。
### 2. 访谈
使用 grilling 访谈协议进行设计访谈。完整协议见下方 <grilling-protocol> 标签。
### 3. 捕获文档
按领域建模规程维护三个文档。完整规程见下方 <domain-modeling-rules> 标签。
---
## 参考内容
<grilling-protocol>
# 访谈协议
...（grilling-protocol.md 的完整正文，无 frontmatter）...
</grilling-protocol>
<domain-modeling-rules>
# 领域建模规程
...（domain-modeling-rules.md 的完整正文，无 frontmatter）...
</domain-modeling-rules>
<adr-format>
# ADR.md 格式
...（adr-format.md 的完整正文，无 frontmatter）...
</adr-format>
<Path — 必须为 0 结果---\nid: 或 ---\ntype: — 必须无 Speculo frontmatter 残留<xxx>"完成标准：无 <Path> 残留、无 frontmatter 残留、所有引用已内联。
| 规则 | 说明 |
|---|---|
| 纯 Markdown | 不使用 <canonical> 或 <source-file> 包裹标签 |
| 无 YAML frontmatter | 去除所有 --- 元数据块 |
无 <Path> 标签 | 替换为自然语言纯文本描述 |
| 子文件 XML 隔离 | 用 <filename>...</filename> 包裹内联内容 |
| 单文件自包含 | 全量内联，无外部依赖，无渐进式披露 |
| 标签命名 | 取文件名去 .md 扩展名，kebab-case |
生成的 canonical 文档是上传到网页 AI 平台的知识附件——平台在每次对话中都会加载它。因此：
对 workflow 下已完成 change 执行归档移动，从归档 change 中提取知识并合并到 workflow INDEX.md 声明的 _state/ 知识 store（adr/、context/ 等）， 然后审计并清理过时/重复知识。默认 dry-run 返回可确认计划，所有破坏性动作需用户显式确认后执行。 触发场景：workflow 中存在 change_status: completed 的 change 需要归档收尾、知识沉淀、清理过时内容时。
构建一个一次性原型来回答设计问题。当用户想要快速验证某个状态模型或逻辑是否正确，或探索 UI 应该长什么样时使用。
创建、审计、合并或迁移 Speculo 的可复用 skill。用户要求新增 template/skills 能力、清理 SKILL.md、整合相似 skills、迁移外部 skill 或修复渐进披露时使用。
在指定 workflow 中撰写单个 work 入口文件（X-name/X-name.md）及其渐进披露子文件。用户指定 workflow 和 work 名称，要求新增 work、为已有 work 补充子文件、重构 work 步骤结构、优化完成标准、对齐主导词或修复 <Path> 指针时使用。
在指定 workflow 包中新增、审计或合并 work 入口。用户指定 workflow 名称（如 template/workflows/person）并要求新增具体 work、审计现有 work 的渐进披露结构、合并相似 work、基于参考材料生成 work 或对齐 <Path> 路径引用格式时使用。
在 Speculo workflow change 内创建隔离 git worktree 进行开发，完成后验证测试并合回基础分支。当用户要求隔离开发、开始实现、或实现完成后需要合并/清理时使用。与 specdev workflow 深度集成，worktree 持久化在 change 目录下的 .worktree/ 中。