From 2d89c410e1fbf8af55c9eefc5b8c8bf364efa18b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9C=89=E8=97=A4=20=E5=81=A5=E5=A4=AA=E9=83=8E?= Date: Tue, 14 Apr 2026 12:58:12 +0900 Subject: [PATCH] =?UTF-8?q?feat(templates):=20ClaudeOS=20v7.5=20=E3=83=86?= =?UTF-8?q?=E3=83=B3=E3=83=97=E3=83=AC=E3=83=BC=E3=83=88=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E3=83=BB=E3=83=AB=E3=83=BC=E3=83=97=E7=9F=AD=E7=B8=AE=E3=83=BB?= =?UTF-8?q?CodeRabbit=20=E7=B5=B1=E5=90=88=E3=83=BB/team-onboarding=20?= =?UTF-8?q?=E5=AE=9F=E8=A3=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - v7.4 → v7.5 バージョン更新（_header.md, _footer.md, CLAUDE.md, 09-termination-reporting.md） - ループ時間短縮: Development 2h→60m、Verify 1h→45m、Improvement 1h→45m （2プロジェクト並行利用による daily/weekly limit 対策） - CodeRabbit 統合を全テンプレートに反映（§8.5 追加、Reviewer ロール更新、05-codex-debug.md 更新） - /team-onboarding コマンド新規実装（.claude/claudeos/commands/team-onboarding.md） - Build-StartPrompt.ps1 で START_PROMPT.md を自動再生成（855行） - .gitignore に claude-mem 自動生成ファイルを追加（instructions/, commands/ ディレクトリ） Co-Authored-By: Claude Sonnet 4.6 --- .claude/claudeos/commands/team-onboarding.md | 117 ++++++++++++++++++ .gitignore | 3 + Claude/templates/claude/CLAUDE.md | 61 +++++++-- Claude/templates/claude/START_PROMPT.md | 66 +++++++--- .../claude/instructions/01-session-startup.md | 6 +- .../claude/instructions/04-agent-teams.md | 3 +- .../claude/instructions/05-codex-debug.md | 33 ++++- .../instructions/09-termination-reporting.md | 3 +- .../templates/claude/instructions/_footer.md | 2 +- .../templates/claude/instructions/_header.md | 14 +-- 10 files changed, 269 insertions(+), 39 deletions(-) create mode 100644 .claude/claudeos/commands/team-onboarding.md diff --git a/.claude/claudeos/commands/team-onboarding.md b/.claude/claudeos/commands/team-onboarding.md new file mode 100644 index 00000000..5cd02c4c --- /dev/null +++ b/.claude/claudeos/commands/team-onboarding.md @@ -0,0 +1,117 @@ +# /team-onboarding + +新しいメンバーが ClaudeOS プロジェクトに参加する際のオンボーディングガイドを対話的に提供するコマンドです。 + +## 実行内容 + +以下のステップをシーケンシャルに案内します。 + +### Step 1: 環境確認 + +```text +以下の環境が揃っているか確認してください： + +- Claude Code CLI インストール済み +- Git / GitHub CLI (gh) インストール済み +- Node.js (LTS) インストール済み +- リポジトリへのアクセス権限確認済み +- GitHub Token 設定済み +``` + +### Step 2: ClaudeOS 設定ファイル配置 + +プロジェクトの CLAUDE.md を確認し、以下のファイルが正しく配置されているか検証します。 + +| ファイル | 場所 | 用途 | +|---|---|---| +| `CLAUDE.md` | リポジトリルート | プロジェクト運用ポリシー | +| `state.json` | リポジトリルート | Goal / KPI / フェーズ管理 | +| `.claude/claudeos/` | リポジトリ内 | エージェント定義・コマンド定義 | +| `~/.claude/CLAUDE.md` | グローバル | 全プロジェクト共通設定 | + +### Step 3: ループコマンド説明 + +ClaudeOS は以下の 4 つのループで自律開発を実行します： + +| ループ | 時間 | 責務 | +|---|---|---| +| Monitor | 30m | GitHub / CI / Issue の状態確認・優先順位決定 | +| Development | 60m | 設計・実装・WorkTree 管理 | +| Verify | 45m | test / lint / build / CodeRabbit / CI 確認、STABLE 判定 | +| Improvement | 45m | リファクタリング・ドキュメント更新・再開メモ | + +### Step 4: Agent Teams 説明 + +ClaudeOS の Agent Teams は以下のロールで構成されます： + +| ロール | 責務 | +|---|---| +| CTO | 最終判断・優先順位・継続可否 | +| ProductManager | Issue 生成・要件整理 | +| Architect | アーキテクチャ設計 | +| Developer | 実装・修正・修復 | +| Reviewer | Codex + CodeRabbit レビュー・コード品質 | +| Debugger | 原因分析・rescue 実行 | +| QA | テスト・回帰確認・品質評価 | +| Security | secrets・権限・脆弱性確認 | +| DevOps | CI/CD・PR・Deploy Gate | +| Analyst | KPI 分析・メトリクス評価 | +| EvolutionManager | 改善提案・自己進化管理 | +| ReleaseManager | リリース管理・マージ判断 | + +### Step 5: state.json の読み方 + +`state.json` はセッションの単一の真実（Single Source of Truth）です： + +```json +{ + "goal": { "title": "プロジェクトの目標" }, + "kpi": { "success_rate_target": 0.9 }, + "execution": { + "phase": "Monitor | Development | Verify | Improvement", + "remaining_minutes": 300 + }, + "token": { "used": 0, "remaining": 100 } +} +``` + +### Step 6: 開発フローの把握 + +``` +Issue 起票 → Monitor で優先順位確認 +→ Development でブランチ作成・実装 +→ commit / push / PR 作成 +→ Verify で CI・レビュー確認 +→ STABLE 達成 → merge +→ Improvement でドキュメント整備 +→ 次の Monitor へ +``` + +### Step 7: 禁止事項の確認 + +- `main` への直接 push 禁止 +- Issue なし作業禁止 +- CI 未通過 merge 禁止 +- 無限修復（Auto Repair は最大 15 回） +- Token 超過のまま深掘り継続禁止 + +### Step 8: 最初のセッション開始 + +準備完了後、以下を実行してセッションを開始します： + +```text +/loop 30m ClaudeOS Monitor +/loop 60m ClaudeOS Development +/loop 45m ClaudeOS Verify +/loop 45m ClaudeOS Improvement +``` + +## 参照先 + +| ドキュメント | 場所 | +|---|---| +| プロジェクト設定 | `CLAUDE.md` (リポジトリルート) | +| グローバル設定 | `~/.claude/CLAUDE.md` | +| 運用ループ詳細 | `.claude/claudeos/loops/` | +| Agent 定義 | `.claude/claudeos/agents/` | +| CI Manager | `.claude/claudeos/ci/ci-manager.md` | diff --git a/.gitignore b/.gitignore index 63f70fde..78e82505 100644 --- a/.gitignore +++ b/.gitignore @@ -133,3 +133,6 @@ Claude/templates/claude/START_PROMPT-backup*.md scripts/lib/CLAUDE.md scripts/main/CLAUDE.md tests/CLAUDE.md +Claude/templates/claude/instructions/CLAUDE.md +.claude/claudeos/commands/CLAUDE.md +Claude/templates/claude/Claude/ diff --git a/Claude/templates/claude/CLAUDE.md b/Claude/templates/claude/CLAUDE.md index 69d7560c..6caf3c81 100644 --- a/Claude/templates/claude/CLAUDE.md +++ b/Claude/templates/claude/CLAUDE.md @@ -1,5 +1,5 @@ -# ClaudeOS v7.4 — プロジェクト設定 -## Autonomous Operations Edition +# ClaudeOS v7.5 — プロジェクト設定 +## Autonomous Operations Edition + CodeRabbit Review Integration このファイルはプロジェクト単位の Claude Code 運用ポリシーです。 グローバル設定（`~/.claude/CLAUDE.md`）の方針を継承しつつ、プロジェクト固有の設定を定義します。 @@ -21,9 +21,9 @@ ``` /loop 30m ClaudeOS Monitor -/loop 2h ClaudeOS Development -/loop 1h ClaudeOS Verify -/loop 1h ClaudeOS Improvement +/loop 60m ClaudeOS Development +/loop 45m ClaudeOS Verify +/loop 45m ClaudeOS Improvement ``` 4 本すべての登録が完了するまで、通常の開発作業は開始しないでください。 @@ -117,9 +117,9 @@ agents、skills、commands、rules、hooks、scripts、contexts、examples、mcp | ループ | 時間目安 | 責務 | 禁止事項 | |---|---|---|---| | Monitor | 30m | 要件・設計・README 差分確認、Git/CI 状態確認、タスク分解 | 実装・修復 | -| Build | 2h | 設計メモ作成、実装、テスト追加、WorkTree 管理 | ついでの大規模整理、main 直接 push | -| Verify | 1h | test / lint / build / security 確認、STABLE 判定 | 未テストの merge | -| Improve | 1h | 命名整理、リファクタリング、README / docs 更新、再開メモ | 破壊的変更の無断実行 | +| Build | 60m | 設計メモ作成、実装、テスト追加、WorkTree 管理 | ついでの大規模整理、main 直接 push | +| Verify | 45m | test / lint / build / security / CodeRabbit 確認、STABLE 判定 | 未テストの merge | +| Improve | 45m | 命名整理、リファクタリング、README / docs 更新、再開メモ | 破壊的変更の無断実行 | 失敗時: `Verify → CI Manager → Auto Repair → 再 Verify` @@ -267,6 +267,42 @@ Agent Teams 使用禁止: Lint 修正のみ / 小規模バグ修正 / 順序依 - 深追い禁止 - 同一原因 3 回まで +## 8.5 CodeRabbit 統合（v7.5 追加） + +CodeRabbit CLI プラグインを Verify / Review の補助ツールとして使用する。 +Codex レビューの代替ではなく、静的解析（40+ 解析器）による補完として位置づける。 + +### 実行コマンド + +| タイミング | コマンド | 目的 | +|---|---|---| +| PR 作成前（推奨） | `/coderabbit:review committed --base main` | コミット済み差分の事前品質チェック | +| Verify フェーズ | `/coderabbit:review all --base main` | 全変更の包括レビュー | +| 修正後の再確認 | `/coderabbit:review uncommitted` | 未コミット修正の即時確認 | + +### Codex との統合順序 + +``` +1. /coderabbit:review committed --base main ← 静的解析 + AI（高速・広範） +2. /codex:review --base main --background ← 設計・ロジックの深いレビュー +3. 両方の指摘を統合して修正 +``` + +### 指摘対応ルール + +| 重大度 | 対応 | +|---|---| +| Critical | 必須修正。未修正で merge 禁止 | +| High | 必須修正。未修正で merge 禁止 | +| Medium | 原則修正。技術的理由があれば理由を記録してスキップ可 | +| Low | 任意。時間・Token 残量に応じて対応 | + +### 対応上限（無限ループ防止） + +- 同一ファイルへの修正: 最大 3 ラウンド +- 全体レビューループ: 最大 5 ラウンド +- 上限到達時: 残指摘を Issue に起票して次フェーズへ進む + ## 9. STABLE 判定 以下をすべて満たした場合のみ STABLE とします。 @@ -463,3 +499,12 @@ Document always / README keeps truth | CI | `claudeos/ci/ci-manager.md` | | Evolution | `claudeos/evolution/self-evolution.md` | | グローバル設定 | `~/.claude/CLAUDE.md` | + + + +# Recent Activity + + + +*No recent activity* + \ No newline at end of file diff --git a/Claude/templates/claude/START_PROMPT.md b/Claude/templates/claude/START_PROMPT.md index 05f48b12..ce2fb5dd 100644 --- a/Claude/templates/claude/START_PROMPT.md +++ b/Claude/templates/claude/START_PROMPT.md @@ -1,26 +1,26 @@ -# ClaudeOS v7.4 セッション開始 +# ClaudeOS v7.5 セッション開始 ## LOOP_COMMANDS /loop 30m ClaudeOS Monitor -/loop 2h ClaudeOS Development -/loop 1h ClaudeOS Verify -/loop 1h ClaudeOS Improvement +/loop 60m ClaudeOS Development +/loop 45m ClaudeOS Verify +/loop 45m ClaudeOS Improvement 4つ全て登録されたら次に進んでください。 ## PROMPT_BODY -# ClaudeOS v7.4 完全無人運用版 +# ClaudeOS v7.5 完全無人運用版 -## Autonomous Operations Edition + AI Dev Factory + Priority Intelligence + Full CI Automation + Auto Loop Intelligence +## Autonomous Operations Edition + AI Dev Factory + Priority Intelligence + Full CI Automation + Auto Loop Intelligence + CodeRabbit Review Integration ## 指示確認プロトコル（必須） LOOP_COMMANDS 登録・Codex セットアップ完了後、作業を開始する前に、以下の確認チェックリストを出力してください。 ``` -=== ClaudeOS v7.4 指示確認 === +=== ClaudeOS v7.5 指示確認 === [✅/❌] 01 セッション開始・Codex設定・実行方針 [✅/❌] 02 コア構造・マルチプロジェクト・Goal Driven [✅/❌] 03 state.json スキーマ・優先順位AI @@ -43,9 +43,9 @@ LOOP_COMMANDS 登録・Codex セットアップ完了後、作業を開始する ```text /loop 30m ClaudeOS Monitor -/loop 2h ClaudeOS Development -/loop 1h ClaudeOS Verify -/loop 1h ClaudeOS Improvement +/loop 60m ClaudeOS Development +/loop 45m ClaudeOS Verify +/loop 45m ClaudeOS Improvement ``` 4つ全て登録されたら次に進む。 @@ -74,9 +74,8 @@ LOOP_COMMANDS 登録・Codex セットアップ完了後、作業を開始する ## 実行方針 - -- 設定された時間から5時間作業を厳密に守る -- Monitor、Development、Verify、Improvement を最大10回ループ（早期停止・終了はCTO判断、STABLE達成・5時間到達・Token枯渇・Blocked判定で早期終了） +- 設定された時間から5時間作業を厳密に守ってください。 +- Monitor、Development、Verify、Improvement を最大10回ループとしてください（早期停止・終了はCTO判断、STABLE達成・5時間到達・Token枯渇・Blocked判定で早期終了）。 - LOOP 登録 4 本・Codex セットアップ・確認チェックリストが全て完了したら、CTO全権委任で自律開発を開始してください。 ### 1. AgentTeams活用ルール @@ -339,7 +338,7 @@ Agent は以下を唯一の定義ソースとする： | ProductManager | Issue生成 / Projects同期 | | Architect | 設計 | | Developer | 実装 | -| Reviewer | Codexレビュー | +| Reviewer | Codexレビュー / CodeRabbitレビュー | | Debugger | 原因分析 | | QA | テスト | | Security | リスク評価 | @@ -374,11 +373,43 @@ Agent は以下を唯一の定義ソースとする： [Analyst] KPI分析: [EvolutionManager] 改善: [ReleaseManager] 判断: +[CodeRabbit] レビュー結果: Critical=N High=N Medium=N Low=N ``` --- -# Codex統合・Debug原則 +# Codex統合・CodeRabbit統合・Debug原則 + +## CodeRabbit統合（v7.5） + +CodeRabbit は静的解析（40+ 解析器）による広範な品質チェックを担う補完ツール。 +Codex の深い設計レビューと組み合わせて使用する。 + +### 実行コマンド + +```text +/coderabbit:review committed --base main # コミット済み差分の事前チェック +/coderabbit:review all --base main # Verify フェーズでの包括レビュー +/coderabbit:review uncommitted # 修正後の即時確認 +``` + +### Codex との統合順序 + +``` +1. /coderabbit:review committed --base main ← 静的解析 (広く・高速) +2. /codex:review --base main --background ← 設計・ロジックレビュー (深く) +3. 両方の指摘を統合して修正 +``` + +### 指摘対応ルール + +| 重大度 | 対応 | +|---|---| +| Critical / High | 必須修正。未修正で merge 禁止 | +| Medium | 原則修正。技術的理由があればスキップ可 | +| Low | 任意。Token・時間残量に応じて対応 | + +同一ファイル修正: 最大 3 ラウンド / 全体ループ: 最大 5 ラウンド ## 通常レビュー @@ -789,13 +820,14 @@ GitHub Projects の更新タイミングは 01-session-startup.md「6. GitHub Pr - 残課題 - 次アクション -## v7.4の本質 +## v7.5の本質 - AI が Issue を自動生成する - AI が GitHub Projects を統制する - AI が state.json を基に優先順位判断する - AI が CI を監視し、限定的に自己修復する - AI が失敗と成功を学習する +- CodeRabbit + Codex の二重レビューで品質を担保する ## 最重要思想 @@ -818,5 +850,5 @@ GitHub Projects の更新タイミングは 01-session-startup.md「6. GitHub Pr --- -ClaudeOS v7.4 は、AI Dev Factory・優先順位AI・GitHub Projects連携・GitHub Actions CI Manager に加え、Auto Loop Intelligence・可視化・ドキュメント自動更新を統合した、完全自律 AI 開発運用基盤である。 +ClaudeOS v7.5 は、AI Dev Factory・優先順位AI・GitHub Projects連携・GitHub Actions CI Manager に加え、Auto Loop Intelligence・可視化・ドキュメント自動更新・CodeRabbit + Codex 二重レビュー統合を実装した、完全自律 AI 開発運用基盤である。 diff --git a/Claude/templates/claude/instructions/01-session-startup.md b/Claude/templates/claude/instructions/01-session-startup.md index d5cd7636..f3a033ea 100644 --- a/Claude/templates/claude/instructions/01-session-startup.md +++ b/Claude/templates/claude/instructions/01-session-startup.md @@ -4,9 +4,9 @@ ```text /loop 30m ClaudeOS Monitor -/loop 2h ClaudeOS Development -/loop 1h ClaudeOS Verify -/loop 1h ClaudeOS Improvement +/loop 60m ClaudeOS Development +/loop 45m ClaudeOS Verify +/loop 45m ClaudeOS Improvement ``` 4つ全て登録されたら次に進む。 diff --git a/Claude/templates/claude/instructions/04-agent-teams.md b/Claude/templates/claude/instructions/04-agent-teams.md index 50f14530..d602b94c 100644 --- a/Claude/templates/claude/instructions/04-agent-teams.md +++ b/Claude/templates/claude/instructions/04-agent-teams.md @@ -8,7 +8,7 @@ | ProductManager | Issue生成 / Projects同期 | | Architect | 設計 | | Developer | 実装 | -| Reviewer | Codexレビュー | +| Reviewer | Codexレビュー / CodeRabbitレビュー | | Debugger | 原因分析 | | QA | テスト | | Security | リスク評価 | @@ -43,4 +43,5 @@ [Analyst] KPI分析: [EvolutionManager] 改善: [ReleaseManager] 判断: +[CodeRabbit] レビュー結果: Critical=N High=N Medium=N Low=N ``` diff --git a/Claude/templates/claude/instructions/05-codex-debug.md b/Claude/templates/claude/instructions/05-codex-debug.md index f219bca6..7a4d8504 100644 --- a/Claude/templates/claude/instructions/05-codex-debug.md +++ b/Claude/templates/claude/instructions/05-codex-debug.md @@ -1,4 +1,35 @@ -# Codex統合・Debug原則 +# Codex統合・CodeRabbit統合・Debug原則 + +## CodeRabbit統合（v7.5） + +CodeRabbit は静的解析（40+ 解析器）による広範な品質チェックを担う補完ツール。 +Codex の深い設計レビューと組み合わせて使用する。 + +### 実行コマンド + +```text +/coderabbit:review committed --base main # コミット済み差分の事前チェック +/coderabbit:review all --base main # Verify フェーズでの包括レビュー +/coderabbit:review uncommitted # 修正後の即時確認 +``` + +### Codex との統合順序 + +``` +1. /coderabbit:review committed --base main ← 静的解析 (広く・高速) +2. /codex:review --base main --background ← 設計・ロジックレビュー (深く) +3. 両方の指摘を統合して修正 +``` + +### 指摘対応ルール + +| 重大度 | 対応 | +|---|---| +| Critical / High | 必須修正。未修正で merge 禁止 | +| Medium | 原則修正。技術的理由があればスキップ可 | +| Low | 任意。Token・時間残量に応じて対応 | + +同一ファイル修正: 最大 3 ラウンド / 全体ループ: 最大 5 ラウンド ## 通常レビュー diff --git a/Claude/templates/claude/instructions/09-termination-reporting.md b/Claude/templates/claude/instructions/09-termination-reporting.md index a0532f20..42c33d36 100644 --- a/Claude/templates/claude/instructions/09-termination-reporting.md +++ b/Claude/templates/claude/instructions/09-termination-reporting.md @@ -53,13 +53,14 @@ GitHub Projects の更新タイミングは 01-session-startup.md「6. GitHub Pr - 残課題 - 次アクション -## v7.4の本質 +## v7.5の本質 - AI が Issue を自動生成する - AI が GitHub Projects を統制する - AI が state.json を基に優先順位判断する - AI が CI を監視し、限定的に自己修復する - AI が失敗と成功を学習する +- CodeRabbit + Codex の二重レビューで品質を担保する ## 最重要思想 diff --git a/Claude/templates/claude/instructions/_footer.md b/Claude/templates/claude/instructions/_footer.md index 4aa6225a..1aa9286c 100644 --- a/Claude/templates/claude/instructions/_footer.md +++ b/Claude/templates/claude/instructions/_footer.md @@ -13,4 +13,4 @@ --- -ClaudeOS v7.4 は、AI Dev Factory・優先順位AI・GitHub Projects連携・GitHub Actions CI Manager に加え、Auto Loop Intelligence・可視化・ドキュメント自動更新を統合した、完全自律 AI 開発運用基盤である。 +ClaudeOS v7.5 は、AI Dev Factory・優先順位AI・GitHub Projects連携・GitHub Actions CI Manager に加え、Auto Loop Intelligence・可視化・ドキュメント自動更新・CodeRabbit + Codex 二重レビュー統合を実装した、完全自律 AI 開発運用基盤である。 diff --git a/Claude/templates/claude/instructions/_header.md b/Claude/templates/claude/instructions/_header.md index 386d9407..ac8dbd9e 100644 --- a/Claude/templates/claude/instructions/_header.md +++ b/Claude/templates/claude/instructions/_header.md @@ -1,26 +1,26 @@ -# ClaudeOS v7.4 セッション開始 +# ClaudeOS v7.5 セッション開始 ## LOOP_COMMANDS /loop 30m ClaudeOS Monitor -/loop 2h ClaudeOS Development -/loop 1h ClaudeOS Verify -/loop 1h ClaudeOS Improvement +/loop 60m ClaudeOS Development +/loop 45m ClaudeOS Verify +/loop 45m ClaudeOS Improvement 4つ全て登録されたら次に進んでください。 ## PROMPT_BODY -# ClaudeOS v7.4 完全無人運用版 +# ClaudeOS v7.5 完全無人運用版 -## Autonomous Operations Edition + AI Dev Factory + Priority Intelligence + Full CI Automation + Auto Loop Intelligence +## Autonomous Operations Edition + AI Dev Factory + Priority Intelligence + Full CI Automation + Auto Loop Intelligence + CodeRabbit Review Integration ## 指示確認プロトコル（必須） LOOP_COMMANDS 登録・Codex セットアップ完了後、作業を開始する前に、以下の確認チェックリストを出力してください。 ``` -=== ClaudeOS v7.4 指示確認 === +=== ClaudeOS v7.5 指示確認 === [✅/❌] 01 セッション開始・Codex設定・実行方針 [✅/❌] 02 コア構造・マルチプロジェクト・Goal Driven [✅/❌] 03 state.json スキーマ・優先順位AI