Communitygithub.com

reels-blocker

既存のタスクを、依存関係順に整理されたアクション可能なGitHub Issueに変換します。利用可能な設計成果物に基づいて機能ごとにIssueを作成します。

reels-blocker とは?

このスキル(`tangjuyo/reels-blocker`)は、プロジェクト内のタスク一覧(`tasks.md`)に記述された各タスクを、GitHubリポジトリ上のIssueとして自動的に作成するためのツールです。タスクID(例: `T001`)を抽出し、既存のIssueとの重複をチェックした上で、まだIssue化されていないタスクに対してのみ、タイトル形式 `T001: <説明>` でIssueを作成します。スキルは `.specify/extensions.yml` に定義された拡張フック(フック前後)をサポートし、必須フックは自動実行、オプションフックはユーザーにプロンプトを表示します。GitリモートがGITHUB URLであることを確認してから処理を進めるため、誤ったリポジトリへの書き込みを防止します。対応プラットフォームはSpecify(Claude Codeなどのエージェント上で動作するスキルモード)を想定しており、GitHub MCPサーバーを利用してIssueを管理します。

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

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

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

ドキュメント

ユーザー入力

$ARGUMENTS

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

事前実行チェック

(タスク→Issue変換前の)拡張フックの確認:

  • プロジェクトルートに .specify/extensions.yml が存在するか確認します。
  • 存在する場合は、そのファイルを読み込み、hooks.before_taskstoissues キーのエントリを探します。
  • 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. 存在する場合: プロジェクトの原則とガバナンス制約について .specify/memory/constitution.md を読み込みます。
  3. 実行したスクリプトから、タスクへのパスを抽出します。
  4. 以下のコマンドを実行して Git リモートを取得します:
git config --get remote.origin.url

[!CAUTION] リモートが GITHUB URL である場合にのみ、次のステップに進んでください。

  1. 既存のIssueを重複排除のために取得する: 何かを作成する前に、tasks.md から処理しようとしているタスクIDのセットを構築します(各IDは T の後に少なくとも3桁の数字が続きます。例: T001 — /speckit-converge は T{M+1:03d} 形式で新しいIDを割り当てます。これは上限ではなく下限であるため、ファイルに999を超えるタスクがある場合、IDは4桁以上になります)。次に、GitHub MCP サーバーの list_issues ツールを使用して、それらのIDを既にカバーしているIssueを探します。state 値を渡さないでください(省略すると、ツールはオープンなIssueとクローズされたIssueの両方を返します)。リクエストには perPage: 100 を指定して呼び出し回数を抑え、ツールがカーソルベースのページネーションを使用するため、前のレスポンスの endCursor を使って after パラメータでページをリクエストします。各Issueのタイトルについて、タスクIDパターン \bT\d{3,}\b({3,} は4桁以上のIDも受け入れます — \d{3} の場合、タイトルに T1000 が含まれていてもまったく一致しません。なぜなら末尾の \b が2桁の数字の間に位置できないため、そのタスクは黙って重複排除も作成もされません。ワード境界は依然として ST001 のようなトークンが一致するのを防ぎ、数字の連続全体を消費するため T100 が T1000 内で一致することはありません。これにより、T001 ...、T001: ...、[T001] ... のように書かれたタイトルも認識されます)と照合し、タスクIDのいずれかに一致した場合、そのIDは既にIssueがあるものとしてマークします。すべてのタスクIDが一致した時点、またはそれ以上ページがない時点でページネーションを停止し、すべてのタスクIDが確認された後はリポジトリ全体のIssue履歴を取得し続けないようにします。これにより、Issue履歴が大量にあるリポジトリでの呼び出し回数が制限され、tasks.md が再生成されたりスキルが再呼び出しされたりした場合でも重複を防ぐことができます。
  2. リスト内の各タスクについて、GitHub MCP サーバーを使用して、Git リモートを表すリポジトリに新しいIssueを作成します。tasks.md のタスク行は Markdown チェックボックスで始まるため、まず先頭の - [ ](および任意の [P] / [US#] マーカー)を取り除き、タスクIDとその説明を復元します。Issueは T001: <説明> の形式の単一の正規タイトルで作成します。IDは1回記述し、その後にタスクの説明を続けます(例: - [ ] T001 Create project structure という行は、タイトル T001: Create project structure になります)。
    • 前のステップの既存IssueセットにIDが既に存在するタスクはスキップし、その旨を報告します(例: T001 は既にIssueが存在するためスキップします)。
    • 一致するIssueがまだ存在しないタスクに対してのみIssueを作成します。

[!CAUTION] リモートURLと一致しないリポジトリにIssueを作成することは、決して行わないでください。

事後実行チェック

(タスク→Issue変換後の)拡張フックの確認: プロジェクトルートに .specify/extensions.yml が存在するか確認します。

  • 存在する場合は、そのファイルを読み込み、hooks.after_taskstoissues キーのエントリを探します。
  • 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 が存在しない場合は、黙ってスキップします。

Individual skills in this repo

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

関連スキル