Skill 六步拆解方法与精简报告规范

1. 内部分析规则

先完整读取主 SKILL.md，再按需读取会影响行为、交付或验收的参考文件、脚本、配置和测试。脚本要看实际输入、输出、外部改变和失败方式，不能只根据文件名猜用途。

分析时在内部区分文件明确写出的内容、根据流程得到的解释，以及文件没有说明的内容。这种区分用于提高判断准确度，不要把它变成报告里的证据账本。

最终报告直接表达结论：

不复制原文或逐段批注；
不列已读文件、提交版本、证据编号或行号；
不写“原文明确写出”“根据文件推断”等标签；
信息不足时只在相关章节简短说明“这个 Skill 没有说明……”。

2. 看交付

回答四个问题：

必须提供什么输入？
最终结果是对话、文件、代码修改、外部状态，还是一组后续动作？
结果怎样交给用户，会不会产生费用或外部改变？
哪些可以观察到的条件代表完成？

先写一句转换定义：

这个 Skill 把【输入】变成【结果】，在【完成条件】满足时完成。

完成条件没有说明时，直接指出，不要自行补一个。

3. 看动作

从命令句、判断条件、脚本入口和检查流程中找动作，纳入读取、判断、生成、检查、分支、循环、重试和停止。

先给一条短动作链：

定位输入 → 读取材料 → 作出判断 → 生成结果 → 检查 → 交付

再解释关键节点读取什么、依据什么、产生什么。避免“全面分析”“智能处理”这类看不出实际动作的说法。

4. 看顺序

只解释真正影响结果的顺序：

两步交换后，后一步是否缺少输入、标准、权限或安全前提？
删除某一步后，会出现什么具体错误或退化？
这个顺序属于信息依赖、评价标准、安全门槛，还是反馈循环？

使用直白句式：

先做【A】，是因为【B】需要它的结果；如果交换或删除，就会【具体后果】。

可以交换的步骤如实说明，不要为目录顺序强行编原因。

5. 看分工

常见角色包括：

用户：提供目标、做价值选择、授权高影响动作和验收结果。
AI：理解意思、比较方案、处理模糊情况和作出取舍。
脚本或确定性工具：计算、解析、格式化、验证和重复执行。
外部资料或服务：补充新事实或改变外部系统中的状态。
运行平台：提供文件、权限、触发和交付通道。

以目标 Skill 的实际设计为准，不要强行补齐不存在的角色。复杂流程可以使用紧凑责任表：

环节	谁执行	做什么	谁验收

区分“谁执行动作”和“谁对结果负责”。

6. 看约束

寻找“必须、不要、只能、始终、先、检查、验证、失败则停止、需要批准”等强制表达，以及脚本里的校验和失败分支。

对每条重要规则追问：去掉后最容易发生什么具体问题？它保护的是正确性、安全性、一致性、可恢复性、成本，还是用户控制权？

用紧凑表格直接说明：

规则	它在避免什么问题

不单列漏洞审计或改进方案；这里只解释现有规则的作用。

7. 看可复用做法

去掉工具名、文件名、任务名和领域专名。
用功能角色替代专名，例如把具体脚本写成“自动检查工具”。
写清适用情况、具体动作、所防问题和成立条件。
检查它能否用于另一个领域，并说明不适用边界。

使用句式：

当【适用情况】时，可以【具体动作】，这样能避免【问题】；前提是【成立条件】。

保留 2–5 条真正有用的做法，不写口号。

8. 精简报告模板

# 【Skill 名称】拆解报告

## 1. 这个 Skill 最后要交付什么

【一句话转换定义；再用一小段说明交付方式、完成条件和必要边界】

## 2. 它具体做了哪些事情

**动作链：** 【A → B → C → D】

【只解释关键动作和分支】

## 3. 为什么要按这个顺序做

【解释关键依赖，并给出交换或删除步骤后的具体后果】

## 4. 用户、AI、脚本和外部工具各负责什么

【短段落或紧凑责任表】

## 5. 这些规则是在避免什么问题

【短列表或“规则—问题”表格】

## 6. 哪些做法可以用到其他任务中

【2–5 条包含适用情况、动作、所防问题和前提的做法】

报告到第六章结束，不追加证据范围、相关文件简介、问题建议或其他章节。

9. 报告生成器

使用 scripts/render_report.py 检查并保存报告。

准备一个只含六章正文的 analysis.md，然后运行：

python3 scripts/render_report.py \
  --analysis /path/to/analysis.md \
  --title target-skill-name \
  --output reports/target-skill-name-拆解报告.md

生成器会检查：

六章标题准确、顺序正确、内容非空；
没有额外的二级章节；
没有旧版的第一部分、原文批注、证据标签、源码行号或第七章；
默认总长度不超过 4500 个字符；
输出直接位于当前工作区的 reports/，且不覆盖旧文件。

只有用户明确要求详细版时，才提高 --max-chars；仍然保持六章结构。

10. 质量检查

直接：先说结论，不展示取证过程。
简洁：默认 1500–3000 个中文字符，没有重复段落。
完整：交付、动作、顺序、分工、约束和可复用做法都回答到。
具体：动作可观察，顺序有因果，规则对应具体问题。
通俗：术语首次出现有解释，不要求读者懂代码。
克制：没有原文、批注、证据引用、第七章或额外审计清单。
安全：没有执行目标工作流，也没有把未验证声明写成实际能力。
可下载：报告保存在 reports/，旧报告没有被覆盖。

FilesExpand file tree

six-step-method.md

Latest commit

History