miko.speckit.plan
speckit.plan を拡張し、テスト設計(test_design.md)を追加生成する。
- License 许可
- MIT
- 所属仓库
- studyplus/miko
- 最近更新
- 2026-11-10
- Stars
- ★ 22
- Forks
- 1
01 前言 Front Matter
- handoffs
- [ { "send": true, "agent": "miko.speckit.tasks", "label": "Create Tasks", "prompt": "Break the plan into tasks" }, { "agent": "miko.speckit.checklist", "label": "Create Checklist", "prompt": "Create a checklist for the following domain..." } ]
- description
- speckit.plan を拡張し、テスト設計(test_design.md)を追加生成する。
03 SKILL.md 正文
入力
$ARGUMENTS
対話スタイルと出力言語
.miko/guides/tone_guide.md に従うこと。対話の口調・絵文字に加え、生成するドキュメントの言語も同ガイドの「出力言語」ルールに従う。
このスキルの役割
speckit.plan のワークフローを基盤として実行し、実装設計に加えて テスト設計(test_design.md) を生成する。
テスト設計は日本語で合意するレベルの粒度で、テストコードではない。「何をテストするか」をビジネスルールと紐づけて定義し、実装フェーズでのテスト作成の元ネタにする。
手順
1. speckit.plan の実行
speckit の plan の手順を以下の順で探索して読み込み、基盤として実行する:
.claude/skills/speckit-plan/SKILL.md— spec-kit の skills モード(--ai claudeの現デフォルト).claude/commands/speckit.plan.md— commands モード(旧レイアウト)
どちらも存在しない場合はエラー中止する:
⛩️ speckit の
planスキルが見つかりません。specify init --ai claudeを先にお願いいたします。
以下の点を変更する:
追加の文脈読み込み(Load context に追加)
speckit.plan のステップ 2(Load context)で、以下のファイルも追加で読み込む:
- spec.md 内の「Miko コンテキスト」セクションからプロポーザルのパスとケイパビリティ名を取得
miko/<capability>/business_rules.md— 現在のビジネスルールmiko/<capability>/high_level_design.md— 現在の構造(なければスキップ)miko/<capability>/harae.md— 攻撃的検証の指摘リスト(なければスキップ。テスト設計で重点箇所の参考にする)- プロポーザルファイル — ビジネスルール変更の詳細
Miko コンテキストがない場合(speckit.specify から来た場合):
- ケイパビリティ名を spec.md の内容から推定する
- business_rules.md が見つかればそれを読み込む。見つからなければ Miko 文脈なしで続行する(speckit.plan と同じ動作)
Phase 1 の拡張
speckit.plan の Phase 1(Design & Contracts)の成果物に加えて、test_design.md を生成する(詳細は後述のステップ 2)。
それ以外の speckit.plan の手順
Phase 0(Research)、スクリプト実行、Constitution Check 等は speckit.plan の手順をそのまま実行する。
2. テスト設計の生成
Phase 1 完了後、以下の手順で test_design.md を生成する。
2-1. テスト観点の抽出
spec.md の機能要件・ユーザーシナリオと、business_rules.md のルールを突き合わせて、テスト観点を抽出する。harae.md がある場合は、open / resolved の指摘を重点的にテストすべき箇所として参考にする。
テスト観点の例:
- 状態遷移: 遷移条件の充足/不充足
- 副作用: コールバック連鎖、ジョブ投入、メール送信
- 計算/導出: ビジネスルールに基づく計算ロジック
- 境界: 期間・数量の境界条件
- データ整合性: 複数モデル間の一貫性
2-2. テストケース一覧の作成
各テスト観点について、1〜2行の日本語でテストケースを列挙する。
テストケースの書き方:
- ビジネスルール ID と紐づけられるものは紐づける(例:
(ORD-01)) - 操作/機能ごとにグルーピングする
- テストコードではなく、日本語で「何を確認するか」を書く
2-3. テスト除外ルールの適用
以下はテストケースに 含めない:
- フレームワークが保証する振る舞い:
validatesのパラメータチェック(presence: trueに対する空値テスト等) - 親クラス・共通基盤が担保する処理: 認可チェック、認証チェック、403/401 レスポンス等
- 単純な CRUD の正常系: ビジネスロジックが絡まないもの
テストすべきもの:
- ビジネスルール固有のロジック(状態遷移の条件、計算ロジック、期間判定等)
- 複数モデルにまたがる副作用(コールバック連鎖、関連レコードの生成/更新等)
- 条件分岐が絡む処理パターン(ステータスによる挙動の違い等)
2-4. ファイル生成
spec.md と同じディレクトリに test_design.md を生成する。構造:
- Miko コンテキスト — ケイパビリティ名、参照ルール ID
- テスト観点 — 該当するもののみ(状態遷移/副作用/計算・導出/境界/データ整合性)
- テストケース一覧 — 操作・機能ごとにグルーピング。各ケースにルール ID を紐づける
- テスト対象外 — 除外ルールに基づいて意図的に含めなかったもの。省略せず明記する
3. 完了報告
speckit.plan の報告に加えて、ケイパビリティ名、test_design.md パス、テスト観点数・テストケース数・テスト対象外数をサマリーテーブルで提示する。次のアクションとして /miko.speckit.tasks をご案内する。
04 同仓库更多 Skills
miko.version
miko のバージョンを表示する。
miko.split-proposal
既存のプロポーザルを親(umbrella)+ サブプロポーザルにフェーズ分割する。
miko.speckit.tasks
speckit.tasks を拡張し、縦割りタスク順序と test_design.md の活用を追加する。
miko.speckit.specify
Miko プロポーザルを入力として speckit.specify を拡張し、spec.md を生成する。
miko.speckit.implement
speckit.implement を拡張し、フェーズごとの確認停止と test_design.md の活用を追加する。
miko.speckit.clarify
spec.md の不明点を対話で明確化する。