skill-status

ホスト：Codex CLI — このスキルは Claude Code 向けに設計され、Codex 用に調整されています。 相互参照するコマンドでは、/octo:* スラッシュコマンドではなく、Codex にインストールされたスキル名を使用します。 現在の Codex シェルとサブエージェントのツールを使用してください。現在のセッションで利用可能になっていないプロバイダー、モデル、ホストのサブエージェントが利用可能だと主張しないでください。 ホストのツールに相当するものについては、skills/blocks/codex-host-adapter.md を参照してください。

プロジェクトステータスダッシュボード

概要

ワークフローの状態に基づいて、現在のプロジェクトステータス、ロードマップの進捗、ブロッカー、次のアクションに関するインテリジェントな提案を表示します。

基本原則： 状態を読み取る → ダッシュボードを表示する → 適切に案内する。

使用するタイミング

ユーザーが次のように尋ねた場合に、このスキルを使用します：

• 「進捗はどうですか？」または「進捗を見せて」
• 「ワークフローのどの段階ですか？」
• 「次に何をすればいいですか？」
• 「現在のフェーズは何ですか？」
• 「ブロッカーはありますか？」
• 「これまで何に取り組んでいましたか？」または「最近の作業を要約して」
• 「プロジェクトのメモリを更新して」または「CLAUDE.md を更新して」

次の場合には使用しないでください：

• 新しいプロジェクトの作成（/octo:embrace を使用）
• 状態の変更（octo-state.sh write_state を使用）
• 詳細なフェーズ計画（flow-* スキルを使用）

プロセス

フェーズ 1：プロジェクトの初期化を確認する

ステップ 1：.octo/ ディレクトリが存在することを確認する

# Check if project is initialized
if [[ ! -d ".octo" ]]; then
    echo "No project initialized"
    exit 1
fi

.octo/ が存在しない場合：

## Project Status

**Status:** Not initialized

No Claude Octopus project found in this directory.

### Get Started

Run `/octo:embrace [your project description]` to initialize a new project and start the Double Diamond workflow.

**Example:**

/octo:embrace build a user authentication system

This will:
1. Create .octo/ directory structure
2. Initialize STATE.md, PROJECT.md, ROADMAP.md
3. Begin Discover phase (research and exploration)

ここで停止し、フェーズ 2 に進まないでください。

フェーズ 2：現在の状態を読み取る

ステップ 1：octo-state.sh read_state を実行する

# Read current state from STATE.md
./scripts/octo-state.sh read_state

想定される出力形式：

schema=1.0
last_updated=2026-02-02T10:30:00Z
current_phase=2
current_position=define-requirements
status=in_progress

ステップ 2：状態変数を解析する

主要なキーと値のペアを抽出します：

• current_phase - フェーズ番号（1～4）
• current_position - フェーズ内の具体的な位置
• status - 現在のワークフロー状態
• last_updated - 最後に状態が変更された日時

フェーズ 3：ロードマップを読む

ステップ 1：ROADMAP.md を読む

# Read roadmap for phase overview
cat .octo/ROADMAP.md

ステップ 2：フェーズ情報を抽出する

ROADMAP.md を解析して、次の情報を特定します：

• フェーズ名（Discover、Define、Develop、Deliver）
• フェーズの説明
• 各フェーズの成功基準
• フェーズ間の依存関係

フェーズ 4：ダッシュボードを表示する

ステップ 1：ステータスダッシュボードを作成する

## Project Status

**Phase:** Phase {current_phase} - {phase_name}
**Position:** {current_position}
**Status:** {status}
**Last Updated:** {last_updated}

### Roadmap Progress

- [x] Phase 1: Discover - complete
- [ ] Phase 2: Define - in_progress  <-- YOU ARE HERE
- [ ] Phase 3: Develop - not_started
- [ ] Phase 4: Deliver - not_started

### Current Phase Details

**Phase 2: Define (Grasp)**
- **Goal:** Clarify requirements and scope
- **Position:** {current_position}
- **Status:** {status}

### Blockers

{blockers or "None"}

### Suggested Next Action

{intelligent routing based on status}

ステップ 2：フェーズの完了状況を判定する

current_phase と status を完了マーカーに対応付けます：

フェーズ	ステータス	マーカー
1	complete	[x] Phase 1: Discover - complete
2	in_progress	[ ] Phase 2: Define - in_progress <-- YOU ARE HERE
3	not_started	[ ] Phase 3: Develop - not_started
4	not_started	[ ] Phase 4: Deliver - not_started

フェーズ 5：インテリジェントな案内

ステップ 1：ステータスを提案に対応付ける

次のルーティングテーブルを使用します：

ステータス	提案
ready	"ワークフローを開始するには、/octo:embrace [description] を実行します"
planning	"現在のフェーズで計画を続けます。要件を詳しくするには、/octo:define を使用します。"
building	"実装を続けます。機能を構築するには、/octo:develop を使用します。"
in_progress	"現在のフェーズを続けます。詳細は .octo/phases/phase{N}/ を確認してください。"
blocked	"上記のブロッカーを確認します。問題を追跡して解決するには、/octo:issues を使用します。"
complete	"フェーズが完了しました。次のフェーズに進むか、/octo:ship を実行して最終処理を行います。"
complete_with_gaps	"既知の未解決事項を残してフェーズが完了しました。先に進む前に .octo/ISSUES.md を確認してください。"
shipped	"プロジェクトを納品しました！振り返りのために .octo/LESSONS.md を確認してください。"
paused	"プロジェクトは一時停止中です。/octo:embrace で再開するか、状況を把握するために .octo/STATE.md を確認してください。"

ステップ 2：フェーズ固有の案内

status=in_progress の場合は、フェーズに応じたガイダンスを提示します：

フェーズ 1（Discover）：

Continue research and exploration.
- Use `/octo:research [topic]` for multi-AI research
- Use `/octo:debate [question]` for decision support

フェーズ 2（Define）：

Continue requirements clarification.
- Use `/octo:prd` to write product requirements
- Use `/octo:define` to refine scope

フェーズ 3（Develop）：

Continue implementation.
- Use `/octo:develop` to build features
- Use `/octo:tdd` for test-driven development
- Use `/octo:review` for code quality checks

フェーズ 4（Deliver）：

Continue validation and delivery.
- Use `/octo:deliver` for final review
- Use `/octo:security` for security audit
- Use `/octo:ship` to finalize delivery

出力例

例 1：プロジェクトが初期化されていない

## Project Status

**Status:** Not initialized

No Claude Octopus project found in this directory.

### Get Started

Run `/octo:embrace [your project description]` to initialize a new project and start the Double Diamond workflow.

**Example:**

/octo:embrace build a user authentication system

例 2：Define フェーズで進行中のプロジェクト

## Project Status

**Phase:** Phase 2 - Define (Grasp)
**Position:** define-requirements
**Status:** in_progress
**Last Updated:** 2026-02-02T10:30:00Z

### Roadmap Progress

- [x] Phase 1: Discover - complete
- [ ] Phase 2: Define - in_progress  <-- YOU ARE HERE
- [ ] Phase 3: Develop - not_started
- [ ] Phase 4: Deliver - not_started

### Current Phase Details

**Phase 2: Define (Grasp)**
- **Goal:** Clarify requirements and scope
- **Position:** define-requirements
- **Status:** in_progress

### Blockers

None

### Suggested Next Action

Continue requirements clarification.
- Use `/octo:prd` to write product requirements
- Use `/octo:define` to refine scope
- Check `.octo/phases/phase2/` for detailed plans

例 3：ブロックされているプロジェクト

## Project Status

**Phase:** Phase 3 - Develop (Tangle)
**Position:** implement-auth
**Status:** blocked
**Last Updated:** 2026-02-02T14:15:00Z

### Roadmap Progress

- [x] Phase 1: Discover - complete
- [x] Phase 2: Define - complete
- [ ] Phase 3: Develop - blocked  <-- YOU ARE HERE
- [ ] Phase 4: Deliver - not_started

### Current Phase Details

**Phase 3: Develop (Tangle)**
- **Goal:** Implement features
- **Position:** implement-auth
- **Status:** blocked

### Blockers

- Missing OAuth provider credentials
- Database schema not finalized
- API rate limiting not configured

### Suggested Next Action

Review blockers above. Use `/octo:issues` to track and resolve issues.

**To unblock:**
1. Configure OAuth credentials in .env
2. Finalize database schema with `/octo:define`
3. Set up rate limiting configuration

フェーズ 6: 最近のアクティビティのサマリー (セッション横断)

ユーザーが「最近何に取り組んでいたか」「最近の作業を要約して」「プロジェクトメモリを更新して」と尋ねた場合、セッション横断のアクティビティサマリーを生成します。

ステップ 1: 最近のアクティビティを収集する

# Recent git commits (last 7 days or last 20 commits)
git log --oneline --since="7 days ago" --no-merges 2>/dev/null | head -20

# Recent tags/releases
git tag --sort=-creatordate | head -5

# Recent branches worked on
git branch --sort=-committerdate | head -5

# Recent orchestration results (if any)
ls -lt ~/.claude-octopus/results/ 2>/dev/null | head -10

ステップ 2: アクティビティを要約する

テーマごとにグループ化した簡潔なサマリーを作成します:

## Recent Activity (Last 7 Days)

### Commits
- [theme 1]: brief summary of related commits
- [theme 2]: brief summary of related commits

### Releases
- v8.10.0 - Antigravity CLI headless fix
- v8.9.0 - Contextual Codex model routing

### Active Branches
- main (current)

### Orchestration Sessions
- [count] workflows executed, [count] synthesis files generated

ステップ 3: CLAUDE.md の更新を提案する

最近のアクティビティに CLAUDE.md で捉えられていないパターンがある場合は、具体的な追加を提案します:

### Suggested CLAUDE.md Updates

Based on recent activity, consider adding:
- [specific suggestion based on new patterns, conventions, or decisions]
- [specific suggestion based on new tooling or workflow changes]

提案するのは、持続的なプロジェクト知識 (規約、アーキテクチャ上の決定、プロバイダー設定) を反映する更新のみにしてください — 「現在 X に取り組み中」のような一時的なステータスは含めません。

他のスキルとの連携

flow-* スキルとの連携

User asks "what's next?"
→ skill-status shows current phase
→ User runs /octo:develop to continue

skill-task-management との連携

User asks "show status"
→ skill-status displays dashboard
→ skill-task-management shows active todos

/octo:embrace との連携

User asks "status" but no .octo/ exists
→ skill-status suggests /octo:embrace
→ User initializes new project

ベストプラクティス

1. 常に最初に .octo/ を確認する

良い例:

if [[ ! -d ".octo" ]]; then
    echo "Not initialized"
    exit 1
fi

悪い例:

# Assume .octo/ exists and fail later
cat .octo/STATE.md

2. 状態の読み取りには octo-state.sh を使用する

良い例:

./scripts/octo-state.sh read_state

悪い例:

# Parse STATE.md manually
grep "Current Phase" .octo/STATE.md

3. 実行可能な次のステップを提示する

良い例:

Continue with `/octo:develop` to implement features.
Check `.octo/phases/phase3/` for implementation plan.

悪い例:

You're in phase 3.

レッドフラグ - やってはいけないこと

操作	なぜ間違っているか
STATE.md を直接変更する	代わりに octo-state.sh write_state を使用してください
.octo/ の存在確認をスキップする	混乱を招くエラーで失敗します
次のアクションを示さずにステータスを表示する	ユーザーは何をすべきかわかりません
フェーズ名をハードコードする	正確性のために ROADMAP.md から読み取ってください
ブロッカーを無視する	ユーザーは進行を妨げているものを知る必要があります

クイックリファレンス

ユーザー入力	必要なアクション
「status」	.octo/ を確認 → 状態を読み取り → ダッシュボードを表示
「what's next」	状態を読み取り → ステータス/フェーズに基づいてルーティング
「where am I」	現在のフェーズと位置を表示
「show progress」	完了マーカー付きのロードマップを表示
「any blockers」	STATE.md からブロッカーを抽出して表示
「what have I been working on」	Git ログ + 結果 → セッション横断のアクティビティサマリー
「update project memory」	アクティビティサマリー → CLAUDE.md への追加を提案

まとめ

Status check → Read state + roadmap → Display dashboard + intelligent routing
Otherwise → User doesn't know where they are or what to do next

初期化を確認する。状態を読み取る。明確に表示する。インテリジェントにルーティングする。