miko.speckit.tasks
speckit.tasks を拡張し、縦割りタスク順序と test_design.md の活用を追加する。
- License 许可
- MIT
- 所属仓库
- studyplus/miko
- 最近更新
- 2026-11-10
- Stars
- ★ 22
- Forks
- 1
01 前言 Front Matter
- handoffs
- [ { "send": true, "agent": "miko.speckit.analyze", "label": "Analyze For Consistency", "prompt": "Run a project analysis for consistency" }, { "send": true, "agent": "miko.speckit.implement", "label": "Implement Project", "prompt": "Start the implementation in phases" } ]
- description
- speckit.tasks を拡張し、縦割りタスク順序と test_design.md の活用を追加する。
03 SKILL.md 正文
入力
$ARGUMENTS
対話スタイルと出力言語
.miko/guides/tone_guide.md に従うこと。対話の口調・絵文字に加え、生成するドキュメントの言語も同ガイドの「出力言語」ルールに従う。
このスキルの役割
speckit.tasks のワークフローを基盤として実行し、以下を変更する:
- 縦割りタスク順序 — 操作/機能ごとに完結させてから次に進む
- test_design.md の活用 — テストタスクを合意済みテストケースから生成する
手順
1. speckit.tasks の実行(Miko 拡張)
speckit の tasks の手順を以下の順で探索して読み込み、基盤として実行する:
.claude/skills/speckit-tasks/SKILL.md— spec-kit の skills モード(--ai claudeの現デフォルト).claude/commands/speckit.tasks.md— commands モード(旧レイアウト)
どちらも存在しない場合はエラー中止する:
⛩️ speckit の
tasksスキルが見つかりません。specify init --ai claudeを先にお願いいたします。
以下の点を変更する:
追加の文脈読み込み(Load design documents に追加)
speckit.tasks のステップ 2 で、以下のファイルも追加で読み込む:
test_design.md(FEATURE_DIR 内) — テスト観点とテストケース一覧- spec.md 内の「Miko コンテキスト」からケイパビリティ名を取得
miko/<capability>/business_rules.md— ルール ID の参照用
test_design.md が存在しない場合は警告を出すが続行する:
⛩️
test_design.md が見つかりません。テストタスクは spec.md から生成いたします。テスト設計を含めるには、先に /miko.speckit.plan を実行くださいませ。
タスク順序の変更: 機能単位で完結させる
speckit.tasks のタスク順序ルールに、以下の 原則 を追加する:
原則: 複数の機能を開発する場合、実装の詳細は機能単位で完結させてから次の機能に進む。
悪い例(横割り):
機能Aの実装 → 機能Bの実装 → 機能Aのテスト → 機能Bのテスト
良い例:
設定・定義(まとめてOK)→ 機能Aの実装 → 機能Aのテスト → 機能Aのクリーンアップ → 機能Bの実装 → 機能Bのテスト → 機能Bのクリーンアップ → 最終フェーズ
まとめてよいもの:
- ルーティング定義、Swagger 定義、スキーマ変更、モデル定義など、設定・定義レベルのもの
- 行数が少なく、複数を見比べながら設定するほうが整合性を取りやすいもの
機能単位で分けるもの:
- コントローラー、サービス、ジョブ等の実装の詳細
- テスト
- 分ける理由: まとめるとレビュー負荷が高くなる
機能ごとのセルフレビュー(各機能のテスト完了後に実行):
- セルフレビュー — 責務の配置、命名、フレームワーク機能の活用をチェック・修正
- /simplify 実行 — コードの重複・品質・効率をチェック・修正
最終フェーズ(必須):
- 機能横断のリファクタリング — 機能間の重複コード整理、命名の統一、モデルの調整等を行う
補足:
- 機能が1つしかない場合や、この原則が当てはまらないケースではそのまま speckit.tasks の順序に従う
- 「機能」の粒度は内容に応じて判断する(API エンドポイント、バッチ処理、イベントハンドラ等)
テストタスクの生成ルール
test_design.md がある場合:
- テストケース一覧の各項目を、対応する操作のテストタスクとして配置する
- テストケースに記載されていないテストは 追加しない(合意済みケースのみ)
- ルール ID が紐づいているケースは、タスクの説明にルール ID を含める
test_design.md がない場合:
- speckit.tasks のデフォルト動作に従う
テスト除外ルール(test_design.md の有無に関わらず適用):
- フレームワークが保証する振る舞い(validates のパラメータチェック等)のテストタスクは生成しない
- 親クラス・共通基盤が担保する処理(認可、認証)のテストタスクは生成しない
それ以外の speckit.tasks の手順
セットアップスクリプト実行、チェックリストフォーマット、タスク ID 採番、レポート等は speckit.tasks の手順をそのまま実行する。
2. 完了報告
speckit.tasks の報告に加えて、タスク総数・テストタスク数をサマリーテーブルで提示する。次のアクションとして /miko.speckit.analyze → /miko.speckit.implement をご案内する。
04 同仓库更多 Skills
miko.version
miko のバージョンを表示する。
miko.split-proposal
既存のプロポーザルを親(umbrella)+ サブプロポーザルにフェーズ分割する。
miko.speckit.specify
Miko プロポーザルを入力として speckit.specify を拡張し、spec.md を生成する。
miko.speckit.plan
speckit.plan を拡張し、テスト設計(test_design.md)を追加生成する。
miko.speckit.implement
speckit.implement を拡張し、フェーズごとの確認停止と test_design.md の活用を追加する。
miko.speckit.clarify
spec.md の不明点を対話で明確化する。