Back to Details

improve-instructions

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Reference Files

参考文件

  • analysis-guide.md - Patterns to look for in conversations
  • examples.md - Example improvements with before/after
  • analysis-guide.md - 对话中需关注的模式
  • examples.md - 包含优化前后对比的示例

Improve Instructions

优化指令

Analyze conversation patterns to identify improvements for CLAUDE.md instruction files.
分析对话模式，找出CLAUDE.md指令文件的优化方向。

Objective

目标

Review how the conversation has gone to find opportunities where better instructions would have helped Claude perform more effectively.
回顾对话过程，寻找可通过更优指令帮助Claude更高效执行任务的机会。

Process

流程

Phase 1: Analyze Conversation

阶段1：分析对话

Review the conversation history for:
  • Repeated corrections - "No, I meant..." or "Remember to..."
  • Manual guidance - Workflows explained step-by-step that could be documented
  • Preference statements - "I prefer X" or "Always use Y"
  • Misunderstandings - Where Claude made wrong assumptions
  • Undocumented patterns - Tools or workflows used frequently
Track each potential improvement identified.
回顾对话历史，寻找以下内容：
  • 重复的修正内容 - 例如“不，我指的是...”或“记得要...”
  • 手动指导内容 - 可被文档化的分步工作流说明
  • 偏好声明 - 例如“我偏好X”或“始终使用Y”
  • 误解情况 - Claude做出错误假设的场景
  • 未记录的模式 - 频繁使用的工具或工作流
记录所有识别出的潜在优化点。

Phase 2: Review Current State

阶段2：回顾当前状态

Read the relevant CLAUDE.md file(s):
  • ~/.claude/CLAUDE.md
    for global instructions
  • Project-level 
    CLAUDE.md
    for project-specific instructions
Understand what's already documented to avoid duplication and identify gaps.
阅读相关的CLAUDE.md文件：
  • ~/.claude/CLAUDE.md
    为全局指令文件
  • 项目级 
    CLAUDE.md
    为项目专属指令文件
了解已记录的内容，避免重复并识别空白点。

Phase 3: Propose Improvements

阶段3：提出优化建议

Present findings to the user using AskUserQuestion:
For each improvement, explain:
  • Issue: What pattern was observed
  • Proposal: Specific text to add or change
  • Rationale: Why this would help
Group related improvements and let the user select which to implement.
使用AskUserQuestion向用户呈现发现结果：
对于每个优化点，需说明：
  • 问题：观察到的模式是什么
  • 建议：具体要添加或修改的文本内容
  • 理由：该优化为何能起到帮助作用
将相关优化点分组，让用户选择要实施的内容。

Phase 4: Implement

阶段4：实施优化

For each approved improvement:
  1. Use Edit to modify the appropriate CLAUDE.md
  2. Place new content in the logical section
  3. Maintain existing formatting and style
Summarize all changes made.
对于每个获批的优化点：
  1. 使用Edit功能修改对应的CLAUDE.md文件
  2. 将新内容放在逻辑合理的章节中
  3. 保持现有格式和风格
总结所有已完成的修改。

Guidelines

指导原则

  • Ground suggestions in actual conversation patterns, not hypotheticals
  • Prefer specific, actionable instructions over vague guidance
  • Keep instructions concise - Claude is smart, it doesn't need over-explanation
  • Preserve the user's existing voice and style
  • Don't add instructions for one-off situations
  • 建议需基于实际对话模式，而非假设情况
  • 优先选择具体、可执行的指令，而非模糊的指导
  • 保持指令简洁——Claude足够智能，无需过多解释
  • 保留用户现有的语气和风格
  • 不为一次性场景添加指令

Output

输出结果

End with a summary of:
  • Changes made to CLAUDE.md
  • Patterns identified but not yet addressed (for future consideration)
最后总结以下内容：
  • 对CLAUDE.md文件所做的修改
  • 已识别但尚未处理的模式（供未来参考）