用途
Best Practices 是一个提示词转换技能，用于把模糊的提示词转化为经过优化的 Claude Code 提示词。它通过补充 Claude 成功完成任务所需的信息来改进提示词，调用方式为 /best-practices。
主要能力
技能围绕五大转换原则工作，按优先级排序：
-
添加验证（最高优先级）：为提示词补充成功标准，例如测试用例与预期输入输出、UI 变更的截图对比、Bug 修复的失败测试、构建问题的构建成功验证、重构的测试套件运行，以及要求“解决根因，不要抑制错误”和输出验证报告。
-
提供具体上下文：用精确位置和细节替换模糊引用，例如把“the code”替换为 src/auth/login.ts，把“the bug”替换为“用户报告在 Y 情况下发生 X”。提供四种添加上下文的方式：限定任务范围、指向来源、引用模式、描述症状。同时要求尊重项目 CLAUDE.md 中的约定。
-
添加约束：告诉 Claude 不要做什么，防止过度工程和不需要的改动。约束类型包括依赖、测试、范围、方法和模式。
-
分阶段处理复杂任务：对较大任务分离探索与实现，采用四阶段模式——探索、计划、实现、提交。当不确定方法、改动涉及多个文件或不熟悉被修改代码时使用分阶段；当能用一句话描述差异、修复拼写错误、添加日志行或重命名变量时可跳过。
-
包含丰富内容：提供 Claude 可直接使用的支持材料，包括文件（用 @filename 引用）、图片（直接粘贴截图）、错误（粘贴实际错误信息而非描述）、日志（用 cat error.log | claude 管道传入）、URL（链接到相关文档）。
使用方式
技能提供两种模式，通过 AskUserQuestion 询问用户选择：
- 直接转换：立即应用五大原则并输出改进后的提示词。
- 先构建上下文：使用 Task 工具并行启动三个智能体——task-intent-analyzer（分析意图、缺口和边界情况）、best-practices-referencer（从 references/ 中查找相关示例和模式）、codebase-context-builder（探索当前代码库中的文件和约定）。智能体返回后，综合发现、应用匹配模式、结合代码库上下文，再应用五大原则转换提示词，并输出前后对比。
智能体定义位于 agents/ 目录：agents/task-intent-analyzer.md、agents/best-practices-referencer.md、agents/codebase-context-builder.md。
转换工作流：识别缺失内容（对照五大原则检查）→ 添加缺失元素（验证、上下文、约束、阶段、丰富内容）→ 在代码块中输出改进后的提示词（可直接复制粘贴）→ 展示前后变化对比。
输出格式包含：原始提示词、改进后的提示词（代码块）、添加的内容列表。
适用场景
技能文档提供了多种快速转换示例，覆盖：Bug 修复、功能实现、重构、测试、调试、UI 变更、探索、迁移、带验证报告的修复。
限制与检查
技能附带转换清单，输出前需确认改进后的提示词包含：验证、位置、约束、单一任务、阶段（如复杂）、根因（针对 Bug）、CLAUDE.md 约定。
还提供提示词质量快速检查，按验证、位置、约束、范围四个维度评分（0-2 分），总分 0-3 需大量改进，4-5 需部分改进，6-8 良好。
若用户选择“直接转换”但提示词上下文不足，技能会问一个自然问题：“Claude 需要知道什么才能做好这件事？”只问一个问题，然后用获得的信息进行转换。
技能还列出常见反模式及修复方式，并提供成功标准评估表，按五大原则逐项检查通过/失败。整体质量评分从一星到五星，目标为每个转换后的提示词达到四星或五星。
参考文件
技能引用以下参考文件：references/before-after-examples.md（50+ 示例）、references/prompt-patterns.md（提示词模板）、references/common-workflows.md（任务工作流）、references/anti-patterns.md（应避免的内容）、references/best-practices-guide.md（官方指南）。
来源
文档列出来源：Best Practices for Claude Code 官方文档、Claude Code Skills 技能编写指南、Anthropic Prompt Engineering 通用提示模式、Dicklesworthstone meta_skill 的“THE EXACT PROMPT”模式。
关于收费、价格、平台支持范围等具体信息，资料中暂未提供。