octopus-quick

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

クイックモード - 軽量なタスク実行 ⚡

Double Diamond ワークフローの全工程を必要としない小規模なタスクを、迅速に実行します。

クイックモードを使用する場面

✅ クイックモードの使用に適したタスク：

バグ修正：

• 解決方法がわかっている、1 ファイルのバグ修正
• 誤字の修正
• ロジックエラーの修正
• インポート／エクスポートの修正

設定の変更：

• 環境変数の更新
• 設定ファイルの変更
• 設定の調整
• 依存関係の更新

小規模なリファクタリング：

• 変数／関数の名前変更
• ヘルパー関数の抽出
• 1 ファイル内のロジックの簡素化
• コードの整理

ドキュメント：

• README の誤字修正
• コメントの更新
• ドックストリングの追加／更新
• ドキュメントの明確化

依存関係の管理：

• パッケージのバージョン更新
• 新しい依存関係の追加
• 未使用の依存関係の削除

❌ クイックモードの使用に適さないタスク：

複雑な作業：

• 新機能
• アーキテクチャの変更
• 複数ファイルにわたるリファクタリング
• セキュリティに関わる変更
• 調査が必要なパフォーマンス最適化
• データベーススキーマの変更
• API 契約の変更

品質を確保するため、複雑な作業には完全なワークフローを使用してください。

実行フロー

クイックモードでは、手順を簡略化して実行します。

User Request → Direct Implementation → Atomic Commit → Summary

クイックモードで省略するもの：

• ❌ 複数 AI による調査（probe/discover）
• ❌ 要件の計画（grasp/define）
• ❌ 複数 AI による検証（ink/deliver）
• ❌ プランチェッカーによる検証

クイックモードで維持するもの：

• ✅ 状態の追跡（state.json に記録）
• ✅ アトミックコミット（説明を付けた git commit）
• ✅ 要約の生成（.claude-octopus/quick/ に保存）
• ✅ 変更のドキュメント化

使用方法

コマンドを使用する場合

/octo:quick "add dark mode toggle to settings"

スキルを呼び出す場合

Use skill: octopus-quick
Task: "fix typo in README.md line 42"

例

/octo:quick "update Next.js to v15"
/octo:quick "fix the broken import in auth.ts"
/octo:quick "add error handling to login function"
/octo:quick "remove console.log statements"

実装

ステップ 1：タスクを把握する

次の点をすばやく確認します。

• 変更が必要なファイルはどれですか？
• 具体的にどのような変更が必要ですか？
• 依存関係や副作用はありますか？

ステップ 2：変更を加える

適切なツールを使用して直接実装します。

• Edit - 既存ファイルを変更する場合
• Write - 新しいファイルを作成する場合（クイックモードではまれ）
• Bash - ファイル操作や依存関係の更新を行う場合

ステップ 3：アトミックコミットを作成する

必ず内容がわかるコミットを作成してください。

# Stage changes
git add [changed-files]

# Create commit with clear message
git commit -m "quick: [brief description]

[Detailed explanation if needed]

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>"

コミットメッセージの形式：

• クイックモードを示す quick: を先頭に付ける
• 現在形で簡潔に説明する
• 詳細な説明は任意
• 共著者タグ

ステップ 4：状態に記録する

# Update state with quick task execution
"${HOME}/.claude-octopus/plugin/scripts/state-manager.sh" write_decision \
  "quick" \
  "$(git log -1 --pretty=%s)" \
  "Ad-hoc task executed in quick mode"

# Update metrics
"${HOME}/.claude-octopus/plugin/scripts/state-manager.sh" update_metrics \
  "execution_time" \
  "1"  # Estimated in minutes

ステップ 5：要約を生成する

# Create quick task summary
mkdir -p .claude-octopus/quick

summary_file=".claude-octopus/quick/$(date +%Y%m%d-%H%M%S)-summary.md"

cat > "$summary_file" <<EOF
# Quick Task: $(git log -1 --pretty=%s)

## Task Description
$TASK_DESCRIPTION

## Changes Made
$(git diff HEAD~1..HEAD --stat)

## Files Modified
$(git diff --name-only HEAD~1..HEAD)

## Commit
$(git rev-parse HEAD)

## Timestamp
$(date -u +%Y-%m-%dT%H:%M:%SZ)

*Executed in Quick Mode - minimal overhead execution*
EOF

echo "📝 Summary saved to: $summary_file"

完全な例

ユーザーのリクエスト：

/octo:quick "fix typo in README - change 'recieve' to 'receive'"

実行：

1. ファイルを読む

   Read README.md to locate the typo
   

2. 変更を加える

   Edit README.md: replace "recieve" with "receive"
   

3. アトミックにコミットする

   git add README.md
   git commit -m "quick: fix typo in README (recieve → receive)
   
   Co-Authored-By: Claude Sonnet 4.6 <[email protected]>"
   

4. 状態に記録する

   state-manager.sh write_decision "quick" \
     "Fixed typo in README" \
     "Ad-hoc documentation fix"
   

5. 要約を生成する

   Created: .claude-octopus/quick/20260129-143045-summary.md
   

6. ユーザーに報告する

   ✅ Fixed typo in README.md
   📝 Commit: abc123f
   📋 Summary: .claude-octopus/quick/20260129-143045-summary.md
   

クイックモードの利点

スピード ⚡

• 複数 AI を連携させるオーバーヘッドがない
• 直接実装できる
• 単純なタスクをより速く処理できる

コスト削減 💰

• 外部プロバイダーの API 呼び出しが不要
• Claude のみを使用（Claude Code に含まれています）
• アドホックな作業に効率的

追跡も継続 📊

• コミットを記録
• 状態を更新
• 要約を生成
• 完全な監査証跡を維持

適切な範囲 🎯

• 小規模なタスクに適したツール
• 単純な変更を過剰に設計しない
• 複雑な作業には完全なワークフローを使用

クイックモードでは不十分な場合

実行中に、タスクが想定より複雑だとわかった場合：

いったん停止し、完全なワークフローに切り替えてください。

This task is more complex than anticipated. I recommend using the full
workflow instead:

- For research: /octo:discover "research authentication patterns"
- For planning: /octo:define "define auth requirements"
- For building: /octo:develop "implement auth system"
- For validation: /octo:deliver "validate auth implementation"

Would you like me to switch to a full workflow?

切り替えを検討する目安：

• 複数のファイルを変更する必要がある
• アーキテクチャ上の判断が必要
• 調査や比較が必要
• セキュリティへの影響がある
• パフォーマンスへの影響がある
• 互換性を損なう変更がある

ディレクトリ構成

クイックモードでは、専用ディレクトリにサマリーを作成します。

.claude-octopus/
└── quick/
    ├── 20260129-143045-summary.md
    ├── 20260129-150122-summary.md
    └── 20260129-161530-summary.md

各サマリーには、以下の内容が含まれます。

• タスクの説明
• 実施した変更
• 変更したファイル
• コミットハッシュ
• タイムスタンプ

比較：クイックモードとフルワークフロー

項目	クイックモード ⚡	フルワークフロー 🐙
所要時間	1～3 分	5～15 分
コスト	Claude のみ	Claude と利用可能な外部プロバイダー
プロバイダー	1（Claude）	利用可能なプロバイダー群
調査	なし	包括的
計画	なし	詳細
検証	基本	複数の AI によるレビュー
最適な用途	シンプルな修正	複雑な機能
使用するタイミング	解決策が分かっている場合	解決策が分からない場合

ベストプラクティス

推奨事項：

• ✅ 単純なタスクにはクイックモードを使用します
• ✅ 内容が分かりやすいコミットメッセージを作成します
• ✅ 監査証跡としてサマリーを生成します
• ✅ クイックモードでも状態を更新します
• ✅ 複雑さが増したらフルワークフローに切り替えます

禁止事項：

• ❌ 新機能にクイックモードを使用しないでください
• ❌ コミットを省略しないでください（常にアトミックにコミットします）
• ❌ 状態の更新を省略しないでください（整合性を維持します）
• ❌ セキュリティ上重要な変更にクイックモードを使用しないでください
• ❌ フルワークフローが適切な場合に、クイックモードを無理に使用しないでください

トラブルシューティング

「クイックモードに時間がかかりすぎる」

→ タスクが複雑すぎる可能性があります。フルワークフローに切り替えてください。

「変更によってテストが失敗する」

→ クイックモードは単純で安全な変更を想定しています。リスクのある変更にはフルワークフローを使用してください。

「最適な方法を調査する必要がある」

→ クイックモードは、解決策が分かっている場合にのみ使用します。調査には /octo:discover を使用してください。

「複数のファイルを変更する必要がある」

→ 複数ファイルにわたる変更を連携して進めるには、/octo:develop の使用を検討してください。

まとめ

クイックモードは、解決策が分かっている単純明快なタスクに適したツールです。必要な追跡とドキュメント化を維持しながら、迅速に実行できます。

それ以外のタスクでは、複数の AI によるオーケストレーションを通じて品質を確保するため、フルの Double Diamond ワークフローを使用してください。

覚えておいてください。速さも大切ですが、正確さはそれ以上に大切です。迷ったら、フルワークフローを使用してください。