本文へ移動
cccskills
無料GitHub で公開

proposal-readiness-check

proposal.md が /spec の入力として十分な情報を含んでいるかを確認する。「ユーザーにとっての承認」ではなく「/spec にとっての準備完了度」を検証する軽量チェック

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.4 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Proposal Readiness Check

Overview

proposal.md が /spec フェーズの入力として「準備完了」かを確認する。

目的: 不完全な proposal が /spec に入り、エスカレーション多発や低品質な仕様生成を防ぐ。 タイミング: /brainstorm の proposal.md 生成後、ユーザー承認前。 原則: 5項目の Yes/No チェック。不足があれば追加質問で補完。ユーザー判断で進行可能。

Definition of Ready for /spec(5項目)

1. 意図の明確性

「なぜこの変更が必要か」と「何が達成されれば完了か」が明確か。

  • Yes: Intent セクションが具体的な問題や目標を述べている
  • No: 「〇〇を追加する」のみで、なぜ必要かが不明
No の場合の追加質問:
→「この変更が完了したとき、何がどう変わっていれば成功ですか?」

2. ストーリーの具体性

各ストーリーの「行動」が具体的な操作を示しているか。

  • Yes: 「検索する」「登録する」「一覧を見る」等の具体的動詞
  • No: 「改善する」「最適化する」「対応する」等の抽象的動詞
No の場合の追加質問:
→「具体的にユーザーはどんな操作をしますか? 画面で何をクリック/入力しますか?」

3. スコープの境界

Out of Scope が最低1つ定義され、対象領域が具体的か。

  • Yes: Out of Scope に除外項目あり、対象領域がシステム領域を指している
  • No: Out of Scope が空、または対象領域が「全体」「各所」等の曖昧表現
No の場合の追加質問:
→「あえて今回やらないことは何ですか? 後回しにすることを1つ挙げるとしたら?」

4. 変更の規模感

ユーザーが変更の大きさを認識しているか。

  • Yes: 対象領域から規模感が推測可能(1画面の修正 / 新API追加 / DBスキーマ変更 等)
  • No: 影響範囲が読めない、または複数領域にまたがるのに認識されていない
No の場合の追加質問:
→「この変更は〇〇と△△に影響しそうです。この規模感で合っていますか?
   それとも、もっと小さく分割しますか?」

5. 未解決の疑問点

Open Questions セクションが適切に機能しているか。

  • Yes: /spec で解決すべき具体的な技術的疑問が列挙されている
  • No(空): 疑問点が本当にないのか、考慮不足なのか判断できない
  • No(/brainstorm レベル): /spec ではなく /brainstorm で解決すべき疑問が残っている
空の場合の追加質問:
→「疑問点が空ですが、例えば〇〇についてはどうしますか?
   本当に不明点はありませんか?」

/brainstorm レベルの疑問が残っている場合:
→ 該当の疑問を対話で解決してから proposal に反映

適用ルール

  1. 全5項目 Yes → 「/spec の準備完了です」と伝え、ユーザー承認を求める
  2. No が 1-2 個 → 追加質問で補完を試みる。補完後に proposal を更新
  3. No が 3 個以上 → 要件の深掘りが不足している可能性を伝え、追加対話を推奨

提示形式

/spec 準備完了チェック:

1. 意図の明確性:    ✓
2. ストーリーの具体性: ✓
3. スコープの境界:   ✓
4. 変更の規模感:    ⚠ 複数領域にまたがる可能性
5. 未解決の疑問点:   ⚠ Open Questions が空

→ 2点確認させてください:
  - この変更は画面とAPIの両方に影響しそうですが、その規模感で合っていますか?
  - 技術的な疑問点は本当にありませんか?

重要な制約

  • チェックはあくまで「/spec への準備完了度」であり、要件の正しさの判断ではない
  • ユーザーが「このまま進める」と判断すれば、No 項目があっても承認を妨げない
  • No 項目は proposal.md の「未解決の疑問点」に転記し、/spec のリサーチで解決を試みる

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use at the START of every task, before writing any code, running tests, debugging, reviewing, or designing. This skill determines which methodology and domain skills must be invoked. MUST be invoked before any implementation, debugging, review, testing, or specification work begins.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

Pattern for progressively refining context retrieval to solve the subagent context problem

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

Use when splitting a domain Skill into Phase-Aware File Structure (SKILL.md / design.md / constraints.md). Defines the splitting criteria, procedures, sync procedures, and validation rules. Invoked by /skill-format command or manually when restructuring domain Skills.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

story-quality-gate

無料日本語概要

/brainstorm のユーザーストーリー品質を INVEST 基準で軽量チェックする。proposal.md 生成前にストーリーの構造的品質を確認し、問題があれば対話で改善を促す

kousukef/forge152026年4月6日 更新

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

kousukef のスキルをすべて見る

このスキルの問題を報告する