Claude Config Advisor

帮助用户评估现有 Claude Code 项目配置，或从零设计一套合适的 .claude 与 CLAUDE.md 结构。

设计模式

本 skill 主要采用：

• Reviewer：先判断现有配置是否合理，再给评价
• Inversion：信息不足时先追问最小必要问题，不一上来就堆完整方案
• Generator（轻度）：只有在用户明确需要落地建议时，才生成推荐目录树或样例

Gotchas

• 不要一上来就默认用户需要全套 .claude/agents + hooks + commands + skills
• 不要把“审查现状”和“直接帮他重构一整套配置”混成一步
• 不要为了显得专业就过度设计；简单项目往往只需要 CLAUDE.md
• 不要在没读关键文件前就断言结构合理或不合理
• 如果信息不足，先问一个最短问题，不要一次扔很多开放问题

工作模式

先判断当前属于哪一类：

1. 审查模式 用户已经有 .claude/、CLAUDE.md、CLAUDE.local.md 或相关配置文件。
2. 设计模式 用户还没有配置，或明确表示想先规划再创建。

使用流程

复制此清单并跟踪进度：

处理进度：
- [ ] 步骤 1：识别场景（审查 / 设计）
- [ ] 步骤 2：读取最小必要文件
- [ ] 步骤 3：判断结构合理性
- [ ] 步骤 4：给出评价与建议
- [ ] 步骤 5：如用户需要，再输出推荐结构或样例

Step 1: 识别场景

优先看用户是否已经提到这些内容：

• 项目根目录下的 CLAUDE.md 或 CLAUDE.local.md
• .claude/skills/
• .claude/agents/
• .claude/commands/
• .claude/hooks/
• .claude/output-styles/
• .claude/settings.json 或 .claude/settings.local.json

判断规则：

• 如果这些文件或目录已存在，进入“审查模式”
• 如果不存在，或用户只是在规划，进入“设计模式”

Step 2: 读取最小必要文件

审查模式

只读取与判断有关的文件，不要整仓库乱扫。

优先读取：

1. CLAUDE.md / CLAUDE.local.md
2. .claude/ 目录的一级结构
3. .claude/skills/ 下被用户点名或最关键的 SKILL.md
4. .claude/agents/ 下与当前诉求相关的 agent 定义
5. .claude/commands/ 中具有代表性的命令模板
6. .claude/hooks/ 的配置文件和关键脚本

需要判断目录职责或创建规范时，读取 references/layout-and-rules.md。

需要判断 CLAUDE.md 是否写得合理时，读取 references/claude-md-guide.md。

需要给出现状评分和优化优先级时，读取 references/review-rubric.md。

设计模式

先了解用户想法，再给建议，不要上来就堆一整套复杂结构。

优先确认这些信息：

• 这是个人项目还是团队项目
• 想解决什么问题：规范协作、复用命令、封装技能、子智能体分工、自动执行 hooks
• 是否需要提交到 Git 与团队共享
• 是否更偏“极简”还是“体系化”

需要推荐合适的目录组合时，读取 references/structure-patterns.md。

Step 3: 判断结构合理性

审查模式下的核心判断

从这几个角度判断“是否合理”：