用途
claude-code-usage 是一份 Claude Code 使用规范类技能，标记为 [AUTO-INVOKE]，要求在每次新的编码会话开始时必须调用。它用于统一 Claude Code 在编码过程中的上下文管理、任务拆解、提问方式与 Git 操作行为，并针对 Solidity / Foundry 项目给出专用工作流。
主要能力
1. 语言规则
始终使用用户所用的语言回复：用户用中文提问就用中文回答，用英文提问就用英文回答。
2. 上下文管理
- 一个窗口 = 一个任务：混合任务会污染上下文并降低输出质量。
- 优先使用 /clear 而非 /compact：干净重启比压缩上下文更可靠。
- 复杂任务后执行 /clear，防止旧上下文干扰新工作。
- 将关键信息复制到新窗口，不要依赖上下文持久化。
3. 任务执行策略
- 小型 bug 修复（几行）：直接描述，让 Claude 就地修改。
- 大型功能 / 重构：/plan → 审阅方案 → /clear → 粘贴方案 → 逐步执行。
- 多文件修改：必须使用 /plan 工作流，禁止在没有方案的情况下修改多个文件。
- 代码分析 / 学习：直接让 Claude 分析，无需方案。
- 调试：提供错误信息 + 文件路径 + 相关代码，并要求定位根因。
4. 提示词技巧
推荐做法：给出具体路径（如“修改 src/MyToken.sol 中的 _transfer 函数”）；给出示例（如“输入 100 代币，5% 手续费后期望 95 代币”）；设定边界（如“只修改这个函数，不要动其他代码”）；引用测试（如“修复后应让 test_transfer_feeDeduction 通过”）。 应避免：模糊引用（“修改那个 transfer 函数”）、无约束的开放式请求（“让它更好”）、一条消息里包含多个不相关任务。
5. 歧义消解
当用户指令含糊、开放或存在多种解读时，不要猜测并继续，而应先分析并列出所有可能解读供用户确认。触发条件包括：未指定目标（“优化一下”）、范围不唯一（“加个检查”）、边界不清（“改一下权限”）、隐含上下文（“跟上次一样处理”）、可能性冲突（“处理一下安全问题”）。 分析维度：范围（哪些文件 / 合约 / 函数）、动作（新增 / 修改 / 删除 / 重构 / 修复）、技能匹配（每种解读对应哪个 /skill）、影响（可能的副作用）、约束（用户可能默认的隐含边界）。 输出格式为编号列表，列出每种解读的具体描述、涉及文件、关联 skill 与影响范围，并请用户确认选择哪种解读及是否有额外约束。 关键规则：绝不猜测；展示技能关联；用户确认后立即执行、不再追问；若对话历史已能消歧则跳过该流程直接执行。
6. 元提示（反向提示）
当 Claude 的回答不理想时，不要只是换个说法重试，而应使用元提示让 Claude 诊断差距，再带着完整上下文重新提问。四种提示类型：
- 诊断：回答错误或不完整时，问“我刚才的提问中缺少了哪些关键信息，导致你没能一次性给出正确答案？请逐条列出。”
- 重写：不知道如何改进问题时，请 Claude 重写问题并补全缺失上下文。
- 模板：为防止下次再犯，请 Claude 给出该类问题的提问模板。
- 预检：在开始写代码前，让 Claude 列出还需要用户提供的所有信息。 推荐流程：提问 → 回答不理想 → 诊断 → 重写 → 复制重写后的问题、/clear、粘贴发送。 核心原则：不要猜自己漏了什么，让 Claude 告诉你；一轮元提示可省去多轮试错。
7. 纠错后规则
每次纠正错误后，都要以“Update your CLAUDE.md so you won't make the same mistake again.”结尾，把经验固化到项目记忆中，避免后续会话重复犯错。
8. Git 操作规则
- 提交前始终运行 git diff 审阅改动。
- 只提交，不推送，除非明确要求。
- 绝不直接推送到 main/master 分支。
- 暂存指定文件，Solidity 项目中绝不使用 git add .（有提交 .env 的风险）。
9. Foundry 专用工作流
- 提交前：forge fmt && forge test
- 修改合约后：forge build 检查编译
- 提交 PR 前：forge test --gas-report 检查 gas 影响
- 调试失败测试：forge test --match-test <name> -vvvv 获取完整追踪
10. 快捷命令参考
- /clear：清空上下文，重新开始
- /plan：进入规划模式，先分析再修改
- /help：查看所有可用命令
- /compact：压缩上下文（建议优先用 /clear）
11. 项目级配置
在项目根目录创建 .claude/instructions.md 写入项目专属规则，Claude 会在每次对话开始时自动读取，无需手动加载。
使用方式
该技能为自动调用型，在每次新编码会话开始时触发。用户按上述规则组织提问、管理上下文并执行 Git 与 Foundry 命令即可。
适用场景
适用于使用 Claude Code 进行编码的会话，尤其是 Solidity / Foundry 智能合约项目的开发、调试、重构与提交。
限制
资料未提供该技能的安装方式、依赖要求、收费信息或平台支持范围，暂未提供。