skills-generator

用途：该技能面向想为 Claude 创建 Agent Skills 的人。Skill 是文件系统上的模块化包（核心为 SKILL.md），Claude 会按需发现并加载，以结构化指令注入扩展能力。核心视角是上下文工程：Claude 需要什么信息、何时加载、指令应留多少自由度。\n\n主要能力与原则：只补充 Claude 本来不知道的内容，逐段质疑 token 成本；用原因而非命令来解释（把 ALWAYS/NEVER 改写为对后果的推理）；描述要“略显激进”，显式列出上下文、边界情况与相近说法，以对抗默认触发不足；按任务脆弱程度匹配自由度，危险操作给精确脚本，判断类任务给原则；从示例中泛化，避免对少量测试用例过拟合。\n\n技能结构：skill-name/ 下含 SKILL.md（必需，YAML frontmatter 加少于 500 行指令）、scripts/（可选，确定性操作，可直接执行而不加载）、references/（可选，按需加载的领域文档）、assets/（可选，模板、字体、图标等产出物）。渐进式披露分三层：元数据（名称与描述）始终加载，约 100 token；SKILL.md 正文被触发时加载，少于 5k token；打包文件按需加载，不限量。\n\nfrontmatter 要求：name 为小写连字符标识，最长 64 字符，不得含 “anthropic”“claude”；description 最长 1024 字符，说明做什么、何时使用（文件类型、用户措辞、任务上下文）、仍应触发的边界情况、以及有歧义时明确不适用于什么，它是主要触发机制。\n\n创建流程：先从对话中提取意图，用户说“把它变成技能”时先挖掘工作流、工具、纠正与输出格式；只问无法推断的问题（技能要做什么、何时触发、期望输出、输出是否可客观验证）。再研究领域（最佳实践、工具、框架、常见失败模式、专家启发式、同类技能）。接着按顺序草拟正文：一句话定位、以决策点组织的核心工作流、用具体案例说明模式、边界情况、必要时指向打包文件，最后再写 frontmatter。随后做审查：token 审计、自由度校准、泛化性、是否在解释 Claude 已知内容、触发覆盖。再创建 2-3 个真实且杂乱的测试提示（如带错别字、含模糊路径与列号的请求），运行并评估是否触发、流程是否正确、输出质量与浪费步骤。最后迭代：从反馈中提炼原则而非打补丁，保持精简，把重复工作打包进 scripts/，多用重构而非增加 MUST。\n\n详细写作与描述优化见 references/writing-guide.md 与 references/description-guide.md。\n\n限制：资料未提供依赖、安装命令、价格、平台支持范围或运行环境要求，均为暂未提供。