configure-ecc

Everything Claude Code（ECC）のセットアップ

Everything Claude Code プロジェクト用の、対話形式のステップバイステップインストールガイドです。AskUserQuestion を使って、スキル（Skills）とルール（Rules）を選択してインストールするようユーザーを案内し、正しくインストールされたことを検証して、最適化の提案を行います。

起動するタイミング

• ユーザーが「configure ecc」「install ecc」「setup everything claude code」または類似の指示をしたとき
• ユーザーがこのプロジェクトからスキル（Skills）やルール（Rules）を選択してインストールしたいとき
• ユーザーが既存の ECC インストールを検証または修復したいとき
• ユーザーがプロジェクト向けに、インストール済みのスキル（Skills）やルール（Rules）を最適化したいとき

前提条件

このスキル（Skill）は、起動前に Claude Code からアクセスできる必要があります。セットアップ方法は 2 つあります。

1. プラグイン経由：/plugin install everything-claude-code — プラグインによってこのスキルが自動的に読み込まれます
2. 手動セットアップ：このスキルのみを ~/.claude/skills/configure-ecc/SKILL.md にコピーし、「configure ecc」と言って起動します

---

ステップ 0：ECC リポジトリをクローンする

インストールを始める前に、最新の ECC ソースコードを /tmp にクローンします。

rm -rf /tmp/everything-claude-code
git clone https://github.com/affaan-m/everything-claude-code.git /tmp/everything-claude-code

以降のすべてのコピー操作のソースパスとして、ECC_ROOT=/tmp/everything-claude-code を設定します。

クローンに失敗した場合（ネットワークの問題など）は、AskUserQuestion を使って既存の ECC クローンのローカルパスをユーザーに尋ねます。

---

ステップ 1：インストール先を選択する

AskUserQuestion を使って、インストール先をユーザーに尋ねます。

问题："ECC 组件应该安装在哪里？"
选项：
  - "用户级 (~/.claude/)" —— "适用于你所有的 Claude Code 项目"
  - "项目级 (.claude/)" —— "仅适用于当前项目"
  - "两者皆有" —— "通用/共享项安装在用户级，项目特定项安装在项目级"

選択結果を INSTALL_LEVEL に保存します。インストール先ディレクトリを設定します。

• ユーザーレベル：TARGET=~/.claude
• プロジェクトレベル：TARGET=.claude（現在のプロジェクトのルートディレクトリからの相対パス）
• 両方：TARGET_USER=~/.claude、TARGET_PROJECT=.claude

インストール先ディレクトリが存在しない場合は、作成します。

mkdir -p $TARGET/skills $TARGET/rules

---

ステップ 2：スキル（Skills）を選択してインストールする

2a：範囲を選択する（コア vs ニッチ）

デフォルトは コア（Core、新規ユーザーにおすすめ） です。.agents/skills/* と skills/search-first/ をコピーし、調査を優先するワークフローをサポートします。このバンドルには、エンジニアリング、評価（Evals）、検証、セキュリティ、戦略的なコンテキスト圧縮、フロントエンド設計、および Anthropic の部門横断型スキル（記事執筆、コンテンツエンジン、市場調査、フロントエンドプレゼンテーション）が含まれています。

AskUserQuestion（単一選択）を使います。

问题："仅安装核心技能，还是包含小众/框架扩展包？"
选项：
  - "仅核心（推荐）" —— "tdd, e2e, evals, verification, research-first, security, frontend patterns, compacting, 跨职能 Anthropic 技能"
  - "核心 + 选定的小众技能" —— "在核心技能之后添加框架/领域特定技能"
  - "仅小众技能" —— "跳过核心，安装特定的框架/领域技能"
默认：仅核心

ユーザーがニッチなスキル、またはコア + ニッチなスキルを選択した場合は、以下のカテゴリ選択に進み、ユーザーが選択したニッチなスキルのみを含めます。

2b：スキルのカテゴリを選択する

27 個のスキルが 4 つのカテゴリに分類されています。AskUserQuestion を使い、multiSelect: true を設定します。

问题："你想安装哪些技能类别？"
选项：
  - "框架与语言" —— "Django, Spring Boot, Go, Python, Java, 前端, 后端模式"
  - "数据库" —— "PostgreSQL, ClickHouse, JPA/Hibernate 模式"
  - "工作流与质量" —— "TDD, 验证, 学习, 安全审查, 压缩"
  - "所有技能" —— "安装所有可用技能"

2c：個別のスキルを確認する

選択された各カテゴリについて、以下のスキル一覧全体を表示し、特定のスキルを選択するか、選択を解除するかをユーザーに確認します。一覧が 4 項目を超える場合は、一覧をテキストとして表示し、「一覧のすべての項目をインストールする」選択肢と、ユーザーが特定の名前を貼り付けるための「その他」選択肢を AskUserQuestion で提示します。

カテゴリ：フレームワークと言語（17 個のスキル）

スキル (Skill)	説明
backend-patterns	バックエンドアーキテクチャ、API 設計、Node.js/Express/Next.js のサーバーサイドのベストプラクティス
coding-standards	TypeScript、JavaScript、React、Node.js の汎用コード標準
django-patterns	Django アーキテクチャ、DRF を使った REST API、ORM、キャッシュ、シグナル、ミドルウェア
django-security	Django のセキュリティ：認証、CSRF、SQL インジェクション、XSS 対策
django-tdd	pytest-django、factory_boy、モック、カバレッジを使った Django のテスト
django-verification	Django の検証サイクル：マイグレーション、リンティング、テスト、セキュリティスキャン
frontend-patterns	React、Next.js、状態管理、パフォーマンス、UI パターン
frontend-slides	依存関係不要の HTML プレゼンテーション、スタイルのプレビュー、PPTX から Web への変換機能
golang-patterns	慣用的な Go のパターン、堅牢な Go アプリケーションを構築するための規約
golang-testing	Go のテスト：テーブル駆動テスト、サブテスト、ベンチマーク、ファジング
java-coding-standards	Spring Boot の Java コード標準：命名、不変性、Optional、ストリーム
python-patterns	Python らしい慣用句、PEP 8、型ヒント、ベストプラクティス
python-testing	TDD、フィクスチャ、モック、パラメーター化を含む、pytest を使った Python のテスト
springboot-patterns	Spring Boot アーキテクチャ、REST API、階層化サービス、キャッシュ、非同期処理
springboot-security	Spring Security：認証／認可、検証、CSRF、シークレット、レート制限
springboot-tdd	JUnit 5、Mockito、MockMvc、Testcontainers を使った Spring Boot の TDD
springboot-verification	Spring Boot の検証：ビルド、静的解析、テスト、セキュリティスキャン

カテゴリ：データベース（3 個のスキル）

スキル (Skill)	説明
clickhouse-io	ClickHouse のパターン、クエリ最適化、分析、データエンジニアリング
jpa-patterns	JPA/Hibernate のエンティティ設計、リレーション、クエリ最適化、トランザクション
postgres-patterns	PostgreSQL のクエリ最適化、スキーマ設計、インデックス、セキュリティ

カテゴリ：ワークフローと品質（8 個のスキル）

スキル (Skill)	説明
continuous-learning	セッションから再利用可能なパターンを、学習したスキルとして自動的に抽出します
continuous-learning-v2	確信度スコア付きのインスティンクトベースの学習。スキル／コマンド／エージェントへ発展できます
eval-harness	評価駆動開発（EDD）のための正式な評価フレームワーク
iterative-retrieval	サブエージェントのコンテキストに関する問題に対応する、段階的なコンテキストの絞り込み
security-review	セキュリティチェックリスト：認証、入力、シークレット、API、決済機能
strategic-compact	論理的な区切りで、手動によるコンテキスト圧縮を提案します
tdd-workflow	単体テスト、統合テスト、E2E テストを含む、カバレッジ 80% 以上の TDD を徹底します
verification-loop	検証と品質確認のサイクルパターン

カテゴリ：ビジネスとコンテンツ（5 個のスキル）

スキル (Skill)	説明
article-writing	ノート、例、またはソース文書を使い、指定されたトーンで長文を執筆します
content-engine	複数のプラットフォーム向けソーシャルコンテンツ、スクリプト、コンテンツ再利用のワークフロー
market-research	出典を明記した、市場、競合他社、ファンド、技術の調査
investor-materials	ピッチデッキ、概要資料、投資家向けメモ、財務モデル
investor-outreach	パーソナライズされた投資家向けコールドメール、ウォームイントロ、フォローアップメール

独立した項目

スキル (Skill)	説明
project-guidelines-example	プロジェクト固有のスキルを作成するためのテンプレート

2d：インストールを実行する

選択した各スキルについて、スキルディレクトリ全体をコピーします。

cp -r $ECC_ROOT/skills/<skill-name> $TARGET/skills/

注意：continuous-learning と continuous-learning-v2 には追加ファイル（config.json、hooks、scripts）が含まれています。SKILL.md だけでなく、ディレクトリ全体をコピーしてください。

---

步骤 3：选择并安装规则（Rules）

使用 AskUserQuestion 并设置 multiSelect: true：

问题："你想安装哪些规则集？"
选项：
  - "通用规则（推荐）" —— "与语言无关的原则：代码风格、git 工作流、测试、安全等（8 个文件）"
  - "TypeScript/JavaScript" —— "TS/JS 模式、Hooks、使用 Playwright 的测试（5 个文件）"
  - "Python" —— "Python 模式、pytest、black/ruff 格式化（5 个文件）"
  - "Go" —— "Go 模式、表格驱动测试、gofmt/staticcheck（5 个文件）"

执行安装：

# 通用规则（扁平复制到 rules/）
cp -r $ECC_ROOT/rules/common/* $TARGET/rules/

# 语言特定规则（扁平复制到 rules/）
cp -r $ECC_ROOT/rules/typescript/* $TARGET/rules/   # 如果选中
cp -r $ECC_ROOT/rules/python/* $TARGET/rules/        # 如果选中
cp -r $ECC_ROOT/rules/golang/* $TARGET/rules/        # 如果选中

重要提示：如果用户选择了任何语言特定规则但没有选择通用规则，请提醒他们：

"语言特定规则是对通用规则的扩展。在不安装通用规则的情况下安装可能会导致覆盖不完整。是否也安装通用规则？"

---

步骤 4：安装后验证

安装完成后，执行以下自动检查：

4a：验证文件是否存在

列出所有已安装的文件并确认它们存在于目标位置：

ls -la $TARGET/skills/
ls -la $TARGET/rules/

4b：检查路径引用

扫描所有已安装的 .md 文件中的路径引用：

grep -rn "~/.claude/" $TARGET/skills/ $TARGET/rules/
grep -rn "../common/" $TARGET/rules/
grep -rn "skills/" $TARGET/skills/

对于项目级安装，标记任何指向 ~/.claude/ 路径的引用：

• 如果一个技能引用了 ~/.claude/settings.json —— 这通常没问题（设置始终是用户级的）
• 如果一个技能引用了 ~/.claude/skills/ 或 ~/.claude/rules/ —— 如果仅安装在项目级，这可能会失效
• 如果一个技能通过名称引用了另一个技能 —— 检查被引用的技能是否也已安装

4c：检查技能间的交叉引用

某些技能会引用其他技能。验证这些依赖关系：

• django-tdd 可能会引用 django-patterns
• springboot-tdd 可能会引用 springboot-patterns
• continuous-learning-v2 引用了 ~/.claude/homunculus/ 目录
• python-testing 可能会引用 python-patterns
• golang-testing 可能会引用 golang-patterns
• 语言特定规则引用了 common/ 对应的规则

4d：报告问题

对于发现的每个问题，报告以下内容：

1. 文件：包含问题引用的文件
2. 行号：所在行号
3. 问题描述：哪里出错了（例如 "引用了 ~/.claude/skills/python-patterns 但 python-patterns 未安装"）
4. 建议修复方案：该怎么做（例如 "安装 python-patterns 技能" 或 "将路径更新为 .claude/skills/"）

---

步骤 5：优化已安装的文件（可选）

使用 AskUserQuestion：

问题："你想为你的项目优化已安装的文件吗？"
选项：
  - "优化技能（Skills）" —— "移除无关章节，调整路径，适配你的技术栈"
  - "优化规则（Rules）" —— "调整覆盖率目标，添加项目特定模式，自定义工具配置"
  - "优化两者" —— "对所有安装文件进行全面优化"
  - "跳过" —— "保持原样"

如果优化技能：

1. 读取每个已安装的 SKILL.md
2. 询问用户的项目技术栈（如果尚不清楚）
3. 对于每个技能，建议移除无关章节
4. 在安装目标位置（而非源码仓库）就地编辑 SKILL.md 文件
5. 修复步骤 4 中发现的任何路径问题

如果优化规则：

1. 读取每个已安装的规则 .md 文件
2. 询问用户的偏好：
   • 测试覆盖率目标（默认 80%）
   • 首选的格式化工具
   • Git 工作流惯例
   • 安全要求
3. 在安装目标位置就地编辑规则文件

关键提示：仅修改安装目标（$TARGET/）中的文件，绝不要修改源 ECC 仓库（$ECC_ROOT/）中的文件。

---

步骤 6：安装总结

从 /tmp 中清理克隆的仓库：

rm -rf /tmp/everything-claude-code

然后打印一份总结报告：

## ECC 安装完成

### 安装目标
- 层级：[用户级 / 项目级 / 两者皆有]
- 路径：[目标路径]

### 已安装技能 ([数量])
- skill-1, skill-2, skill-3, ...

### 已安装规则 ([数量])
- 通用规则 (8 个文件)
- typescript (5 个文件)
- ...

### 验证结果
- 发现 [数量] 个问题，已修复 [数量] 个
- [列出任何剩余问题]

### 已应用的优化
- [列出所做的更改，或 "无"]

---

故障排除

"技能未被 Claude Code 识别"

• 验证技能目录包含 SKILL.md 文件（而不仅仅是分散的 .md 文件）
• 对于用户级：检查 ~/.claude/skills/<skill-name>/SKILL.md 是否存在
• 对于项目级：检查 .claude/skills/<skill-name>/SKILL.md 是否存在

"规则不生效"

• 规则应为扁平文件，不应放在子目录中：$TARGET/rules/coding-style.md（正确）vs $TARGET/rules/common/coding-style.md（对于扁平安装是错误的）
• 安装规则后重启 Claude Code

"项目级安装后出现路径引用错误"

• 某些技能假定路径为 ~/.claude/。运行步骤 4 的验证来发现并修复这些问题。
• 对于 continuous-learning-v2，~/.claude/homunculus/ 目录始终是用户级的 —— 这是预期的，不是错误。