skill-design-philosophy

技能设计理念

技能提供的是知识和上下文，而不是自主执行能力。

知识测试

请问：“这是在教 Claude，还是在替它做事？”

教（技能）	做（Agent）
编码规范	运行代码检查工具并修复代码
工作流方法	执行多步骤流程
框架模式	生成报告
工具使用指南	获取并分析数据

**规则：**如果它能在没有用户指导的情况下生成产物，那它很可能是一个 Agent。

良好的技能示例

技能	有效原因
dhh-coder	编码风格指南——Claude 编写代码时会应用这些模式
tdd-workflow	方法论知识——Claude 进行测试驱动开发时会遵循这些步骤
stimulus-coder	框架模式——Claude 编写 Stimulus 控制器时会使用这些规范
pdf-processing	工具知识——如何使用特定库和脚本

**模式：**技能向 Claude 传授模式、规范和方法。

不良技能示例

技能	不适用原因
“代码审查员”	会自主执行任务——应该是一个 Agent
“Git 助手”	范围模糊——具体要教什么？
“最佳实践”	范围过宽——无法付诸行动
“文档生成器”	会创建产物——应该是一个 Agent

**模式：**这些技能是在做事，而不是在教 Claude 做事。

内容规则

包含	排除
具体模式和规范	人设描述（“你是一位专家……”）
特定模板和示例	归属说明（“受 X 启发……”）
决策标准	装饰性引言
错误处理指南	ASCII 艺术字或框线字符
特定于框架的惯用写法	含糊的“最佳实践”

质量测试

“这项技能中的每一行是否都能改善 Claude 的表现？”

如果有任何一行只是装饰、鼓舞人心或重复冗余，就删掉它。