init-claude

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

init-claude

任意のリポジトリに Claude Code の

.claude/

体系を初期セットアップする。日本語運用・目的別 Agent（カテゴリ分割）・Rules 整備・スキル導入・委譲による main 消費抑制・ model 配分・SessionStart hooks・implement-issue-tree の動作前提まで一括構成する。

既存の

.claude/

が存在するリポジトリには

update-claude

を使用する。

为任意仓库初始化配置Claude Code的

.claude/

体系。一站式完成日语运营、按用途划分的Agent（分类管理）、Rules配置、Skill导入、通过委托减少main模型消耗、模型分配、SessionStart hooks配置，以及implement-issue-tree的运行前置环境搭建。

若仓库已存在

.claude/

，请使用

update-claude

。

使い方

使用方法

init-claude [対象リポジトリのパス]

パスを省略した場合はカレントディレクトリを対象とする。

init-claude [対象リポジトリのパス]

省略路径时默认以当前目录为目标。

前提条件

```
gh
```
CLI がインストールされ、認証済みであること（
```
gh auth status
```
で確認）
対象リポジトリで
```
git
```
が初期化済みであること
```
npx
```
が使用できること（
```
npx skills add
```
によるスキル導入に使用）

已安装
```
gh
```
CLI并完成认证（可通过
```
gh auth status
```
确认）
目标仓库已完成
```
git
```
初始化
可正常使用
```
npx
```
（用于通过
```
npx skills add
```
导入Skill）

フロー

流程

Step 1: 対象リポジトリを調査する

Step 1: 调查目标仓库

対象ディレクトリのルートを特定し、以下を把握する。

bash

undefined

确定目标目录的根路径，掌握以下信息：

bash

undefined

言語・フレームワーク検出

检测语言与框架

ls <target-repo>/ cat <target-repo>/package.json 2>/dev/null || true cat <target-repo>/Cargo.toml 2>/dev/null || true cat <target-repo>/pyproject.toml 2>/dev/null || true

ディレクトリ構成（最大深度 3）

目录结构（最大深度3）

find <target-repo> -maxdepth 3 -not -path '/.git/' -not -path '/node_modules/' | head -80

ビルド・テストコマンドの確認

确认构建与测试命令

cat <target-repo>/Makefile 2>/dev/null | head -40 || true cat <target-repo>/.github/workflows/*.yml 2>/dev/null | head -60 || true


調査で把握する情報:
- 主要言語・フレームワーク（Rust / TypeScript / Python など）
- ディレクトリ構成（crates/ / src/ / packages/ など）
- ビルドコマンド（`cargo build` / `npm run build` / `make` など）
- テストコマンド（`cargo test` / `npm test` / `pytest` など）
- 既存の `.claude/` ディレクトリの有無

既存の `.claude/` がある場合は `update-claude` スキルへ誘導して処理を中断する。

cat <target-repo>/Makefile 2>/dev/null | head -40 || true cat <target-repo>/.github/workflows/*.yml 2>/dev/null | head -60 || true


需调查的信息:
- 主要语言与框架（Rust / TypeScript / Python等）
- 目录结构（crates/ / src/ / packages/等）
- 构建命令（`cargo build` / `npm run build` / `make`等）
- 测试命令（`cargo test` / `npm test` / `pytest`等）
- 是否存在已有的`.claude/`目录

若已存在`.claude/`，则引导用户使用`update-claude`并中断当前处理。

Step 2: 構成案を設計してユーザーに提示・承認を得る

Step 2: 设计配置方案并获取用户确认

調査結果をもとに以下の構成案を設計する。

基于调查结果设计以下配置方案。

Agents 設計方針

Agent设计方针

技術レイヤ別の builder Agent と横断サポート Agent を組み合わせる。

カテゴリ	Agent 例	model
research	explorer（コードベース横断調査）, reference-researcher（外部仕様調査）	sonnet
implement	技術レイヤ別 builder（例: api-builder, web-builder, core-builder）	sonnet
testing	test-runner, e2e-runner	sonnet
quality	reviewer, security-auditor, linter	haiku / sonnet
docs	docs-writer	haiku

実装系 Agent はリポの技術レイヤに合わせてカスタマイズする（例: Rust workspace → クレート別 builder / TypeScript monorepo → パッケージ別 builder）
複雑な横断判断・アーキテクチャ設計は opus または fable（fable は Opus 上位の最上位 tier。特に大規模設計や複雑な横断判断が必要な場面に限定する）
調査・生成・レビューは sonnet
機械的集計・frontmatter lint・ドキュメント更新は haiku

结合技术层专属的builder Agent与跨领域支持Agent。

分类	Agent示例	model
research	explorer（跨代码库调查）, reference-researcher（外部规格调查）	sonnet
implement	技术层专属builder（例: api-builder, web-builder, core-builder）	sonnet
testing	test-runner, e2e-runner	sonnet
quality	reviewer, security-auditor, linter	haiku / sonnet
docs	docs-writer	haiku

实现类Agent需根据仓库的技术层进行定制（例: Rust工作区→按 crate 划分builder / TypeScript单体仓库→按包划分builder）
复杂的跨领域判断、架构设计使用opus或fable（fable是Opus之上的最高层级，仅限大规模设计或复杂跨领域判断场景）
调查、生成、评审使用sonnet
机械统计、frontmatter lint、文档更新使用haiku

Rules 設計方針

Rules设计方针

以下を標準として生成し、リポ特性に応じて追加する。

ファイル	内容
`delegation.md`	調査・設計フェーズの委譲原則・パスベース切り替え
`delegation-impl.md`	作成・編集フェーズの委譲マッピング
`coding-<lang>.md`	言語別コーディング規約（Rust / TypeScript / Python 等）
`security.md`	OWASP Top 10・秘密情報混入防止
`japanese-style.md`	日本語出力スタイル
`conventional-commits.md`	Conventional Commits 詳細規約
`code-comment-style.md`	コメント規約（役割・責務・呼び出し文脈を埋め込む）。規約（rule）は init-claude が生成し、規約に従ってコメントを追加・補強する `comment-code` （skill）は npx skills add で導入される
`out-of-scope-tracking.md`	実装対象外の追跡規約（スコープ外事項を放置しない）

默认生成以下规则，并根据仓库特性追加自定义规则。

文件	内容
`delegation.md`	调查、设计阶段的委托原则、基于路径的切换规则
`delegation-impl.md`	创建、编辑阶段的委托映射规则
`coding-<lang>.md`	语言专属编码规范（Rust / TypeScript / Python等）
`security.md`	OWASP Top 10、敏感信息混入防范规则
`japanese-style.md`	日语输出规范
`conventional-commits.md`	Conventional Commits详细规范
`code-comment-style.md`	注释规范（需嵌入角色、职责、调用上下文）。规范文件由init-claude生成，遵循规范添加、增强注释的 `comment-code` （Skill）通过npx skills add导入
`out-of-scope-tracking.md`	非实现目标事项的追踪规范（避免遗漏非范围事项）

Skills 設計方針

Skills设计方针

npx skills add Fandhe-AI/agent-cli-skills

で以下を導入する。

```
create-commit
```
— Conventional Commits コミット作成
```
create-pr
```
— PR 作成
```
create-issue
```
— Issue 作成
```
implement-issue
```
— Issue 単体実装
```
implement-issue-tree
```
— Issue ツリー並列実装
```
implement-review
```
— レビュー対応
```
implement-review-pr
```
— PR レビュー対応
```
update-docs
```
— CLAUDE.md 更新
```
comment-code
```
—
```
code-comment-style.md
```
規約に従ったコメント・ドキュメンテーションコメントの追加・補強

通过

npx skills add Fandhe-AI/agent-cli-skills

导入以下Skill：

```
create-commit
```
— 按Conventional Commits规范创建提交
```
create-pr
```
— 创建PR
```
create-issue
```
— 创建Issue
```
implement-issue
```
— 单个Issue实现
```
implement-issue-tree
```
— 并行实现Issue树
```
implement-review
```
— 处理评审意见
```
implement-review-pr
```
— 处理PR评审意见
```
update-docs
```
— 更新CLAUDE.md
```
comment-code
```
— 遵循
```
code-comment-style.md
```
规范添加、增强注释与文档注释

hooks 設計方針

hooks设计方针

SessionStart: 日本語・委譲・Conventional Commits・
```
--no-verify
```
禁止のリマインダー
PostToolUse: 言語に応じた自動整形（Rust:
```
rustfmt
```
/ TypeScript:
```
biome
```
または
```
prettier
```
/ Python:
```
ruff
```
など）

SessionStart: 日语沟通、委托机制、Conventional Commits规范、禁止
```
--no-verify
```
的提醒
PostToolUse: 根据语言自动格式化（Rust:
```
rustfmt
```
/ TypeScript:
```
biome
```
或
```
prettier
```
/ Python:
```
ruff
```
等）

model 配分表（CLAUDE.md に記載）

模型分配表（记载于CLAUDE.md）

用途	model
複雑な横断判断・アーキテクチャ設計	opus または fable（fable は特に大規模設計・横断判断の最上位 tier）
調査・生成・実装・レビュー	sonnet
機械的集計・lint・ドキュメント更新	haiku

上記の構成案（Agent 一覧・Rules 一覧・model 配分・hooks・Skills）をユーザーに提示し承認を得てから次の Step に進む。

用途	model
复杂跨领域判断、架构设计	opus或fable（fable仅限大规模设计、跨领域判断场景）
调查、生成、实现、评审	sonnet
机械统计、lint、文档更新	haiku

需将上述配置方案（Agent列表、Rules列表、模型分配、hooks、Skills）提交用户确认后，再进入下一步。

Step 3: .claude/ 一式を生成する

Step 3: 生成完整.claude/体系

承認後、以下の順で生成する。対象リポに

dotclaude-via-temp

ルール（

_/dotclaude/

経由）がない場合は対象リポの

.claude/

へ直接書き込んで良い。

サブステップの実行順は 3-1（CLAUDE.md 骨子）→ 3-2（agents/）→ 3-3（rules/）→ 3-4（settings.json）→ 3-5（スキル導入）→ 3-6（CLAUDE.md 確定） の順とする。CLAUDE.md は Agent・Rules・Skills の一覧を参照するため、3-1 では確定済みの項目（Overview / Repository Structure 等）のみ記載し、

Sub-agents

Rules

Current Skills

の各表は 3-2〜3-5 完了後に 3-6 で実体に合わせて確定する。

获得确认后，按以下顺序生成内容。若目标仓库无

dotclaude-via-temp

规则（通过

_/dotclaude/

路径），可直接写入目标仓库的

.claude/

目录。

子步骤执行顺序为 3-1（CLAUDE.md框架）→ 3-2（agents/）→ 3-3（rules/）→ 3-4（settings.json）→ 3-5（Skill导入）→ 3-6（CLAUDE.md定稿）。由于CLAUDE.md需引用Agent、Rules、Skills的列表，3-1阶段仅写入已确定的内容（Overview / Repository Structure等），

Sub-agents

Rules

Current Skills

的表格需在3-2至3-5完成后，于3-6阶段根据实际内容定稿。

3-1. CLAUDE.md の骨子を生成する

3-1. 生成CLAUDE.md框架

対象リポのルートに

CLAUDE.md

の骨子を作成する。以下のセクションを含めるが、

Sub-agents

Rules

Current Skills

は 3-2〜3-5 で実体を生成するまで見出しのみ（プレースホルダ）とし、内容は 3-6 で確定する。

markdown

undefined

在目标仓库根目录创建CLAUDE.md框架。需包含以下章节，但

Sub-agents

Rules

Current Skills

仅保留标题（占位符），内容需在3-2至3-5完成后于3-6阶段定稿。

markdown

undefined

CLAUDE.md

Overview

リポジトリの概要（調査結果から生成）

仓库概述（基于调查结果生成）

Repository Structure

ディレクトリ構成ツリー（3〜4階層）

目录结构树（3~4层级）

委譲方針（必読）

委托方针（必读）

main の役割・パスベース切り替え表・model 配分表

main模型的角色、基于路径的切换表、模型分配表

Sub-agents

（3-1 では見出しのみ。カテゴリ別 Agent 一覧の表は 3-2 完了後に 3-6 で確定する）

（3-1阶段仅保留标题。分类别Agent列表需在3-2完成后于3-6阶段定稿）

Rules

（3-1 では見出しのみ。ルールファイル一覧の表は 3-3 完了後に 3-6 で確定する）（標準セット: delegation / delegation-impl / coding-<lang> / security / japanese-style / conventional-commits / code-comment-style / out-of-scope-tracking）

（3-1阶段仅保留标题。规则文件列表需在3-3完成后于3-6阶段定稿）（标准集合: delegation / delegation-impl / coding-<lang> / security / japanese-style / conventional-commits / code-comment-style / out-of-scope-tracking）

Current Skills

（3-1 では見出しのみ。導入済みスキル一覧は 3-5 完了後に 3-6 で確定する）

（3-1阶段仅保留标题。已导入Skill列表需在3-5完成后于3-6阶段定稿）

Conventions

Conventional Commits・セキュリティレビュー・日本語出力・ユーザー承認フローなど

Conventional Commits、安全评审、日语输出、用户确认流程等

hooks（settings.json）

SessionStart / PostToolUse の説明

undefined

SessionStart / PostToolUse的说明

undefined

3-2. agents/ を生成する

3-2. 生成agents/目录

Step 2 で設計した Agent を

.claude/agents/<category>/<name>.md

に作成する。各 Agent は以下の frontmatter を持つ。

yaml

---
name: <name>
description: "<役割の説明>"
model: <haiku|sonnet|opus>
tools: [必要最小限のツール]
---

frontmatter のキーは Claude Code の subagent 定義仕様に従い

name

を使う（

subagent_type

は Agent ツール呼び出し時のパラメータ名であり、定義キーではない）。

将Step2设计的Agent写入

.claude/agents/<category>/<name>.md

。每个Agent需包含以下frontmatter：

yaml

---
name: <name>
description: "<角色说明>"
model: <haiku|sonnet|opus>
tools: [必要最小工具集]
---

frontmatter的键需遵循Claude Code的subagent定义规范，使用

name

（

subagent_type

是Agent工具调用时的参数名，而非定义键）。

3-3. rules/ を生成する

3-3. 生成rules/目录

Step 2 で設計したルールを

.claude/rules/

に作成する。

delegation.md

・

delegation-impl.md

は本リポの実例（Fandhe-AI/agent-cli-skills）を参考に対象リポのパス構成に合わせてカスタマイズする。

code-comment-style.md

と

out-of-scope-tracking.md

は以下の雛形骨子をベースに、対象リポの言語・構成に合わせて調整して生成する。

将Step2设计的规则写入

.claude/rules/

。

delegation.md

、

delegation-impl.md

需参考本仓库示例（Fandhe-AI/agent-cli-skills），根据目标仓库的路径结构进行定制。

code-comment-style.md

与

out-of-scope-tracking.md

需基于以下模板框架，结合目标仓库的语言与结构调整生成。

code-comment-style.md の雛形骨子

code-comment-style.md模板框架

markdown

undefined

markdown

undefined

コメント規約

注释规范

目的

後続の読み手（Claude を含む）は渡された情報からしか判断できない。コメントはパッケージ・サービス・モジュール視点での役割と、他ファイル・他サービスとの文脈を埋め込み、ファイル単体で文脈が伝わる状態にする。

后续阅读者（包括Claude）只能基于提供的信息进行判断。注释需从包、服务、模块视角嵌入角色与职责边界，以及与其他文件、服务的上下文，确保文件本身可传递完整语境。

何を書くか

需记录的内容

このファイル・モジュール・関数の役割と責務境界（1〜2行要約をドキュメンテーションコメントで）
呼び出し元・呼び出し先の文脈（「〜から呼ばれる」「〜を呼んで〜を返す」）
他ファイル・他サービスとの契約（インターフェース・プロトコル・前提条件）
非自明な前提・副作用・エラー処理の意図

本文件、模块、函数的角色与职责边界（通过文档注释添加1~2行摘要）
调用方、被调用方的上下文（「被~~调用」「调用~~并返回~」）
与其他文件、服务的契约（接口、协议、前提条件）
非显而易见的前提、副作用、错误处理意图

何を書かないか

无需记录的内容

コードを読めば分かる逐語説明（
```
i++  // i をインクリメント
```
等）
陳腐化しやすい実装詳細の重複（コードと2重に管理しない）

阅读代码即可理解的直译说明（如
```
i++  // i をインクリメント
```
）
易过时的实现细节重复（避免与代码双重维护）

ドキュメンテーションコメントの形式

文档注释格式

言語慣習に従う（Rust:

///

、TypeScript/JavaScript:

/** */

、Python: docstring 等）。パッケージ・モジュール・公開 API の入口には必ず1〜2行の役割要約を付ける。

undefined

遵循语言惯例（Rust:

///

、TypeScript/JavaScript:

/** */

、Python: docstring等）。包、模块、公开API的入口必须添加1~2行角色摘要。

undefined

out-of-scope-tracking.md の雛形骨子

out-of-scope-tracking.md模板框架

markdown

undefined

markdown

undefined

実装対象外の追跡規約

非实现目标事项追踪规范

目的

実装・レビュー中にスコープ外と判断した事項を放置しない。後で埋もれるのを防ぐため、発見したタイミングで Issue に記録して追跡可能にする。

避免遗漏实现、评审过程中判定为非范围的事项。为防止后续遗忘，需在发现时立即记录到Issue中以便追踪。

フロー

流程

検出: 実装・レビュー中にスコープ外と判断した事項をメモする
既存 Issue の確認:
bash
```
gh issue list --search "${KEYWORD}" --state open
```
キーワードは
```
"${KEYWORD}"
```
でクォートして渡す。
ユーザーに承認を得る: 既存 Issue への追記か新規起票かをユーザーと確認する
記録:
- 既存 Issue がある場合:

bash

gh issue comment "${ISSUE_NUMBER}" --body "$(cat <<'EOF'
（本文をここに記述）
EOF
)"

存在しない場合:
```
create-issue-tree
```
または
```
create-issue
```
で適切な親 Issue 配下に起票

元 PR・レビューに切り出し先を記録: コメントまたは PR 本文に切り出し先の Issue 番号を記載する

检测: 在实现、评审过程中记录判定为非范围的事项

确认已有Issue:

bash

gh issue list --search "${KEYWORD}" --state open

关键词需用

"${KEYWORD}"

包裹传递。

获取用户确认: 与用户确认是追加到已有Issue还是创建新Issue
记录:
- 若存在已有Issue:

bash

gh issue comment "${ISSUE_NUMBER}" --body "$(cat <<'EOF'
（内容写入此处）
EOF
)"

若不存在: 通过
```
create-issue-tree
```
或
```
create-issue
```
在合适的父Issue下创建新Issue

记录跳转目标: 在原PR、评审中记录跳转目标的Issue编号

注意

注意事项

ユーザーの承認なしに勝手に Issue を起票しない
スコープ外の修正を現在の PR に混入させない（別 Issue・別 PR で対処する）

undefined

未经用户确认不得擅自创建Issue
不得将非范围的修改混入当前PR（需通过单独Issue、PR处理）

undefined

3-4. settings.json を生成する

3-4. 生成settings.json

json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo '<リポ名>: 日本語でやりとり / 作業は subagent へ委譲し main 消費を抑える (delegation.md, delegation-impl.md) / Conventional Commits 厳守 (--no-verify 禁止) / implement-issue は計画承認後に実装'"
          }
        ]
      }
    ]
  }
}

言語に応じた PostToolUse 自動整形フックを提案し、ユーザーが希望する場合は追加する。

セキュリティ注意事項:

```
command
```
の値に API キー・トークン・パスワードを埋め込まない
ユーザー入力をそのまま
```
command
```
に展開しない

json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo '<仓库名>: 使用日语沟通 / 工作委托给subagent以减少main模型消耗 (delegation.md, delegation-impl.md) / 严格遵循Conventional Commits规范 (禁止--no-verify) / implement-issue需在计划确认后执行'"
          }
        ]
      }
    ]
  }
}

可根据语言建议PostToolUse自动格式化hook，若用户同意则添加。

安全注意事项:

不得在
```
command
```
值中嵌入API密钥、令牌、密码
不得直接将用户输入展开到
```
command
```
中

3-5. スキルを導入する

3-5. 导入Skill

bash

cd <target-repo>
npx skills add Fandhe-AI/agent-cli-skills

skills-lock.json

が生成されることを確認する。

bash

cd <target-repo>
npx skills add Fandhe-AI/agent-cli-skills

确认生成

skills-lock.json

。

3-6. CLAUDE.md を確定する

3-6. CLAUDE.md定稿

3-2〜3-5 で生成した Agent・Rules・導入スキルの実体をもとに、3-1 で見出しのみとした

Sub-agents

Rules

Current Skills

の各表を実際の一覧（subagent_type / model / ファイル名 / 導入スキル名）で埋めて確定する。未存在の項目を列挙したまま残さない。

基于3-2至3-5生成的Agent、Rules、已导入Skill的实际内容，将3-1阶段仅保留标题的

Sub-agents

Rules

Current Skills

表格替换为实际列表（subagent_type / model / 文件名 / 已导入Skill名）。不得保留未存在的项目。

Step 4: implement-issue-tree の動作前提を確認する

Step 4: 确认implement-issue-tree的运行前置环境

bash

undefined

bash

undefined

gh auth と sub_issues API の確認

确认gh auth与sub_issues API

gh auth status

sub_issues は issue 番号付き

issues/{n}/sub_issues

のみ有効（リポジトリ直下に

sub_issues仅支持带Issue编号的

issues/{n}/sub_issues

接口（仓库根目录无sub_issues端点）。若存在已有Issue，可指定编号确认连通性

sub_issues エンドポイントは存在しない）。既存 issue があれば番号を指定して疎通確認する

（若未创建Issue，仅通过gh auth status确认前置条件）

（issue が未作成なら gh auth status のみで前提確認とする）

—

gh api "repos/<owner>/<repo>/issues/<既存issue番号>/sub_issues" 2>&1 | head -5

gh api "repos/<owner>/<repo>/issues/<已有Issue编号>/sub_issues" 2>&1 | head -5

workflow js の参照確認

确认workflow js

ls -la <target-repo>/.claude/workflows/implement-issue-tree.js 2>/dev/null ||
echo "workflow js が存在しない"


不足がある場合は以下の対処方法をユーザーに案内する。

**workflow js が存在しない場合の配置方法:**

named workflow（`{name: "implement-issue-tree"}`）として呼ばない場合は `.claude/workflows/` への配置自体が不要で、Workflow ツールの `scriptPath` に `.claude/skills/implement-issue-tree/script/implement-issue-tree.js` を直接指定すればよい。

named workflow として配置する場合は `cp` ではなく**相対 symlink** を使用する。`cp` で配置すると `npx skills add` による更新が named workflow に届かなくなる。

```bash
mkdir -p <target-repo>/.claude/workflows/

ls -la <target-repo>/.claude/workflows/implement-issue-tree.js 2>/dev/null ||
echo "workflow js不存在"


若存在缺失，需向用户提供以下解决方案。

**workflow js不存在时的配置方法:**

若不以命名工作流（`{name: "implement-issue-tree"}`）调用，则无需配置到`.claude/workflows/`，只需在Workflow工具的`scriptPath`中直接指定`.claude/skills/implement-issue-tree/script/implement-issue-tree.js`即可。

若以命名工作流配置，请勿使用`cp`复制，需使用**相对符号链接**。使用`cp`复制会导致`npx skills add`的更新无法同步到命名工作流。

```bash
mkdir -p <target-repo>/.claude/workflows/

.claude/workflows/ から見た相対パスで symlink を作成する

从.claude/workflows/目录创建相对路径的符号链接

既に symlink が存在する場合はそのままにする（実体ファイルを上書きしない）

若已存在符号链接则保留（不覆盖实际文件）

if [ ! -e "<target-repo>/.claude/workflows/implement-issue-tree.js" ]; then ln -s ../skills/implement-issue-tree/script/implement-issue-tree.js
<target-repo>/.claude/workflows/implement-issue-tree.js fi

undefined

undefined

Step 5: 生成結果を報告する

Step 5: 报告生成结果

報告項目:

生成したファイル一覧（CLAUDE.md・Agents・Rules・settings.json）
導入したスキル一覧（
```
npx skills add
```
の結果）
implement-issue-tree の動作前提の充足状況
ユーザーへの次のアクション案内（PostToolUse hooks の追加・Agent のカスタマイズなど）

报告内容:

生成的文件列表（CLAUDE.md、Agents、Rules、settings.json）
已导入的Skill列表（
```
npx skills add
```
的执行结果）
implement-issue-tree运行前置环境的满足情况
向用户提供后续操作建议（如添加PostToolUse hooks、定制Agent等）

検証

验证

bash

undefined

bash

undefined

生成ファイルの一覧確認

确认生成文件列表

find <target-repo>/.claude -type f | sort

CLAUDE.md の存在確認

确认CLAUDE.md存在

ls <target-repo>/CLAUDE.md

skills-lock.json の存在確認

确认skills-lock.json存在

ls <target-repo>/skills-lock.json

implement-issue-tree の前提確認

确认implement-issue-tree的前置条件

gh auth status ls <target-repo>/.claude/workflows/implement-issue-tree.js 2>/dev/null || echo "workflow js: 未配置"

undefined

gh auth status ls <target-repo>/.claude/workflows/implement-issue-tree.js 2>/dev/null || echo "workflow js: 未配置"

undefined

注意事項

注意事项

既存の
```
.claude/
```
がある場合は処理を中断して
```
update-claude
```
を案内する
ユーザーの構成案承認なしに
```
.claude/
```
の生成を開始しない
```
settings.json
```
の
```
command
```
にトークン・シークレットをハードコードしない
```
--no-verify
```
を含むコマンドを hooks に仕込まない
```
npx skills add
```
が失敗した場合はエラーメッセージを表示してユーザーに手動手順を案内する
言語別 PostToolUse 整形フック（rustfmt / biome / prettier / ruff）は対象リポのツール存在確認後に提案する
Agent の
```
tools
```
リストは最小権限原則に従い必要なもののみ列挙する

若已存在
```
.claude/
```
则中断处理并引导使用
```
update-claude
```
未获得用户对配置方案的确认前，不得开始生成
```
.claude/
```
内容
不得在
```
settings.json
```
的
```
command
```
中硬编码令牌、敏感信息
不得在hooks中添加包含
```
--no-verify
```
的命令
若
```
npx skills add
```
执行失败，需显示错误信息并向用户提供手动操作步骤
语言专属PostToolUse格式化hook（rustfmt / biome / prettier / ruff）需在确认目标仓库存在对应工具后再建议添加
Agent的
```
tools
```
列表需遵循最小权限原则，仅列举必要工具