Getting Started with Skills

开始使用 Skills

你位于 ~/.claude/skills/ 的个人知识库，收录了经过验证的技巧、模式和工具。

如何引用 Skills

不要使用 @ 链接——它们会强制加载整个文件，瞬间消耗 200k+ 上下文。

应改用 skill 路径引用：

• 格式：skills/category/skill-name（不带 @ 前缀，也不带 /SKILL.md 后缀）
• 示例：skills/collaboration/brainstorming 或 skills/testing/test-driven-development
• 仅在需要时使用 Read 工具加载

在文档中看到 skill 引用时：

• skills/path/name → 使用 Read 工具读取 ~/.claude/skills/path/name/SKILL.md
• 仅在实施时加载辅助文件

强制工作流 1：任何任务开始前

1. 搜索 skills：

~/.claude/skills/getting-started/skills-search PATTERN

2. 搜索对话： 分派子 Agent（参见工作流 2），检查是否有相关的过往工作。

如果找到 skills：

1. 阅读该 skill：~/.claude/skills/path/skill-name/SKILL.md
2. 宣布使用：「我正在使用 [Skill Name] skill」
3. 遵循该 skill（其中许多包含严格要求）

「这不算任务」是自我开脱。 Skills 和对话都存在，而你没有搜索或使用它们＝任务失败。

强制工作流 2：搜索历史上下文

适用场景： 人类搭档提及过往工作、问题似曾相识、开始处理熟悉领域的任务、陷入困境／受阻、准备从头再造之前

不适用场景： 当前对话中已有相关信息、询问代码库状态、初次接触、搭档希望获得全新思路

操作方法（使用子 Agent 可节省 50–100 倍上下文）：

1. 使用模板分派子 Agent：~/.claude/skills/collaboration/remembering-conversations/tool/prompts/search-agent.md
2. 接收综合结果（200–1000 字）和来源指针
3. 应用其中的见解（绝不加载原始 .jsonl 文件）

示例：

Partner: "How did we handle auth errors in React Router?"
You: Searching past conversations...
[Dispatch subagent → 350-word synthesis]
[Apply without loading 50k tokens]

危险信号： 直接读取 .jsonl 文件、粘贴摘录、询问「是哪次对话？」、浏览归档

模式： 搜索 → 子 Agent 综合 → 应用。快速、聚焦且高效利用上下文。

宣布使用 Skill

每次开始使用 skill 时，都要宣布：

「我正在使用 [Skill Name] skill 来 [你正在做的事情]。」

示例：

• 「我正在使用 Brainstorming skill，将你的想法完善为设计方案。」
• 「我正在使用 Test-Driven Development skill，实现此功能。」
• 「我正在使用 Systematic Debugging skill，查找根本原因。」
• 「我正在使用 Refactoring Safely skill，提取这些方法。」

原因： 保持透明有助于人类搭档了解你的工作过程，并及早发现错误。

带检查清单的 Skills

如果某个 skill 包含检查清单，你必须为清单中的每一项创建 TodoWrite 待办事项。

不要：

• 只在脑中逐项完成检查清单
• 为了「节省时间」而跳过创建待办事项
• 将多个项目合并为一个待办事项
• 未完成就标记为完成

原因： 不使用 TodoWrite 跟踪的检查清单＝步骤总会被跳过。每次都是。

示例： TDD（编写测试、观察失败、实现、验证）、Systematic Debugging（4 个阶段）、Creating Skills（RED-GREEN-REFACTOR）

导航

说真的，先试试 skills-search。

类别： skills/INDEX.md → testing、debugging、coding、architecture、collaboration、meta 单个 skill： 从类别 INDEX 加载

如何阅读 Skill

1. Frontmatter——when_to_use 是否适用于你的情况？
2. 概览——是否有相关的核心原则？
3. 快速参考——查找符合你情况的模式
4. 实施——阅读完整细节
5. 辅助文件——仅在实施时加载

许多 skills 包含严格规则（TDD、调试、验证）。 请严格遵循，不要为了方便而削弱这些规范。

有些 skills 是灵活的模式（架构、命名）。 根据具体情况调整核心原则。

Skill 本身会说明它属于哪种类型。

在文档中引用技能

编写引用其他技能的文档时：

使用不带 @ 前缀或 /SKILL.md 后缀的路径格式：

• ✅ 正确：skills/testing/test-driven-development
• ✅ 正确：skills/debugging/systematic-debugging
• ❌ 错误：@skills/testing/test-driven-development/SKILL.md（会强制加载，消耗上下文）

为什么不使用 @ 链接：@ 语法会立即强制加载文件，在你需要之前就消耗 200k+ 上下文。

**读取技能引用：**使用 Read 工具读取 ~/.claude/skills/category/skill-name/SKILL.md

创建技能

发现了有价值的内容？请参阅 skills/meta/creating-skills

想要的技能不存在？请编辑 skills/REQUESTS.md（位于 ~/.claude/skills/REQUESTS.md）

总结

**开始对话？**你刚刚读完本指南。很好。

**开始任何任务？**先运行 skills-search，宣布将使用技能，然后遵循搜索结果。

**技能包含清单？**对每个项目使用 TodoWrite。

只要技能存在，就必须使用，而非可选。

最后一点

阅读本指南后，你的第一条回复中 MUST 向用户宣布你已阅读入门指南