Communitygithub.com

実装計画実行ツール

tasks.md で定義された全タスクを処理・実行することで実装計画を遂行します。

実装計画実行ツール とは?

このスキルは、プロジェクト内の `tasks.md` に記述されたタスク一覧を読み込み、定義された順序と依存関係に基づいて実装を自動的に実行します。開発者は、あらかじめ `tasks.md` にタスクを詳細に記述しておくことで、環境構築、テスト駆動開発、コード実装、結合、最終調整に至るまで、一貫したワークフローを本スキルに委ねることができます。 本スキルは、実装の前後に拡張フック (`hooks.before_implement` / `hooks.after_implement`) をチェックし、`.specify/extensions.yml` に定義された任意または必須のフックを適切に実行します。これにより、git コミットやコードレビュー依頼など、外部ツールとの連携を実装プロセスの中に組み込むことが可能です。 また、実装着手前にチェックリスト (`checklists/` ディレクトリ) の状態を確認し、未チェック項目がある場合はユーザーに確認を求めます。これにより、品質要件が満たされていない状態での実装進行を防ぎます。タスク実行後は完了報告を出力し、すべてのタスクが完了したことを確認します。主に Claude Code や Cursor などの AI エージェント環境での使用を想定しており、.specify ディレクトリ構造を活用したプロジェクト管理と親和性が高い設計です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-implement

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ユーザー入力

$ARGUMENTS

手順を進める前に、ユーザー入力(空でない場合)を必ず考慮してください。

実行前チェック

拡張フックの確認(実装前):

  • プロジェクトルートに .specify/extensions.yml が存在するか確認します。
  • 存在する場合は、それを読み込み、hooks.before_implement キー配下のエントリを探します。
  • YAML をパースできない、または無効な場合は、黙ってスキップせず、.specify/extensions.yml が読み取れなかったこと(パーサーエラーを含む)と、そこで登録されている必須 (optional: false) フックを含め、いかなるフックもチェックされなかったことをユーザーに伝え、その後通常通り続行します。
  • enabled が明示的に false のフックは除外します。enabled フィールドがないフックは、デフォルトで有効として扱います。
  • 残りの各フックについて、フックの condition 式の解釈や評価を試みてはいけません:
    • フックに condition フィールドがない、または null/空の場合、そのフックを実行可能とみなします。
    • フックに空でない condition が定義されている場合、そのフックはスキップし、条件評価は HookExecutor の実装に委ねます。
  • フックコマンド名からコマンド呼び出しを構築する際は、ドット (.) をハイフン (-) に置き換えます。例: speckit.git.commit → /speckit-git-commit。
  • 実行可能な各フックについて、その optional フラグに基づいて以下を出力します:
    • オプションフック (optional: true):
      ## 拡張フック
      
      **オプションの事前フック**: {extension}
      コマンド: `/{command}`
      説明: {description}
      
      プロンプト: {prompt}
      実行するには: `/{command}`
      
    • 必須フック (optional: false):
      ## 拡張フック
      
      **自動事前フック**: {extension}
      実行中: `/{command}`
      EXECUTE_COMMAND: {command}
      
      アウトラインに進む前に、フックコマンドの結果を待機します。
      
      上記ブロックを出力した後、実際にフックを呼び出し、続行する前に完了を待たなければなりません。このエージェント/セッションで自分自身がコマンドを実行するのと同じ方法で実行します(呼び出し方法は上記のリテラルな {command} ID と異なる場合があります。例えば、スキルモードのエージェントは /skill:speckit-... や $speckit-... として実行します)。ブロックを出力するだけではフックは実行されません。
  • フックが登録されていない、または .specify/extensions.yml が存在しない場合は、黙ってスキップします。

アウトライン

  1. リポジトリルートから .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks を実行し、FEATURE_DIR と AVAILABLE_DOCS リストをパースします。すべてのパスは絶対パスでなければなりません。引数に "I'm Groot" のようなシングルクォートが含まれる場合は、エスケープ構文(例: 'I'''m Groot'、または可能であればダブルクォート "I'm Groot")を使用してください。

  2. チェックリストの状態を確認(FEATURE_DIR/checklists/ が存在する場合):

    • チェックリストのマーカーは読み取り専用のゲートとして扱います: チェックボックスの状態をスキャンし、ステータスを報告し、必要に応じて進む前に確認を求めます。チェックリストファイルやマーカーは変更しないでください。

    • checklists/requirements.md は /speckit-specify と /speckit-clarify によって管理される組み込みの仕様品質チェックリストです。/speckit-checklist によって生成されるカスタムチェックリストは、レビュー担当者が所有する要件品質レビューの成果物です。

    • カスタムチェックリストの場合、[x] はレビュー担当者が要件品質の基準を満たしていると判断したことを意味します。実装作業が完了したことを意味するわけではありません。

    • checklists/ ディレクトリ内のすべてのチェックリストファイルをスキャンします。

    • 各チェックリストについて、以下をカウントします:

      • 全項目: - [ ] または - [X] または - [x] に一致するすべての行
      • チェック済み項目: - [X] または - [x] に一致する行
      • 未チェック項目: - [ ] に一致する行
    • ステータス表を作成します:

      | チェックリスト  | 全項目 | チェック済み | 未チェック | ステータス |
      |----------------|--------|-------------|-----------|----------|
      | ux.md          | 12     | 12          | 0         | ✓ PASS   |
      | test.md        | 8      | 5           | 3         | ✗ FAIL   |
      | security.md    | 6      | 6           | 0         | ✓ PASS   |
      
    • 全体のステータスを計算:

      • PASS: すべてのチェックリストで未チェック項目が 0
      • FAIL: 1 つ以上のチェックリストに未チェック項目がある
    • いずれかのチェックリストに未チェック項目がある場合:

      • 未チェック項目数の表を表示します
      • 停止し、ユーザーに確認します: 「いくつかのチェックリストに未チェック項目があります。それでも実装を続行しますか?(yes/no)」
      • 続行する前にユーザーの応答を待ちます
      • ユーザーが "no"、"wait"、"stop" のいずれかを答えた場合、実行を停止します
      • ユーザーが "yes"、"proceed"、"continue" のいずれかを答えた場合、ステップ 3 に進みます
    • すべてのチェックリストがチェック済みの場合:

      • すべてのチェックリストが合格したことを示す表を表示します
      • 自動的にステップ 3 に進みます
  3. 実装コンテキストをロードして分析します:

    • 必須: tasks.md を読み込み、完全なタスクリストと実行計画を取得します
    • 必須: plan.md を読み込み、技術スタック、アーキテクチャ、ファイル構造を取得します
    • 存在する場合: data-model.md を読み込み、エンティティとリレーションシップを取得します
    • 存在する場合: contracts/ を読み込み、API 仕様とテスト要件を取得します
    • 存在する場合: research.md を読み込み、技術的な決定事項と制約を取得します
    • 存在する場合: .specify/memory/constitution.md を読み込み、ガバナンス制約を取得します
    • 存在する場合: quickstart.md を読み込み、統合シナリオを取得します
  4. プロジェクトセットアップの検証:

    • 必須: 実際のプロジェクトセットアップに基づいて、無視ファイルを作成/検証します:

    検出および作成ロジック:

    • 以下のコマンドが成功するかどうかを確認し、リポジトリが git リポジトリであるかどうかを判断します(その場合、.gitignore を作成/検証します):

      git rev-parse --git-dir 2>/dev/null
      
    • Dockerfile* が存在するか、plan.md に Docker の記載があるか確認 → .dockerignore を作成/検証

    • .eslintrc* が存在するか確認 → .eslintignore を作成/検証

    • eslint.config.* が存在するか確認 → 設定の ignores エントリが必須パターンをカバーしていることを確認

    • .prettierrc* が存在するか確認 → .prettierignore を作成/検証

    • .npmrc または package.json が存在するか確認 → .npmignore を作成/検証(公開する場合)

    • terraform ファイル (*.tf) が存在するか確認 → .terraformignore を作成/検証

    • .helmignore が必要か確認(Helm チャートが存在する場合)→ .helmignore を作成/検証

    無視ファイルが既に存在する場合: 必須パターンが含まれていることを確認し、不足している重要なパターンのみを追加します 無視ファイルが存在しない場合: 検出されたテクノロジーに対応する完全なパターンセットで作成します

    テクノロジー別の共通パターン(plan.md の技術スタックに基づく):

    • Node.js/JavaScript/TypeScript: node_modules/, dist/, build/, *.log, .env*
    • Python: __pycache__/, *.pyc, .venv/, venv/, dist/, *.egg-info/
    • Java: target/, *.class, *.jar, .gradle/, build/
    • C#/.NET: bin/, obj/, *.user, *.suo, packages/
    • Go: *.exe, *.test, vendor/, *.out
    • Ruby: .bundle/, log/, tmp/, *.gem, vendor/bundle/
    • PHP: vendor/, *.log, *.cache, *.env
    • Rust: target/, debug/, release/, *.rs.bk, *.rlib, *.prof*, .idea/, *.log, .env*
    • Kotlin: build/, out/, .gradle/, .idea/, *.class, *.jar, *.iml, *.log, .env*
    • C++: build/, bin/, obj/, out/, *.o, *.so, *.a, *.exe, *.dll, .idea/, *.log, .env*
    • C: build/, bin/, obj/, out/, *.o, *.a, *.so, *.exe, *.dll, autom4te.cache/, config.status, config.log, .idea/, *.log, .env*
    • Swift: .build/, DerivedData/, *.swiftpm/, Packages/
    • R: .Rproj.user/, .Rhistory, .RData, .Ruserdata, *.Rproj, packrat/, renv/
    • ユニバーサル: .DS_Store, Thumbs.db, *.tmp, *.swp, .vscode/, .idea/

    ツール固有のパターン:

    • Docker: node_modules/, .git/, Dockerfile*, .dockerignore, *.log*, .env*, coverage/
    • ESLint: node_modules/, dist/, build/, coverage/, *.min.js
    • Prettier: node_modules/, dist/, build/, coverage/, package-lock.json, yarn.lock, pnpm-lock.yaml
    • Terraform: .terraform/, *.tfstate*, *.tfvars, .terraform.lock.hcl
    • Kubernetes/k8s: *.secret.yaml, secrets/, .kube/, kubeconfig*, *.key, *.crt
  5. tasks.md の構造を解析し、以下を抽出します:

    • タスクフェーズ: セットアップ、テスト、コア、統合、仕上げ
    • タスク依存関係: 逐次実行と並列実行のルール
    • タスク詳細: ID、説明、ファイルパス、並列マーカー [P]
    • 実行フロー: 順序と依存関係の要件
  6. タスク計画に従って実装を実行します:

    • フェーズごとの実行: 各フェーズを完了してから次のフェーズに進みます
    • 依存関係を尊重: 逐次タスクは順番に実行し、並列タスク [P] は一緒に実行できます
    • TDD アプローチに従う: 対応する実装タスクの前にテストタスクを実行します
    • ファイルベースの調整: 同じファイルに影響するタスクは逐次実行する必要があります
    • 検証チェックポイント: 各フェーズの完了を確認してから先に進みます
  7. 実装実行ルール:

    • セットアップを最初に: プロジェクト構造、依存関係、設定を初期化します
    • コードより先にテスト: コントラクト、エンティティ、統合シナリオのテストを作成する必要がある場合
    • コア開発: モデル、サービス、CLI コマンド、エンドポイントを実装します
    • 統合作業: データベース接続、ミドルウェア、ロギング、外部サービス
    • 仕上げと検証: 単体テスト、パフォーマンス最適化、ドキュメント
  8. 進捗状況の追跡とエラー処理:

    • 各タスク完了後に進捗を報告します
    • 非並列タスクが失敗した場合は実行を停止します
    • 並列タスク [P] の場合は、成功したタスクを続行し、失敗したタスクを報告します
    • デバッグ用のコンテキストを含む明確なエラーメッセージを提供します
    • 実装を続行できない場合、次のステップを提案します
    • 重要: 完了したタスクについては、tasks ファイルでタスクを [X] としてマークしてください。
  9. 完了検証:

    • すべての必須タスクが完了したことを確認します
    • 実装された機能が元の仕様と一致することを確認します
    • テストが合格し、カバレッジが要件を満たしていることを検証します
    • 実装が技術計画に従っていることを確認します

注: このコマンドは、tasks.md に完全なタスクの内訳が存在することを前提としています。タスクが不完全または欠落している場合は、/speckit-tasks を実行してタスクリストを再生成することを提案します。

必須の実行後フック

完了をユーザーに報告する前に、このセクションを必ず完了してください。

プロジェクトルートに .specify/extensions.yml が存在するか確認します。

  • 存在しない場合、または hooks.after_implement キー配下にフックが登録されていない場合は、完了報告にスキップします。
  • 存在する場合は、それを読み込み、hooks.after_implement キー配下のエントリを探します。
  • YAML をパースできない、または無効な場合は、黙ってスキップせず、.specify/extensions.yml が読み取れなかったこと(パーサーエラーを含む)と、そこで登録されている必須 (optional: false) フックを含め、いかなるフックもチェックされなかったことをユーザーに伝え、その後完了報告に進みます。
  • enabled が明示的に false のフックは除外します。enabled フィールドがないフックは、デフォルトで有効として扱います。
  • 残りの各フックについて、フックの condition 式の解釈や評価を試みてはいけません:
    • フックに condition フィールドがない、または null/空の場合、そのフックを実行可能とみなします。
    • フックに空でない condition が定義されている場合、そのフックはスキップし、条件評価は HookExecutor の実装に委ねます。
  • フックコマンド名からコマンド呼び出しを構築する際は、ドット (.) をハイフン (-) に置き換えます。例: speckit.git.commit → /speckit-git-commit。
  • 実行可能な各フックについて、その optional フラグに基づいて以下を出力します:
    • 必須フック (optional: false) — 必須フックごとに EXECUTE_COMMAND: を必ず出力しなければなりません:
      ## 拡張フック
      
      **自動フック**: {extension}
      実行中: `/{command}`
      EXECUTE_COMMAND: {command}
      
      上記ブロックを出力した後、実際にフックを呼び出し、続行する前に完了を待たなければなりません。このエージェント/セッションで自分自身がコマンドを実行するのと同じ方法で実行します(呼び出し方法は上記のリテラルな {command} ID と異なる場合があります。例えば、スキルモードのエージェントは /skill:speckit-... や $speckit-... として実行します)。ブロックを出力するだけではフックは実行されません。
    • オプションフック (optional: true):
      ## 拡張フック
      
      **オプションフック**: {extension}
      コマンド: `/{command}`
      説明: {description}
      
      プロンプト: {prompt}
      実行するには: `/{command}`
      

完了報告

完了した作業の概要を含む最終ステータスを報告します。

完了条件

  • tasks.md のすべてのタスクが完了し、[X] でマークされている
  • 実装が仕様、計画、テストカバレッジに対して検証されている
  • 上記「必須の実行後フック」のルールに従って、拡張フックがディスパッチまたはスキップされている
  • 完了した作業の概要とともにユーザーに完了が報告されている

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

関連スキル