Back to skills
extension
Category: OtherNo API key required

Skill Design Guide

创建或审查 Skill 前加载。指导将重复流程拆成可复用工作目录(SKILL.md + references/ + scripts/),而非长 Prompt。

personAuthor: user_49da3381hubcommunity

Skill 设计规范(创建前必读)

来源:姜饼《别再让 AI 自动总结 Skill 了!》 核心原则:Skill 不是长 Prompt,而是可复用的工作目录。

触发条件

当用户要求创建、修改或审查一个 Skill 时,加载本指南。

执行流程

  1. 确认触发场景

    • 问清楚用户在什么情况下需要这个 Skill
    • description 必须具体,不能是空泛宣传语
  2. 拆出固定流程

    • 写成顺序动作,只保留模型需要知道的路线
    • 太底层的细节,如果可以脚本化,不塞在流程里
  3. 移出材料到 references/*

    • 输出模板、风格偏好、配置说明、示例、字段说明、分类标准、术语表
    • 读取 references/responsibility-matrix.md 确认职责边界
  4. 脚本化稳定动作

    • 问三个问题:有明确规则?每次结果稳定?模型做反而容易出错?
    • 若答案是"是" → 放入 scripts/
    • 读取 references/workflow-guide.md 获取五步法详解
  5. 保留 AI 判断环节

    • 价值判断、归类、总结、改写、表达、处理模糊需求
  6. 对照自查清单

    • 读取 references/checklist.md,逐条确认
    • 若有疑问,阅读 references/faq.md

边界规则

  • SKILL.md 只写入口、流程和边界,不塞材料
  • 任务简单时可只写 SKILL.md;出现大量模板/配置/示例时必须拆分
  • 不要让 AI "把对话总结成 Skill",而是 "拆成 SKILL.md + references/ + scripts/"