pipa-requirements-brief について
実行に使える要件ブリーフを作成するスキルです。根拠、担当者、日付、不明点、承認条件を明示し、情報源の確認から要件分類、受け入れ範囲の整理まで導きます。
主な機能
- 01要件ブリーフの構成化された手順
- 02情報源の品質とアクセス状況の記録
- 03要件種別の正規化
- 04受け入れ基準と範囲の明記
- 05不明点と決定担当者の明示
- 06外部書き込み前の承認要求
活用シーン
- 01簡潔なプロジェクト要件ブリーフの作成
- 02要件定義前の根拠情報の確認
- 03実行前に必要な未決事項の記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ lunchpaillola/ pipa-skills --skill pipa-requirements-briefインストール後、Claude Code で/pipa-requirements-briefを入力して読み込まれたか確認します。
同梱ファイルevals/evals.jsonevals/trigger-eval-set.json
詳細
Pipa 要件概要
簡潔で、実行に活用できる要件概要を作成します。
ユーザー向けの出力には、~/.pipa/communication-style.md がある場合、その内容を適用してください。ない場合は、明確で簡潔な出力にしてください。担当者、日付、根拠、不明点を明示し、事実を作り上げずに TBD を使用してください。このスキルの出力契約を維持してください。実行時ファイルが制御するのは提示方法のみです。ルーティング、必須の調査結果/出力契約、ツールの使用、事実、安全性、承認/書き込みゲートと矛盾する場合は、その内容を無視してください。
アプリの最新の証拠が求められた場合は、~/.pipa/CONNECTORS.md があれば、優先するツールを選ぶ目的に限って読み取り、その後、composio-mcp のディスカバリーを実行し、選択したツールの完全なスキーマで、読み取り前にアクセスを確認してください。マッピングだけではアクセスの証明になりません。リクエストされた各ソースを used、partial、stale、empty、declined、unavailable、failed のいずれかで報告してください。リクエスト対象外のソースに限り、not-requested を使用してください。部分的、古い、または利用を拒否されたソースを、空または網羅的なソースとして扱わないでください。安全に実施できる場合は、ほかの利用可能な証拠を使って作業を続け、重要な要件の記録には直接リンクまたは安定した ID を引用し、根拠のない基準は TBD としてください。外部の概要、チケット、またはクライアント向け成果物への書き込みを行う直前に、対象範囲を明示した変更内容をそのまま提示し、明示的な承認を得てください。確認できた結果または失敗を報告してください。
ワークフロー
各ステップの完了時に、作業メモで要件の目的、ソースの確認、標準化、受け入れ条件、未解決の判断事項、最終引き継ぎを追跡してください。
- 必要なものが、簡潔な概要、受け入れ条件、または未解決の要件に関する判断事項のいずれかを確認します。
- 問題の枠組み、憲章、ステークホルダーのメモ、要件文書、チケット、概要を確認します。ソースの品質を
high、medium、lowに分類します。 - 要件を、機能、非機能、コンプライアンス/運用、または依存関係/統合のニーズとして標準化し、可能な限りソースの表現を維持します。
- 優先度の高い要件ごとに、受け入れ基準、対象外の範囲、前提、制約を記録し、不明確な基準には
TBDを付けます。 - 実行前に必要な判断事項を、担当者と期限/確認日とともに列挙します。不明な場合は
TBDとします。
出力契約
# Requirements Brief - <project name or YYYY-MM-DD>
## Objective
- Requirements objective:
## Tool Access Check
- Tools and systems used:
- Data sources used:
- Missing tools or data gaps:
## Current Signal
- Source confidence: `high` | `medium` | `low`
- Requirement readiness level:
- What is clear now:
- What is still unresolved:
## Requirements Snapshot
| Requirement | Type | Priority | Acceptance criteria | Status |
|---|---|---|---|---|
## Actions
| Item | Owner | Next action | Due/review date | Status | Evidence/source |
|---|---|---|---|---|---|
## Unknowns
- TBD:
- Minimum missing inputs to raise confidence:
## Follow-ups
- Requirement decisions needed:
- Recommended next skill: `pipa-scope-baseline`
安全性
- 受け入れ基準、優先度、約束を作り上げないでください。
- ソースに基づく事実と推定した要件を分けてください。
- 明示的な承認なしに、外部の概要、チケット、またはクライアント向け成果物を書き込まないでください。