amplihack-expert について
amplihack-expert は、amplihack エンジニアリングシステムの知識とナビゲーションを提供するスキルです。Claude、Copilot、Amplifier で開発するユーザー向けに、コマンドやワークフロー、エージェントの構成と `/dev` のタスク分類・オーケストレーションを説明します。
主な機能
- 015つの中核メカニズムの解説
- 02コマンドとワークフローの一覧
- 03エージェントの役割の説明
- 04`/dev` によるタスク編成の説明
- 05セッションツリー制限と状態表示
活用シーン
- 01複雑な開発タスクの開始方法を選択
- 02並行する作業の分割
- 03分析、修正、テストの担当を確認
- 04編成結果と目標状態を追跡
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/amplihack-expertを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
examples.mdreference.mdtests/__init__.pytest_amplihack_expert_skill.py詳細
amplihack の専門知識
amplihack とは？
コーディング CLI（Claude、Copilot、Amplifier）向けのエンジニアリングシステムです。5 つのメカニズム、23 ステップのワークフロー、30 以上のエージェント、80 以上のスキルを備えています。中核となるエントリーポイントは /dev <task> です。自動分類、並列ワークストリームの検出、目標達成を目指す実行ループを備えた、タスク統合オーケストレーターです。
クイックリファレンス
主なコマンド
| コマンド | 目的 | 使用する場面 |
|---|---|---|
| /dev | オーケストレーション | あらゆる複雑なタスク |
| /analyze | レビュー | 準拠状況の確認 |
| /fix | エラーの修正 | よくあるエラーパターン |
| /amplihack:ddd:* | ドキュメント駆動開発 | 10 ファイル以上の機能 |
| /multitask | 並列タスク | スプリント／バッチ作業 |
主なエージェント
| エージェント | 役割 |
|---|---|
| architect | 設計 |
| builder | コード作成 |
| reviewer | 品質 |
| tester | テスト |
ワークフロー
| 名前 | ステップ数 |
|---|---|
| DEFAULT_WORKFLOW | 23 |
| INVESTIGATION | 6 |
| FIX | 3 |
ナビゲーションガイド
クイック：SKILL.md | アーキテクチャ：reference.md | 使い方：examples.md | 詳細：すべて
中核となる概念
5 つのメカニズム： ワークフロー（プロセス）、コマンド（エントリー）、スキル（自動）、エージェント（委任）、フック（ランタイム）
構成： コマンド → ワークフロー → エージェント → スキル
実行： /dev がオーケストレーションを行います。タスクを分類し、並列ワークストリームを検出して、smart-orchestrator レシピを使って実行します。目標達成を目指すループは最大 3 ラウンドです。
エントリーポイント： /dev <task> → dev-orchestrator スキル → smart-orchestrator レシピ → default-workflow レシピ
dev-orchestrator のアーキテクチャ
エントリーポイント：/dev <task> または複雑なプロンプト
ルーティング：
- Q&A →
amplihack:core:analyzerが直接応答 - 操作 → bash（簡単なもの）または
amplihack:core:builder（複雑なもの） - 開発／調査 → smart-orchestrator レシピ（完全なオーケストレーション）
実行フロー：
- タスクを分類します（architect エージェント → JSON に分解）
- ワークストリームを検出します（1 件 = 単一セッション、2～5 件 = multitask による並列処理）
- セッションツリーにセッションを登録します（深さ／容量を適用）
- ラウンドを実行します（最大 3 回、目標達成を目指す振り返りループ）
- PR リンクと GOAL_STATUS を含めて結果を要約します
セッションツリー：無限再帰を防止します
AMPLIHACK_MAX_DEPTH=3（デフォルト） — 深いオーケストレーションでは 5 に増やしますAMPLIHACK_MAX_SESSIONS=10（デフォルト） — ツリーごとの同時セッション数の上限
ステータスシグナル：
GOAL_STATUS: ACHIEVED— すべての基準を満たしていますGOAL_STATUS: PARTIAL -- [gaps]— もう 1 ラウンド実行されますGOAL_STATUS: NOT_ACHIEVED -- [reason]— 最終的な失敗ステータス
関連ドキュメント
- reference.md：アーキテクチャ（5 つのメカニズム、5 つのレイヤー、フック）
- examples.md：シナリオ（5 件以上の実例）
- @~/.amplihack/.claude/context/PHILOSOPHY.md：中核となる原則
- @~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md：23 ステップ
- @~/.amplihack/.claude/agents/amplihack/：すべてのエージェント
- @~/.amplihack/.claude/commands/amplihack/：すべてのコマンド
- @~/.amplihack/.claude/tools/amplihack/hooks/：フックシステム
- amplifier-bundle/recipes/smart-orchestrator.yaml：中核となるオーケストレーションレシピ
- amplifier-bundle/tools/session_tree.py：再帰ガード（深さ制限）
- amplifier-bundle/tools/orch_helper.py：JSON 抽出ヘルパー