企业官网建设流程全解析

1.Skill 描述（Description）的精准性

这是最关键的部分——决定 Claude 是否会在正确时机触发这个 skill。

• 触发条件要具体：列举明确的用户意图、关键词、文件类型
• 反向排除：用 “Do NOT use when…” 避免误触发
• 覆盖同义表达：用户可能用不同方式表达同一需求（“Word文档”、“docx”、“正式报告”）

2.SKILL.md 的内容结构

• 环境约束：可用的库、工具版本、路径规范（这是最容易踩坑的地方）
• 分步骤的操作指南：不假设 Claude 已知细节，把每个步骤写明
• 输出路径规范：文件放哪里、如何命名
• 错误处理：常见失败场景和解决方案

3.可验证的输出标准

• 明确定义"好的输出"长什么样
• 提供正面示例（和负面示例）
• 指定格式、风格、质量检查点

4.单一职责原则

• 一个 skill 解决一类问题，不要试图覆盖所有情况
• 过于宽泛的 skill 会降低质量，过于细碎则维护成本高

5.与其他 Skills 的边界划分

• 在描述中明确与相邻 skill 的区别（如pdfvspdf-reading）
• 避免描述重叠导致 Claude 不知道选哪个

6.实际测试与迭代

• 用真实用户 prompt 测试触发率
• 检查误触发（不该用时用了）和漏触发（该用时没用）
• 根据失败案例修订描述和内容

一个快速自检清单