mcpField
T
to-issues

to-issues

github.com/vinvcn開発5.4k2.1k 回インストール1 日前に更新
リポジトリ

to-issues について

計画を独立して着手できる垂直スライスの issue に分解し、ユーザーの承認後に依存順で公開するスキルです。エンドツーエンドで検証できる作業項目を作りたいチーム向けです。

主な機能

  1. 01エンドツーエンドのスライス分解
  2. 02HITL と AFK の分類
  3. 03分解案への承認確認
  4. 04依存順での issue 公開
  5. 05定型 issue 本文の適用

活用シーン

  1. 01機能計画を実行可能な issue に変換
  2. 02個別に検証できるスライスの設計
  3. 03issue 間の依存関係の記録
  4. 04既存の親 issue から作業を分割

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill to-issues

インストール後、Claude Code で/to-issuesを入力して読み込まれたか確認します。

詳細

To Issues

Vertical slice（tracer bullet）を使って、計画を個別に取り組める issue tracker の issue に分割します。

Issue tracker と triage label の語彙はすでに提供されているはずです。提供されていない場合は、/setup-matt-pocock-skills を実行してください。

Process

1. Gather context

conversation context にすでにある内容をもとに作業します。ユーザーが issue reference（issue number、URL、または path）をパラメーターとして渡した場合は、issue tracker から取得し、body と comments をすべて読みます。

2. Explore the codebase (optional)

まだ codebase を調査していない場合は、現在のコードの状態を把握するために調査します。Issue のタイトルと説明では、プロジェクトの domain glossary の語彙を使用し、関連する ADR に従います。

3. Draft vertical slices

計画を tracer bullet issue に分割します。各 issue は、1 つのレイヤーだけを対象とする horizontal slice ではなく、すべての integration layer を end-to-end で通る、薄い vertical slice です。

Slice は HITL または AFK にできます。HITL slice には、architecture decision や design review など、人間によるやり取りが必要です。AFK slice は、人間とのやり取りなしで実装してマージできます。できる限り AFK を優先します。

- 各 slice は、すべてのレイヤー（schema、API、UI、tests）を通る、狭くても COMPLETE なパスを提供します - 完了した slice 単体でデモまたは検証が可能です - 厚い slice を少数作るより、薄い slice を多数作ることを優先します
4. Quiz the user

提案する分割案を番号付きリストで示します。各 slice について、次の項目を表示します。

  • Title：短い説明名
  • Type：HITL / AFK
  • Blocked by：先に完了する必要がある他の slice（該当する場合）
  • User stories covered：対象となる user story（source material に含まれている場合）

ユーザーに次の点を確認します。

  • Granularity は適切ですか？（粗すぎる／細かすぎる）
  • Dependency relationships は正しいですか？
  • 一部の slice をまとめる、またはさらに分割する必要がありますか？
  • HITL と AFK のマークは正しいですか？

ユーザーが分割案を承認するまで、反復します。

5. Publish the issues to the issue tracker

承認された各 slice について、新しい issue を issue tracker に公開します。以下の issue body template を使用します。これらの issue は、AFK agent がすぐに対応できる状態とみなされます。別途指示がない限り、公開時に適切な triage label を適用します。

実際の issue identifier を「Blocked by」フィールドで参照できるように、依存関係の順序（blocker を先に）で issue を公開します。

## Parent

issue tracker 内の parent issue への参照（source が既存の issue の場合。そうでなければ、このセクションを省略します）。

What to build

この vertical slice の簡潔な説明。レイヤーごとの実装手順ではなく、end-to-end の動作を説明します。

具体的な file path や code snippet は避けてください。すぐに古くなるためです。例外として、prototype の snippet が、ある決定（state machine、reducer、schema、type shape）を prose よりも正確に表現している場合は、ここにインラインで含め、prototype 由来であることを簡潔に説明できます。意思決定に重要な部分だけを残し、動作する demo 全体は含めないでください。

Acceptance criteria

  • Criterion 1
  • Criterion 2
  • Criterion 3

Blocked by

  • blocker となる issue への参照（該当する場合）

blocker がない場合は、"None - can start immediately" と記載します。

parent issue を close または modify しないでください。

コメント

Markdown 対応