🪴 小胖的数字花园

Skills

5分钟阅读

Skills

和 MCP,一个是工具的提供，一个是教 claude 怎么使用工具

同时渐进性加载 skill，节省很多 token

如何写skill

Claude Code的AskUserQuestion工具。 以后写Skill可以用上

官方的 create-skill 可以用

Skills 设计模式

详细内容参见 Claude Code 工程实践手册

制作 Skills 的核心技巧
· 不陈述显而易见：聚焦 AI Agents 默认认知之外的信息（如设计品味、内部 footguns）
· 构建 Gotchas 专区：持续迭代，记录 AI Agents 常见失败点——这是最高价值内容
· 利用文件系统：文件夹即上下文；拆分 references/api.md、assets/template.md，实现渐进披露
· 避免过度约束：给灵活性，让 AI Agents 适应场景
· Setup 与内存：用 config.json 存用户配置；日志/数据库实现自记忆（稳定路径用 ${CLAUDE_PLUGIN_DATA}）
· 脚本优先：提供 helper 函数库，让 AI Agents 专注组合而非重写 boilerplate
· 按需钩子：如 /careful 阻塞危险命令，仅在必要时激活。
描述字段技巧：写给模型看的“触发条件”，而非用户摘要

Skill 三种类型

Type 1: Checklist (质量门)

---
name: release-check
description: 发布前验证构建、版本和冒烟测试
---
## 预检查 (全部必须通过)
- [ ] `cargo build --release` 通过
- [ ] `cargo clippy -- -D warnings` 清洁
- [ ] Cargo.toml 版本已更新

Type 2: Workflow (标准化操作)

---
name: config-migration
description: 迁移配置模式,仅在明确请求时运行
disable-model-invocation: true
---
## 步骤
1. 备份: `cp config.toml config.toml.bak`
2. Dry run: `kaku config migrate --dry-run`
3. 应用: 确认输出后移除 --dry-run
4. 验证: `kaku doctor` 全部通过

Type 3: Domain Expert (封装决策框架)

---
name: runtime-diagnosis
description: kaku 崩溃、挂起或运行时异常行为时使用
---
## 证据收集
1. 运行 `kaku doctor` 捕获完整输出
2. `~/.local/share/kaku/logs/` 最后 50 行
3. 插件状态: `kaku --list-plugins`

Progressive Disclosure 模式

.claude/skills/
└── incident-triage/
    ├── SKILL.md         # 任务语义、边界、执行骨架
    ├── runbook.md       # 领域细节
    ├── examples.md      # 示例
    └── scripts/
        └── collect-context.sh

Skill 描述优化

  • 低频 (<1次/月) → 移除 skill,在 AGENTS.md 中记录
  • 描述太短: description: help with backend (几乎触发所有后端任务)
  • 主体太长: 数百行手动内容塞进 SKILL.md
  • 一个 skill 覆盖 5 件事 → review, deploy, debug, docs, incident

值得关注的资源

官方资源（首选）

anthropics/skills

  • GitHub: https://github.com/anthropics/skills
  • 45k+ stars
  • Anthropic官方Skills仓库
  • 包含：文档处理Skills（docx/pdf/pptx/xlsx）、示例Skills、规范文档
  • 推荐理由：官方维护，安全可靠，是学习Skills的最佳起点

agentskills.io

  • Agent Skills开放标准规范
  • 完整的技术规范文档
  • 推荐理由：想深入理解Skills架构的必读

官方文档

社区资源（审查后使用）

obra/superpowers ⭐ 推荐

  • GitHub: https://github.com/obra/superpowers
  • 29k+ stars
  • 一套完整的开发工作流Skills
  • 包含：TDD、调试、代码审查、计划执行等
  • 推荐理由：社区口碑最好的Skills库，设计理念先进

awesome-claude-skills

  • 多个版本：travisvn/awesome-claude-skills（5k+ stars）等
  • 社区Skills资源汇总
  • 使用建议：作为发现资源的索引，具体Skills需审查后使用

使用建议

  1. 优先用官方：Anthropic的Skills经过充分测试
  2. 社区精选：obra/superpowers质量高，可以用
  3. 其他第三方：审查代码后再用
  4. 最好自己写：针对自己的工作流定制

关系图谱

反向链接