常见问题 (FAQ)

基础

Q: Skill 和普通 Claude Code 对话有什么区别？

Skill 加载了特定领域的专业知识和工作流程。比如同样是审查代码，用 /review 会按「正确性→安全→性能→可维护性」的标准流程，而普通对话可能只关注你提到的那一方面。

Q: 一次可以用多个 Skill 吗？

不建议。Skill 会改变 Claude 的行为模式，同时使用会互相干扰。一次用一个，完成后再切换。

Q: Skill 会记住我之前的对话吗？

不会跨会话记住。每次触发 Skill 都是在当前会话上下文中运行。如果需要跨会话继续，用 /handoff 生成交接文档。

Q: 自定义 Skill 放哪里？

• 项目特有：.claude/skills/
• 全局通用：~/.claude/skills/

触发

Q: 为什么我说了触发词，Skill 没有激活？

可能原因：

1. 描述太模糊，和其他 Skill 的关键词重叠
2. 当前已有 Skill 在运行
3. 直接用 /skill-name 斜杠命令最可靠

Q: Skill 自动触发了但我不想用，怎么退出？

直接说「退出当前 Skill」或触发另一个 Skill。

Q: 如何避免误触发？

在 settings.json 中限制 Skill 的触发条件，或只用 /命令 方式触发。

效率

Q: Skill 会消耗更多 Token 吗？

每个 Skill 加载时会消耗一些 Token（Prompt 指令），但这部分是一次性的。后续 Skill 带来的效率提升远超这点成本。可以用 /caveman 模式进一步减少 Token。

Q: 哪个 Skill 最常用？

根据使用频率排序：

1. review — 每次变更后
2. diagnose — 出问题时
3. tdd — 写新功能时
4. simplify — review 之后

Q: 长会话中如何使用 Skill 管理上下文？

1. 用 caveman 减少对话 token
2. 完成一个阶段后用 handoff 交接，开启新会话
3. 用 loop 把定期检查放后台

自定义开发

Q: 怎么调试我写的 Skill？

1. 先用简单触发词测试能否激活
2. 用各种说法测试触发，确保不会误触
3. 检查输出格式是否符合预期
4. 观察是否会错误触发

Q: Skill 可以用外部 API 吗？

可以。Skill 可以使用 WebFetch 工具调用外部 API。需要读写数据库可以配置 MCP 工具。

Q: Skill 的 Prompt 多长合适？

• 简单 Skill: 20-50 行
• 中等 Skill: 50-150 行
• 复杂 Skill: 150-300 行
• 超过 300 行建议放 resources/ 目录

故障排查

Q: /diagnose 没找到问题怎么办？

提供更多信息：准确的错误消息、复现步骤、环境信息（OS、版本）。也可以尝试手动缩小范围后再次诊断。

Q: TDD 测试写不出来怎么办？

可能设计需要调整。容易测试的代码通常也是好设计的标志。也可以用 /prototype 先验证思路。

Q: PRD 生成的内容不准确？

PRD 从对话中提取信息，如果对话中信息不全，PRD 就会有遗漏。生成后务必人工 Review，补充业务上下文。