creating-skill-pro

name	creating-skill-pro
description	设计、改造、融合和验证 Agent skills，在需要梳理策略框架、重构 SKILL.md 结构、规划 `references/` 与 `scripts/` 分层、建立评测、优化 description 或排查触发问题时使用。适用于“帮我做一个 skill”、“重写或合并这个 skill”、“给 skill 做评测”、“为什么这个 skill 没触发”等请求。

Creating Skill

本 skill 用于设计、改造和验证 Agent skill。默认先判断任务性质、产物和边界，再按需读取 references/ 或调用 scripts/，不默认把所有请求推进到完整闭环。

定位与适用任务

• 从零设计新 skill，或把一套工作方式沉淀成 skill
• 重写、分层、融合或重构已有 skill
• 为 skill 设计评测、baseline、回归检查或结果展示
• 优化 description、触发边界或排查为什么没触发
• 如果只是普通文案修改、普通脚本分析或单次交付，不要误用为 skill 创建流程

设计哲学

激发模型能力上限 = 策略哲学 + 最小完备工具集 + 必要事实说明

策略哲学

• 写思考框架，不写唯一路径
• 先判断当前任务是开放式设计问题、确定性执行问题还是验证问题
• 只有当 workflow 能显著降低风险时才引入它；不要把 workflow 当顶层默认范式
• 高自由度任务必须保留重规划空间，不能被固定流程吞掉

最小完备工具集

• 顶层 SKILL.md 只放定位、判断框架、边界和资源入口
• references/ 提供按需细节，不默认全读
• scripts/ 承接重复、确定性、易错的动作
• agents/、assets/、eval-viewer/ 是可选能力层，不是每次都要启用

必要事实说明

• 事实说明提供推理原料，例如结构约束、环境前提、触发边界和兼容要求
• 不要把经验偏好伪装成硬规则；事实说明负责校准判断，不负责替模型决策
• 当事实边界不完整时，优先补信息，再决定是否进入 workflow 或校验流程

工作原则

先提取上下文，再补问题

• 如果当前对话里已经包含 workflow、工具链、用户纠偏、输入输出样例或约束，先从现有上下文提取
• 只有当关键信息仍缺失时，再补问题，不要让用户重复已经说过的话
• 提问题时优先补这几类空白：触发时机、输出格式、边界、依赖资源、是否需要评测

token 是共享资源

• 顶层 SKILL.md 只保留路由、原则、关键决策和入口说明
• 长示例、schema、评测细节、大段领域知识放进 references/
• 重复、脆弱或需要确定性的逻辑优先做成 scripts/

沟通风格随用户熟悉度调整