技能创建器

要解决什么问题

通用大模型能对话，但重复性领域流程（查表、跑脚本、按规范出稿）每次都要重新讲一遍，上下文也容易膨胀。Skill 是「写一次、Agent 自动识别调用」的能力包；本技能面向从零设计或迭代这类包的人，而不是单次 Prompt 调优。

它和 MCP、Prompt 的分工在资料里写得很直白：Skill 管怎么干（知识 + 流程），MCP 管能不能连（工具接口），Prompt 管当下这一句。若你把 Skill 当成加长版系统提示而不拆 scripts/、references/、assets/，后面很难维护，也难让模型按需加载。

技能如何工作

流程按六步推进，且强调 Research First：动笔前先搜目标领域的最佳实践与反模式，再用具象用例界定范围（建议写一段 Scope Statement，明确做与不做）。

• 规划可复用内容：从用例反推是否需要 scripts/（可执行逻辑）、references/（按需读的文档）、assets/（模板/图片等产出物，不必进上下文）。
• 初始化：必须用 init_skill.py 在用户目录（如 ~/.qclaw/skills）建骨架，禁止手写目录结构，避免技能被应用更新覆盖。
• 编辑与渐进披露：SKILL.md 保持精简（建议 <500 行），变体细节放到 references/ 并由正文说明何时读取；复杂 Skill 可把主编排写在 SKILL.md，具体实现交给 Subagent。
• 打包与迭代：package_skill.py 后根据真实使用改结构，避免 SKILL.md 与 references 重复堆砌。

复杂场景可参考技能内提到的 references/workflows.md、references/output-patterns.md 等模式。

适用边界与注意点

• 技能包不应附带 README、安装指南、CHANGELOG 等面向人的杂文档，只保留 Agent 执行任务所需文件。
• 引用文件尽量一层从 SKILL.md 链出，长文 references 建议加目录，方便模型预览再决定是否加载。
• 本技能讲的是创作规范与流程，不替代具体业务领域的领域知识；Subagent 编排时，SKILL.md 负责「何时调谁」，不负责替 Subagent 写实现细节。