# Claude Config Advisor

审查或设计 Claude Code 项目配置。用于用户提到 `.claude`、`CLAUDE.md`、Claude 配置文件、项目级 Claude...

- Repository: https://github.com/chujianyun/skills (750 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-15
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add chujianyun/skills --skill claude-config-advisor -g -a claude-code -y`
Codex: `npx skills add chujianyun/skills --skill claude-config-advisor -g -a codex -y`
Cursor: `npx skills add chujianyun/skills --skill claude-config-advisor -g -a cursor -y`
Gemini CLI: `npx skills add chujianyun/skills --skill claude-config-advisor -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add chujianyun/skills`

## Description

审查或设计 Claude Code 项目配置。用于用户提到 `.claude`、`CLAUDE.md`、Claude 配置文件、项目级 Claude 自定义配置、配置结构是否合理、该创建哪些配置文件，或希望从零规划 Claude 配置时使用。默认先审查或诊断，再给方案；只有用户明确要求时，才进一步输出推荐结构或样例文件。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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. **设计模式**
   用户还没有配置，或明确表示想先规划再创建。

## 使用流程

复制此清单并跟踪进度：

```text
处理进度：
- [ ] 步骤 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](references/layout-and-rules.md)。

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

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

#### 设计模式

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

优先确认这些信息：

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

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

### Step 3: 判断结构合理性

#### 审查模式下的核心判断

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

The rest: https://github.com/chujianyun/skills/blob/HEAD/skills/claude-config-advisor/SKILL.md