菜单
当用户提到'导出报告'、'export'、'生成报告'、'导出文档'、'输出报告'、'正式报告'、'归档'、'导出为'时，必须使用此技能。提供结构化报告导出能力：验证源报告→准备内容→格式转换→输出归档。支持复盘报告、洞察报告、总结报告等多种类型。不要手动拼接报告输出——本Skill封装了报告格式规范和frontmatter要求。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
当用户提到'CI检查'、'提交前检查'、'综合检查'、'ci-check'、'流水线检查'、'提交门禁'、'全量检查'、'跑一下CI'、'pre-commit'、'预检'、'检查所有'时，必须使用此技能。提供项目CI/CD综合检查能力，按标准流水线顺序执行10项核心检查：仓库合规→链接检查→Spec一致性→模式成熟度→文档生成→重复代码检测→阶段守卫日志→SG仪表盘→文件放置校验→.temp生命周期检查。提交前必跑，确保代码符合项目规范。不要手动逐个执行检查脚本——本Skill已按正确顺序编排，并处理了跨平台兼容（Windows用.ps1，Linux/Mac用.sh）。
当用户提到'链接检查'、'检查链接'、'断链'、'链接修复'、'fix links'、'check links'、'验证链接'、'死链'、'链接有效性'、'提交前检查'时，必须使用此技能。提供Markdown链接有效性检查与自动修复能力：本地文件引用验证、外部URL可达性检测、file:///绝对路径转相对路径、相对路径层级自动校正。不要手动查找断链——本Skill封装了缓存机制、并发检测、自动修复和dry-run预览，是提交前质量门禁的核心工具。
当用户提到'原子化收尾'、'finalize atomization'、'文档拆分完成'、'文件移动后处理'、'断链修复导航更新'、'一键收尾'、'重构完成后整理'时，必须使用此技能。原子化/文件移动/目录重构后的一键收尾工具：自动断链修复→导航表更新→Spec看板刷新→验证摘要。不要手动逐个执行后处理步骤——本Skill封装了正确的执行顺序和dry-run预览机制，是文档原子化工作流的标准最后一步。
当用户提到'萃取'、'extraction'、'模式沉淀'、'萃取模式'、'模式入库'、'沉淀为模式'、'可复用模式'、'更新模式库'、'生成模式文档'时，必须使用此技能。提供标准化的模式萃取流程：案例收集→本质抽象→结构化模板→反模式提炼→迁移验证→入库。不要手动组织萃取流程——本Skill封装了六步标准萃取法、反模式对等原则和可迁移性验证。替代旧的pattern-extraction-cmd（v1.0.0）。
当用户提到'知识图谱'、'knowledge graph'、'概念关系可视化'、'交互式知识图谱'、'节点关系网络'、'生成知识图谱'、'可视化知识库'、'概念网络'、'knowledge graph config'时，必须使用此技能。从结构化Markdown文档集（术语表/文档索引/时间线等）自动提取节点和关系，生成交互式vis-network HTML知识图谱。支持TOML声明式配置和Python API两种方式，内置节点去重、孤立节点检测、类型筛选、可信度分级显示。不要手动拼接vis-network代码——本Skill封装了表格解析、关系构建、HTML模板渲染和自包含输出，确保产出质量可预测。
当用户提到'mermaid'、'流程图'、'时序图'、'状态图'、'画个图'、'图表'、'架构图'、'思维导图'、'ER图'、'类图'、'甘特图'、'饼图'、'UML图'、'可视化流程'、'画流程图'、'mermaid图'、'可视化'、'流程可视化'时，必须使用此技能。提供标准化的Mermaid图表创建、检查、修复流程，引导完成从设计→编码→检查→修复→验证→交付的完整闭环。不要手写Mermaid代码绕过本Skill——本Skill封装了安全编码六规则、模板选择、自动检查修复流程，确保图表质量可预测。
| name | export-report-cmd |
| version | 1.3.0 |
| description | 当用户提到'导出报告'、'export'、'生成报告'、'导出文档'、'输出报告'、'正式报告'、'归档'、'导出为'时，必须使用此技能。提供结构化报告导出能力：验证源报告→准备内容→格式转换→输出归档。支持复盘报告、洞察报告、总结报告等多种类型。不要手动拼接报告输出——本Skill封装了报告格式规范和frontmatter要求。 |
| argument-hint | <报告类型：retrospective/insight/summary/custom> <源文件路径> |
| user-invocable | true |
| paths | [".agents/commands/export-report.md","docs/retrospective/reports/","rules/cmd-log-specification.md"] |
| title | Export-Report 导出报告命令 Skill |
| x-toml-ref | ../../../.meta/toml/.agents/skills/export-report-cmd/SKILL.toml |
⚠️ 本Skill是命令入口门面（L1索引层），遵循渐进式披露三层架构：
- L0：.agents/ONBOARDING.md（入口速查）
- L1：本文件（<500行，触发词+决策树+核心步骤+安全清单）
- L2：commands/export-report.md（完整流程）+ cmd-log-specification.md（日志规范）
export-report-cmd
提供结构化报告导出能力，完成"验证→转换→输出→归档"流程：
| 方案 | 推荐场景 | 优势 |
|---|---|---|
| Markdown导出 | ⭐ 默认导出格式 | 原生格式、版本控制友好、可继续编辑 |
| 结构化导出 | ⭐ 需要机器处理/数据分析 | JSON格式提取结构化数据 |
| 多格式导出 | 需要对外分享/正式发布 | 支持PDF/DOCX等（当前MD优先） |
核心功能：验证源报告完整性→提取元数据和内容→格式转换→生成目录索引→输出到指定目录。
为什么用本Skill而非手动输出？ 手动导出容易遗漏frontmatter、忘记更新索引、格式不符合归档规范；本Skill封装了报告验证、格式规范和目录更新流程，确保输出的报告符合项目标准。
当用户提到以下任何内容时触发：
关于触发：通常在 retrospective-cmd 或 insight-cmd 执行完成后使用，作为知识沉淀的最后一步。不是所有分析都需要正式导出——快速对话中的分析结论可以直接回复，只有需要归档沉淀时才使用本Skill。
需要导出报告？
├─ 报告用于项目内归档/版本控制？ → Markdown导出（默认，.md格式）
├─ 需要提取结构化数据做分析？ → JSON格式导出
├─ 需要对外分享/打印？ → 多格式导出（PDF/DOCX，需额外工具支持）
├─ 复盘报告导出？ → 放在 docs/retrospective/reports/ 对应分类目录
├─ 洞察/分析报告？ → 放在对应分类目录，更新索引README
└─ 不确定放哪里？ → 参考 docs/retrospective/reports/ 现有目录结构分类
决策前输出CMD_START日志（session前缀 exp-YYYYMMDD-<topic>）：
[CMD-LOG] | level=INFO | cmd=export-report | step=S0 | event=CMD_START | session=exp-... | msg=开始报告导出：<简述> | ctx={"source":"...","report_type":"retrospective/insight/summary"}
为什么决策前必须记录日志？ 报告导出涉及格式转换，导出类型错误会产生格式不正确的文档，CMD_START记录源和类型便于回溯。
与其他Skill的关系：
retrospective-cmd 或 insight-cmd 完成后调用atomization-cmd 原子化步骤1：读取 [commands/export-report.md](../../commands/export-report.md) 了解完整流程
步骤2：验证源报告：
- 源文件存在且内容完整
- frontmatter包含必要字段（id、date、type、source）
- 报告结构符合规范（标题层级、章节完整）
步骤3：准备导出内容：
- 提取元数据（标题、日期、类型）
- 整理正文内容
- 收集关联附件/图表
- 生成目录索引
步骤4：格式转换与输出：
- Markdown：直接复制到目标目录，确保路径引用正确
- JSON：提取结构化数据输出
步骤5：更新对应目录的README索引
步骤6：导出完成后运行 check-links.py 验证链接有效性
完整RACI矩阵、输入参数规范、约束条件见L2文档 commands/export-report.md。
为什么导出后必须运行链接检查？ 报告导出时文件路径会发生变化（源位置→归档目录），相对路径的层级深度随之改变，即使原始报告中所有链接都有效，位置迁移后也可能产生断链。断链在归档后很难被发现（浏览归档报告的人不会主动测试每个链接），而在导出步骤立即运行check-links.py可以在问题产生的第一时间修复，成本最低。
为什么frontmatter必须包含source溯源字段？ 归档报告是知识沉淀的最终形态，如果没有source字段记录报告来源（如哪次复盘、哪个对话、哪个事件），几个月后回看报告时无法追溯产生背景，也就无法验证结论在当前上下文是否仍然适用。source是报告的"出生证明"，确保知识可追溯、可验证、可更新。
执行导出报告命令集时，必须按 CMD-LOG规范 输出结构化日志：
cmd=export-report，session前缀 exprt-YYYYMMDD-<topic>SOURCE_INVALID、SOURCE_VALID、METADATA_EXTRACTED、FORMAT_CONVERT、CONVERT_FAILED、FILE_WRITTEN、INDEX_UPDATED、LINKS_CHECKED、BROKEN_LINKS完整字段说明、事件表格、日志示例见L2文档 cmd-log-specification.md §7.3。
为什么需要Gotchas？ 错误处理记录"已知错误码及修复方式"，Gotchas记录"容易踩的坑、反直觉行为、容易被忽略的约束条件"——不会产生明确错误码但会导致结果不符合预期的隐性陷阱。
.agents/skills/xxx/到docs/retrospective/reports/yyy/），原来有效的../链接会全部失效。导出步骤完成后第一时间运行链接检查，此时修复成本最低。docs/retrospective/reports/下已有的目录结构。新增分类会破坏索引一致性，导致后续归档和检索混乱。确需新分类时先在团队内达成共识。../层数必须相应调整。例如源文件在根目录使用docs/xxx.md，导出到docs/reports/后需要改为../xxx.md。这也是导出后必须运行链接检查的核心原因。| 参考 | 层级 | 路径 | 何时查阅 |
|---|---|---|---|
| 完整命令文档（RACI/参数/约束） | L2 | commands/export-report.md | 每次使用必读 |
| CMD-LOG日志规范 | L2 | cmd-log-specification.md | 日志格式、事件定义、解析方法 |
| 报告目录分类 | L2 | docs/retrospective/reports/README.md | 确定输出位置和分类 |
| 导出四通道渐进模式 | L2 | export-four-channel-progressive.md | 理解导出策略 |
| 链接验证脚本 | L1工具 | check-links.py | 导出后验证 |