Skills 系统

定义

Skills 是 AI Agent（如 Claude Code）的扩展机制——文件夹而非纯文本，可包含 Markdown 指令、脚本、资源数据等。Agent 在运行时根据 description 匹配和加载相关 Skill。

要点

• 九类 Skill：库参考、产品验证、数据分析、业务自动化、代码脚手架、代码质量、CI/CD、Runbook、基础设施运维
• 编写要诀：不陈述显而易见的、构建 Gotchas 章节、利用文件系统做 Progressive Disclosure〔待补〕
• description 字段是给模型看的触发条件，不是摘要
• 可通过 config.json 存储配置，通过 ${CLAUDE_PLUGIN_DATA} 持久存储数据
• 按需 Hook：仅在 Skill 调用时激活，会话结束后失效
• 可通过 Autoresearch 实现 Skills 的自动化迭代优化

示例

/careful Skill：调用时激活 PreToolUse hook，阻止 rm -rf、DROP TABLE、force-push 等危险命令。只在触碰生产环境时需要，平时不激活。

相关概念

• Autoresearch、自主迭代模式
• Progressive Disclosure〔待补〕
• Claude Code Skills 工程实践〔待补〕
• Claude Code 的 .claude 文件夹结构〔待补〕
• LLM Wiki〔待补〕 - Skills 是 LLM Wiki〔待补〕 Schema 层的具体实现形式
• Skill可迁移幻觉 - Skill 对模型能力存在隐性依赖，无法跨模型无缝迁移
• 渐进式披露 - Skills 文件递归引用是渐进式披露的具体实现
• Skill五种设计模式 - 7 个顶级 Skill 提炼的核心写作模式
• Skill借口反驳表 - 防止 LLM 在执行 Skill 时偷懒的核心武器
• 接力棒模式 - Skill 跨 session 长任务模式
• Skill精度阶梯〔待补〕 - L1/L1.5/L2 决定单个 Skill 的射程边界
• MCP - 与 Skills 互补：MCP 给能力，Skills 给"如何用"的程序性知识
• Fat Skills Thin Harness - Garry Tan 的个人 OS 架构，把 Skills 推到极致
• Skillify循环 - 用元 Skill 把每次手工执行压成可复用 Skill 的复利闭环
• 工具注册表 - Skills 之下的工具层 Resolver，跨 harness 涌现的基础原语
• 配对 Skill - knowledge 路由器 + unbook 流程的声明性/程序性双 Skill 模式
• 指令权威性梯度 - Skill 在七种指令机制中的定位：按需加载、低上下文成本

参考资料

• Thariq: Lessons from Building Claude Code Skills
• Claude Code Skills 文档