AGENT SKILL

pipe-requirements-to-pr

既存の AsciiDoc 要件定義書 req-*.adoc、または GitHub issue URL を起点に、要件作成、事前調査、自動壁打ち、設計文書、実装計画、品質ゲート、実装、レビュー、GitHub PR 作成・本文更新までを一気通貫で進める。ユーザーが要件または issue から PR までの全工程を依頼したときに使い、個別フェーズだけの依頼には使わない。

License 许可
MIT
最近更新
2026-11-12
Stars
★ 0
Forks
0

01 前言 Front Matter

name
pipe-requirements-to-pr
description
既存の AsciiDoc 要件定義書 req-*.adoc、または GitHub issue URL を起点に、要件作成、事前調査、自動壁打ち、設計文書、実装計画、品質ゲート、実装、レビュー、GitHub PR 作成・本文更新までを一気通貫で進める。ユーザーが要件または issue から PR までの全工程を依頼したときに使い、個別フェーズだけの依頼には使わない。

02 资源文件 4

03 SKILL.md 正文

要件から PR までのパイプライン

既存の req-*.adoc、または GitHub issue から生成した req-*.adoc を実装可能な要件へ仕上げ、計画どおりに実装し、レビュー可能な PR まで進める親スキルである。 要件定義、設計、実装計画、実装と実証はそれぞれ子パイプラインへ委譲し、この親スキルは入力の確定、工程の接続、レビュー以降を受け持つ。 単にパイプラインの相談や設計をしているだけなら実行しない。全工程の実行、またはこのスキルの明示呼び出しを確認してから開始する。

子スキルと優先順位

開始時に次のスキルを利用できることを確認し、それぞれの SKILL.md を実行する段階で最後まで読む。

  • poteto-mode-start
  • pipe-grilling-auto-to-requirements-pr
  • pipe-auto-grilling-design
  • pipe-generate-quality-gated-implementation-plan
  • pipe-implement-and-verify
  • tdd-matt-p
  • superpowers:test-driven-development
  • commit-push
  • ponytail:ponytail-review
  • shared-code-impact-review
  • user-story-review
  • review-guide
  • asciidoc-to-colorful-html
  • easy-to-understand
  • gh-update-pr

差分に TypeScript または JavaScript が含まれる場合だけ、anti-slop-code-general も利用できることを確認し、Phase 6 を始める前にその SKILL.md を最後まで読む。

GitHub issue URL を入力にする場合だけ、git-suggest-branch-name も利用できることを確認し、issue 初期化を始める前にその SKILL.md を最後まで読む。

指示が衝突する場合は、現在のユーザー指示、この親スキルの段階固有の指示、子スキルの通常指示の順に優先する。子スキルが見つからなければ、その工程を同等手順で代替せず、見つからないスキル名を報告して停止する。

poteto-mode で全工程を進める

パイプラインを始める前に poteto-mode-start を使う。 このスキルへの依頼全体を対象タスクとして渡し、以後の調査レポート作成、要件定義、設計、実装計画、実装、検証、レビュー、commit、push、PR 作成と更新を poteto-mode が有効な状態で進める。 poteto-mode がすでに有効な場合は再度呼び出さず、その状態を引き継ぐ。

入力と成果物を確定する

入力は、既存の AsciiDoc 要件定義書 req-<topic>.adoc 1件、または https://github.com/<owner>/<repo>/issues/<number> 形式の GitHub issue URL 1件とする。複数指定された場合は1件ずつ独立したパイプラインとして扱う。

  • 既存の req-*.adoc が入力なら、そのファイルを後続工程の要件定義書として今までどおり処理する。
  • GitHub issue URL が入力なら、GitHub issue から要件定義書を初期化する を読み、ブランチ、worktree、要件定義書を作成する。生成した req-*.adoc を後続工程の入力に設定し、その worktree 内で既存の流れへ合流する。
  • どちらにも該当しない入力では後続工程を始めず、必要なパスまたは URL を1つだけ確認する。

開始時に 成果物の契約 を読み、次を確定する。

  • 調査レポート: pre-investigation-report-<topic>.json
  • 設計文書: design-<issue-token>-<topic>.adoc
  • 実装計画: implementation-plan-<issue-token>-<topic>.adoc
  • 実装計画の解説 HTML: easy-implementation-plan-<issue-token>-<topic>.html
  • 要件定義書 HTML: req-<topic>.html
  • 設計文書 HTML: design-<issue-token>-<topic>.html
  • 実装計画 HTML: implementation-plan-<issue-token>-<topic>.html
  • レビューガイド: review-guide-<issue-token>-<topic>.adoc
  • レビューガイド図: review-guide-<issue-token>-<topic>-<symbol-or-flow>.svg
  • レビューガイド HTML: review-guide-<issue-token>-<topic>.html

調査レポートと確定した要件定義書は Phase 1、設計文書と必要な Quint モデルは Phase 2、実装計画は Phase 3 の子パイプラインが生成する。HTML は実装とレビュー修正を終えた Phase 8 でまとめて生成する。残りもこの親スキルが生成する。

成果物は要件定義書と同じディレクトリへ置く。ユーザーが保存先を指定した場合はその指定を優先する。

Git リポジトリ、develop、現在のブランチ、作業ツリー、適用される指示を確認する。比較先ブランチを決める。gh stack view --json の終了コードが 0 なら現在のブランチの 1 つ下のブランチ、それ以外は develop とし、以後の差分、レビュー、PR の base にはこの比較先ブランチを使う。開始時点の変更一覧を記録し、既存変更をパイプラインの変更と混ぜない。同じファイルの同じ箇所に既存変更があり、安全に保持できない場合は停止して対象を報告する。

自律実行の境界

このスキルによる全工程の実行依頼は、GitHub issue URL 入力時のブランチと worktree の作成、対象要件の作成・更新、設計文書・実装計画・レビューガイドの作成、実装、検証、対象変更の commit / push、PR の作成・更新を進める根拠になる。環境が個別承認を要求する操作は、その場で承認を求める。

推奨回答の自動採用は設計上の意思決定に限る。事実はコード、設定、文書、issue から確認する。確認できない事実を作らない。判断材料が不足する場合は、次の順で処理する。

  1. 既存パターンと明示要件に沿う。
  2. 安全側、つまり挙動や規則を増やさない側の推奨案を採用する。目的に必要か迷う挙動や規則は対象外か未確定に置き、要件定義書の「安全面でgrillingで対象外としたこと」に記録して、後から足す。
  3. 推奨案、根拠、不確実性を要件定義書に残す。
  4. セキュリティ、法令、データ損失、外部契約に関わり、決めずにおくと実害が出得る論点は、対象外や未確定に置かず、実害を防ぐ最小限の規則を足す。その規則を既存パターンや確認した事実から決められない場合だけ停止する。

Phase 1: 要件定義(子パイプラインへ委譲)

要件定義書のパスを入力に pipe-grilling-auto-to-requirements-pr を使う。事前調査、自動壁打ちによる要件確定、要件の品質ゲート、要件成果物の commit と push、初回 PR の作成と本文更新までを子パイプラインへ委譲する。

委譲時に次を段階固有の指示として明示し、子スキルの既定より優先させる。

  • PR の base は比較先ブランチとする。
  • 作業ブランチは親が確定したものを使い、子スキル側で新しいブランチを作らない。現在のブランチが develop なら、委譲前に変更内容へ合う作業ブランチを作る。
  • 調査レポートの保存先は 成果物の契約 で確定した名前に従う。
  • 開始時に記録した既存変更は stage も commit もしない。

完了報告から次を確認する。満たさない場合は Phase 2 へ進まず、停止理由と残課題を報告する。

  • 調査レポートが有効な JSON で、必須フィールド、根拠パス、open_questions を含む
  • 要件定義書が自動壁打ちと品質ゲートを通過した最終版で、品質点が80点以上である
  • 対象成果物だけの commit が remote にあり、現在のブランチのオープンな PR を再取得して確認できている

この PR を以後の唯一の PR として扱い、後続 Phase で新しい PR を重ねて作らない。

Phase 2: 設計文書(子パイプラインへ委譲)

更新済み要件定義書、調査レポート、設計文書の指定パスを入力に pipe-auto-grilling-design を使う。設計判断の自動壁打ち、設計文書と必要な Quint モデルの作成、要件との品質ゲートを委譲する。子スキルが更新した要件定義書と設計文書を後続工程の入力にする。

完了報告だけでなく成果物を確認する。設計文書がアーキテクチャ、データ、インターフェース、状態遷移を扱い、EARS ID と Gherkin シナリオから設計要素へ追えることを確かめる。Quint が必要な場合は .qnt、検査結果、未解決の反例がないことを確認する。設計文書の品質点が原則90点以上で重大な不整合が0件でなければ Phase 3 へ進まず、停止理由と残った指摘を報告する。

Phase 3: 実装計画(子パイプラインへ委譲)

更新済み要件定義書、設計文書、調査レポート、実装計画の指定パスを入力に pipe-generate-quality-gated-implementation-plan を使う。 実装計画の自動壁打ちと生成、要件・設計との文書品質ゲートを子パイプラインへ委譲する。 子スキルが更新した要件定義書、設計文書、実装計画を、以後の最終版として扱う。

完了報告と成果物から、実装計画の最終点が原則90点以上で、文書間の重大な不整合が0件であることを確認する。 子スキルの例外終了条件に該当した場合は、残課題が実装を危険にしないことを確認する。

Phase 4: 実装計画の commit、push

要件・設計・計画が品質ゲートを通過した時点で、実装へ進む前のチェックポイントを共有する。開始時に記録した既存変更が作業ツリーに残っていないこと、および現在の未コミット変更がすべてこのパイプラインの対象であることを確認する。commit-push は未コミット変更をすべて commit するため、対象外の変更を分離できない場合は実行せず、該当ファイルを報告して停止する。

commit-push を実行し、設計文書と図、Quint モデル、実装計画、更新した要件定義書を含む現在の対象変更を1つのコミットとして現在のブランチへ push する。子スキルの完了報告から、作成された commit と upstream の追跡参照が一致することを確認する。PR 本文の更新は Phase 9 でまとめて行う。

Phase 5: 実装と検証(子パイプラインへ委譲)

Phase 3 の最終版の要件定義書、設計文書、実装計画を入力に pipe-implement-and-verify を使う。計画タスクの実装と検証、動いているアプリでの実証、結果の実装計画への記録を子パイプラインへ委譲する。子スキルが更新した要件定義書、設計文書、Quint モデル、実装計画を、以後の最終版として扱う。

完了報告と実装計画から、すべての計画タスクの Done when を検証した結果と、EARS 規則・Gherkin シナリオごとの実証結果が記録され、fail が0件であることを確認する。未検証は子スキルが認める理由に限る。満たさない場合は Phase 9 の最終更新へ進まず停止し、既存 PR の URL と残った fail を報告する。

Phase 6: 比較先ブランチとの差分レビュー

レビューと PR を読み、差分をレビューする。対象は比較先ブランチと現在のブランチの差分、および未コミットの対象変更である。Claude Code や Codex のホスト固有レビュー機能は使わない。

ponytail:ponytail-review で過剰設計を洗い出す。差分に TypeScript または JavaScript が含まれる場合は anti-slop-code-general も使い、防御的な過剰実装、見せかけの型安全、不要なヘルパー、冗長な実行時チェックを洗い出す。含まれない場合は省略し、省略した理由を最終報告に残す。

shared-code-impact-review を使い、変更した共通処理が今回の修正対象以外へ与える影響を確認する。意図しない影響があれば、対象だけに必要な処理を切り分けるなどして修正し、修正対象とほかの利用箇所の両方を検証する。言語を問わず実施し、共通処理の変更がない場合はその根拠を記録する。未解決の影響と未確認の範囲はレビューの残課題に含める。

上記のコードレビューと修正が終わった後に、成果物の契約のテスト方針 の基準で生成・変更したテストをレビューする。TypeScript / JavaScript がなく anti-slop-code-general を省略した場合も、テストがあれば実行する。レビューと PR の基準に従い、AI slop的なテストやアンチパターンに該当するテストを削除または修正し、必要な振る舞いの検証を残して再実行する。

各スキルの所見に加えて、正しさ、回帰、エラー処理、セキュリティ、データ損失、契約、境界条件、テスト、保守性を確認する。根拠のある指摘は修正して検証を再実行し、修正したファイルと、それが関わる EARS ID・シナリオを記録する。単純化の指摘であっても、要件定義書、設計文書、実装計画で決めた挙動、公開 API、永続化形式、セキュリティ検査、外部入力に対する正当な防御的チェックは変えない。最大3巡で、重大または高重要度の未解決指摘が0件になったらレビューを終える。安全に直せない重大指摘が残る場合は Phase 9 の最終更新へ進まず停止し、既存 PR の URL と未解決指摘を報告する。

レビューを終えたら、記録した EARS ID・シナリオを pipe-implement-and-verify の「動いているアプリで実証する」の手順で実証し直し、実装計画の実証結果を更新する。今回の EARS ID がない既存利用箇所も、共通処理の影響確認で記録した利用経路と維持すべき挙動を検証し、方法と結果を実装計画に記録する。レビューで実装を修正しなかった場合は再実証を省き、その理由を記録する。fail が出たら原因を直し、その修正を上記の基準でレビューしてから同じ EARS ID・シナリオと既存利用箇所を再検証する。再実証は最大2巡とし、fail が0件になったら Phase 7 へ進む。2巡後も fail が残る場合は Phase 9 の最終更新へ進まず停止し、既存 PR の URL と残った fail を報告する。

Phase 7: ユーザーストーリー確認 HTML

user-story-review を使い、Phase 6 の修正と再実証を終えた実装から、人間が画面で試せるユーザーストーリーの確認用 HTML を作る。比較先に比較先ブランチを指定し、要件定義書、設計文書、実装計画と、実装計画に記録した実証結果を根拠として渡す。

出力ディレクトリはローカルの確認環境とデータに結び付くため PR に含めない。commit-push が拾わないよう、git rev-parse --git-path info/exclude が示すファイルへ出力ディレクトリを追記する。

user-story-review が要件と実装の食い違いを「要確認」とした場合や、Phase 5 で未検証とした理由以外でストーリーの期待結果を観測できなかった場合は、Phase 5 へ戻って実装を直し、Phase 6 のレビューと再実証を経てから、影響するストーリーを作り直す。この差し戻しは最大2回とし、なお残る場合は Phase 9 の最終更新へ進まず停止し、既存 PR の URL と残った食い違いを報告する。

user-story-review の完了条件を満たし、要確認が0件になったら Phase 8 へ進む。Phase 5 で未検証とした理由による未実施の項目だけが残って HTML が草案になった場合は、未実施の項目と理由を残課題に記録して進む。

Phase 8: レビューガイド

レビューガイドの生成直前に、Phase 6 の修正と再検証を終えた要件定義書、設計文書、実装計画から、次の HTML を生成する。

  • asciidoc-to-colorful-html で要件定義書を req-<topic>.html へ変換する。
  • asciidoc-to-colorful-html で設計文書を design-<issue-token>-<topic>.html へ変換する。
  • asciidoc-to-colorful-html で実装計画を implementation-plan-<issue-token>-<topic>.html へ変換する。
  • easy-to-understand で実装計画の解説 HTML を easy-implementation-plan-<issue-token>-<topic>.html に生成する。

成果物契約と各スキルの出力契約を満たし、HTML が変換元の最新内容と一致し、設計文書の図が埋め込まれていることを確認する。変換警告から include、画像、xref などの文書不備が判明した場合は AsciiDoc を修正し、設計に影響すれば Phase 2、要件・設計・計画の整合には Phase 3 の品質ゲートを再実行してから対応する HTML を再生成する。文書修正が実装に影響する場合は Phase 5〜7 も再実行する。すべての HTML が最終文書と一致したら、レビューガイドを生成する。

review-guideを使い、Phase 6の修正と再検証を終えた最終実装からレビューガイドを生成する。対象として比較先ブランチと現在のブランチの差分、未コミットの対象変更、要件定義書、設計文書、Quint モデル、実装計画書、検証結果を渡し、出力先にreview-guide-<issue-token>-<topic>.adocを指定する。

子スキルが生成したAsciiDoc、難しい処理に対するSVG図、review-guide-<issue-token>-<topic>.htmlを最終検証の対象に含める。成果物が現在の最終差分と一致しない場合、図示すべき処理が図示されていない場合、または生成したSVGがHTMLへ埋め込まれていない場合はPhase 9へ進まない。

Phase 9: commit、push、PR 更新

レビューと PR の PR 手順に従う。HTML 生成後に要件定義書、設計文書、Quint モデル、実装計画を更新していた場合は、設計・モデルへの影響を Phase 2、文書間の整合を Phase 3 の品質ゲートで再確認し、Phase 8 の手順で実装計画の解説 HTML を再生成する。要件定義書、設計文書、実装計画、レビューガイド、またはSVG図を更新していた場合は、対応する HTML を asciidoc-to-colorful-html で再生成し、変換元の最新内容と一致することを確認する。設計文書の HTML と図、実装計画の解説 HTML、レビューガイド、参照するSVG図、そのHTML、Quint モデルまで含む対象変更だけが未コミットであることを確認してから、commit-push を実行する。

Phase 1 で作成した PR をそのまま使い、draft 状態を維持する。オープンな PR が見つからない場合だけ gh pr create --draft --base <比較先ブランチ> --assignee @me で比較先ブランチ向け draft PR を作成する。assignee はこの環境で gh が認証している GitHub ユーザーとする。その後 gh-update-pr を実行し、設計文書・Quint モデル・レビューガイドへの導線、実施した検証、修正対象、TODO、レビューアーに確認してほしいことを含む本文へ更新して、再取得した本文、URL、isDraft、assignees を確認する。ユーザーが明示的に指示しない限り draft を解除しない。

再開と完了報告

各 Phase の開始時に既存成果物と Git / PR の状態を検証する。完了条件を満たす Phase は再利用し、途中または不整合な Phase から再開する。ファイルの存在だけで完了扱いにしない。子パイプラインへ委譲した Phase は、この親スキルの段階固有の指示を反映した子スキルの完了条件で再開可否を判断する。Phase 1〜7 の再開時は HTML の未生成や未更新を不整合とみなさず、Phase 8 で最新文書との一致を確認する。

最後に次を簡潔に報告する。

  • 更新・生成した要件定義書、調査レポート、設計文書と図、Quint モデル、実装計画、実装計画の解説 HTML、レビューガイド、SVG図、および4文書の HTML
  • 各子パイプラインの品質ゲートの最終点と終了理由
  • 実装概要と検証結果、実証の結果と未検証の理由
  • ユーザーストーリー確認 HTML とデータ作成・削除スクリプトのパス、人間が最初に行う操作
  • レビューで使ったスキル、指摘、修正結果
  • 要件定義のチェックポイント commit、実装計画のチェックポイント commit、最終 commit、ブランチ、PR の URL
  • 残課題。なければ「なし」

PR の作成または更新と再取得確認が完了し、重大な未解決事項がなく、上記成果物が現在の実装と一致したときだけパイプライン完了とする。

04 同仓库更多 Skills

seiei-sogen
seiei-sogen/agent-skills

why

「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

what-did-i-get-done

ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する

★ 0
seiei-sogen
seiei-sogen/agent-skills

unslop

あらゆる文章から AI の痕跡を削る。常に適用しなければならない。

★ 0
seiei-sogen
seiei-sogen/agent-skills

typescript-best-practices

TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

thermo-nuclear-code-quality-review

抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

technical-writing

階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。

★ 0