haojing8312/workclaw/skill-creator

创建技能

目标

• 设计或迭代一个技能，确保触发准确、说明精炼、资源可复用、结果可验证。

工作流

1. 先建立任务计划

• 在开始连续执行前，先调用 todo_write 建立任务计划。
• 计划至少包含：
• 判断是否需要新建技能
• 明确触发场景与边界
• 设计资源与结构
• 起草或更新 SKILL.md
• 轻量评测与修正
• 返回结果与建议
• 每当阶段推进时，都要更新 todo_write 状态。

1. 先判断是否真的需要新建技能；若已有技能可覆盖，优先复用或补强，而不是重复造一个近似技能。
2. 明确目标使用场景、边界和触发信号，至少写出 3 类内容：触发示例、非触发示例、容易混淆的相邻场景。
3. 定义最小必需资源（scripts/、references/、assets/），只保留会被重复使用或显著提升可靠性的内容。
4. 起草或更新 SKILL.md，默认 frontmatter 保留 name 和 description；仅在确有必要时再增加 allowed_tools、context、agent、mcp-servers 等高级字段。
5. 保持指令简洁、面向执行，重点写“何时用”和“怎么做”，不要堆背景知识。
6. 做轻量评测：至少准备 3 条应触发提示词和 3 条不应触发提示词，检查是否有误触发或漏触发。
7. 根据评测结果迭代 description、章节结构和示例，直到触发边界清晰。

触发设计

• description 要同时覆盖“做什么”和“什么时候用”，让模型能靠关键词和场景命中。
• 触发示例要贴近真实用户说法，而不是作者视角的解释。
• 非触发示例要覆盖最容易误判到这个技能的相邻任务。
• 如果技能支持多种变体，主体只保留选择规则，细节放到 references/。

轻量评测

• 触发示例：用户说了什么时，这个技能应该被调用。
• 非触发示例：哪些请求看起来相近，但其实不该调用这个技能。
• 误触发：不该进这个技能却进了，通常说明 description 太泛。
• 漏触发：该进这个技能却没进，通常说明关键词或场景覆盖不够。

质量检查清单

• 是否先判断了复用已有技能，而不是默认新建。
• 描述是否清楚说明技能做什么、何时使用，并便于被发现。
• 是否同时给出触发示例与非触发示例。
• 工作流步骤是否可执行且顺序合理。
• 内容是否避免无关上下文膨胀。
• 引用与资源是否只在必要时提供。
• 是否完成了轻量评测，并根据误触发/漏触发做过调整。