miko.quick-impl
小規模な変更を speckit をスキップして直接実装する。proposal・ケイパビリティ名・自由記述の変更指示のいずれからでも受け付け、miko の原則に沿って実装とドキュメント追従まで行う。
- License 许可
- MIT
- 所属仓库
- studyplus/miko
- 最近更新
- 2026-11-10
- Stars
- ★ 22
- Forks
- 1
01 前言 Front Matter
- description
- 小規模な変更を speckit をスキップして直接実装する。proposal・ケイパビリティ名・自由記述の変更指示のいずれからでも受け付け、miko の原則に沿って実装とドキュメント追従まで行う。
03 SKILL.md 正文
入力
$ARGUMENTS
入力の形式: 以下のいずれか
- proposal のパス(例:
/miko.quick-impl miko/order_management/proposals/2026-03-01-fix-trial-grace-period.md) - 変更指示の自由記述(例:
/miko.quick-impl OrderService を OrderFacade にリネーム) - 空の場合はエラー: 「⛩️ proposal のパスまたは変更指示をお願いいたします(例:
/miko.quick-impl miko/order_management/proposals/2026-03-01-fix-trial-grace-period.md)」
このスキルの役割
小規模な変更を speckit フロー(specify → clarify → plan → tasks → analyze → implement)をスキップして直接実装する。proposal がある場合は BR 変更を含めて、ない場合は変更指示から直接、実装とドキュメント追従まで行う。
miko の原則として BR ルール本文の変更には proposal が必要。proposal がない入力で BR 本文変更が必要になると判定された場合は propose に誘導する。
対象外(フルフローまたは propose に誘導):
- 複数の意図が絡む変更
- 影響範囲の見極めに追加の調査・探索が必要な変更
- 既存の処理フローの構造が大きく動く変更
- BR ルール本文を変える変更で、それを認可する proposal がない
迷ったらフルフローを推奨する。
手順
1. 入力解決
$ARGUMENTS を以下のルールで解決する:
miko/で始まり.mdで終わるパス → そのパスを proposal として使用。パスから cap 名を抽出- 上記に該当しない →
$ARGUMENTSを変更指示として扱う(proposal なし)
proposal があった場合の追加検査:
- 親プロポーザル(umbrella proposal)の検出 — 先頭に
<umbrella-proposal>マーカーがある場合、エラーとして中止する:⛩️ 親プロポーザルは直接実装できません。サブプロポーザルを指定してください。
- 未分割プロポーザルの検出 — 先頭に
<needs-split>マーカーがある場合、エラーとして中止する:⛩️ このプロポーザルは分割が必要です。 まず
/miko.split-proposalでフェーズ分割してから、サブプロポーザルを指定してください。
2. 資料読み込み
再読み込みの省略: .miko/ 配下のガイド・サンプルは、このセッションで全文を読み込み済みで、その全文が現在のコンテキストに残っていれば読み直さない。要約しか残っていない(コンテキストが圧縮・要約された後など)、または確信が持てなければ読み直す。miko/ 配下のプロジェクト文書は対象外で、毎回読み込む。
共通:
.miko/guides/business_rules_guide.md— ルールの書き方、実装マッピングの表記規約.miko/guides/tone_guide.md— 対話スタイル。このファイルの口調・絵文字・出力言語ルールに従うことmiko/system_high_level_design.md— コード探索ガイドmiko/glossary.md— 用語集(存在する場合)
proposal がある場合の追加:
miko/<capability>/business_rules.md— 現在のビジネスルールmiko/<capability>/high_level_design.md— 現在の構造(あれば)- proposal ファイル
proposal がない場合: 上記共通のみを先に読み込む。コード調査中に cap 固有の BR/HLD が必要になった時点で随時参照する(どの cap に触れるかは調査結果で決まる)。
3. コード調査
miko/system_high_level_design.md の コード探索ガイド に従い、変更に関連するコードを探索・精読する。
- proposal がある場合: proposal の変更対象コードを調査
- proposal がない場合: 変更指示の対象コードを調査
いずれの場合も、影響範囲(他ファイル・他モジュール・他 cap からの参照)を把握する。
探索対象外: .miko/ ディレクトリは miko の内部リソースであり、プロジェクトのコードではない。探索・精読の対象にしないこと。
4. スコープガード
コード調査の結果を踏まえ、以下の 4 軸で判定する。いずれかに該当すれば中止し、適切なスキルに誘導する。
(a) 意図の単一性 — 変更が単一の意図・目的で説明できるか。BR ルールが何本に分解されるかは問わない(例: 「キャンセル後通知」は 1 ルールでも 3 ルールでも意図は単一)。複数の関心事が絡む場合:
⛩️ この変更は複数の意図が絡んでおります。フルフローをお勧めいたします。
(b) 影響範囲の明瞭さ — 変更点から波及先がコード上素直に辿れるか。波及の見極めのために広範な探索(当たりをつけるためのプロトタイプ、仮説検証、多段の読み込み)を要する場合:
⛩️ この変更は影響範囲の見極めに追加の探索が必要です。フルフローをお勧めいたします。
(c) 機械性または局所性 — 機械的な変換(リネーム、シグネチャ変更、参照の一括置換 等)か、あるいは局所的な変更で完結するか。既存の処理フローの構造が大きく動く場合:
⛩️ この変更は処理構造に大きく影響いたします。フルフローをお勧めいたします。
(d) BR ルール本文の変更を伴う場合、それを認可する proposal があるか。 proposal がない、または proposal に記載のない BR 本文変更が必要な場合:
⛩️ この変更はビジネスルールに影響いたします。
/miko.propose <capability>でプロポーザルをお作りしてからお進みくださいませ。
注記:
- ケイパビリティ境界を跨ぐこと自体は中止理由にしない。BR 本文を変えないリファクタリングなら、複数 cap の実装・実装マッピングを同時に動かしてよい
- ファイル数・行数は目安にすぎない。機械的なリファクタリングなら多くのファイルに及んでも対象内。上記の 4 軸で判定する
対象と判定した場合、次に進む。
5. 【確認】実装方針の提示
変更内容(ファイルごとの変更概要)、テスト方針、ドキュメント更新の見込み(BR 本文・実装マッピング・HLD・harae のうち、実際に触る予定のもの)を簡潔に提示し、確認を取る。
6. 実装 + テスト
確認された方針に従い、実装とテストを行う。
実装後、セルフレビューを実行:
-
責務の配置: フレームワークの規約上正しいレイヤー/ファイルに置かれているか
-
命名: メソッド名・変数名がそのレイヤーの責務を正しく反映しているか
-
フレームワークの機能活用: フレームワークが提供する仕組みで実現できることを自前で実装していないか
-
意図外の変化がないか: 手順 5 で宣言した意図の外に、挙動・副作用の変化が生じていないか。変更対象の旧コード/旧仕様が扱っていたケース(正常系・エラーパス・nil 等の境界)を列挙し、新コードで各ケースが同等に扱われるか確認する(意図的に変える場合は手順 5 で宣言されているはず)。
帯域外シグナルを変える場合はリポジトリ全体を見る: 例外の送出、グローバル/静的状態の変更、イベント・通知の発行、ライフサイクルフックの発動、メタプログラミングによる動的挙動の変更など、呼び出し元ではなく別の箇所で受信・観測される信号を変える場合、受信側は immediate caller に現れない。この種の信号を変える時は受信側(例外なら捕捉箇所、イベントなら購読箇所、等)をリポジトリ全体で検索し、更新または互換性を確保する。戻り値や引数のように呼び出し元で完結する契約は、通常どおり呼び出し元の更新で足りる。
識別子をリネームした場合はリポジトリ全体を grep する: クラス名・モジュール名・ファイルパス・関数名・定数名等を変更した場合、型チェッカーやテストでは捕捉できない参照(文字列リテラル、コメント、テストフィクスチャ名、設定ファイル、動的ロードのパス、
miko/配下の design docs・proposals・harae、README やその他 markdown、CI 設定など)が残る。grepでリポジトリ全体から旧名を洗い出し、ヒットごとに以下を判断する:- 同名の別概念ではないか(語境界・文脈の一致)
- 過去の経緯記録(解決済み harae 項目・廃止 proposal・過去の commit log を引いた docs 等)として旧名のまま残すべきか
- リネーム結果が文脈上正しい表記か(複合語・派生語の扱い)
機械的な一括置換はしない。判断に迷うヒットは、置換せずに主さまに提示して確認する。
問題を発見したら修正する。
セルフレビュー完了後、/simplify を実行する。
7. デザインドキュメントの更新
読み込み:
.miko/guides/business_rules_guide.md— ルールの書き方、実装マッピングの形式.miko/examples/business_rules.md— 品質基準.miko/examples/high_level_design.md— 品質基準
.miko/ 配下のファイルは、手順 2 の「再読み込みの省略」に従う。
方針: 実際に変わったものだけを更新する。変わっていない部分には触らない。識別子リネームに伴う docs 内の旧名追従は、手順 6 のセルフレビュー(リポジトリ全体 grep)で実施済みの前提。
business_rules.md の BR 本文更新
- proposal がある場合のみ: proposal の新設・改訂・廃止を BR 本文に適用する
- proposal がない場合: BR 本文は一切触らない(スコープガード (d) で除外済みのはず)
横断カテゴリの書き込み時検査(lint)
business_rules.md を更新した場合、.miko/guides/business_rules_guide.md の「書き込み時の検査(lint)」を実行する(orphan xc: 参照・[横断] マークとマーカーの整合・横断カテゴリとタグの書式)。問題があれば修正し、修正できないものは主さまに報告する。BR を更新しない実行ではスキップする。
実装マッピングの横断更新(Sonnet サブエージェント)
実装の変更がどの cap の実装マッピングに波及したかを機械的にチェック・更新する。
比較基準を決める:
- 現在のブランチが
main/masterの場合は確認しない。マージ先は自明なので、upstream(git rev-parse --abbrev-ref @{upstream}、なければHEAD)を比較基準とする。差分はgit diff <基準>(未 push コミット + 未コミット変更)で取る - それ以外のブランチでは、主さまにベースブランチ名を確認する(例: 「このブランチのベースブランチ(マージ先)を教えてくださいませ」)。自動推定はしない
Sonnet サブエージェント(Agent ツール、model: "sonnet")を起動して実行する。
サブエージェントに渡す情報:
.miko/guides/cross_capability_mapping_guide.mdのパス — 「このファイルを読み、指示に従え」と指示する- メインケイパビリティ名 — proposal がある場合のみ渡す(proposal がない場合は渡さず、全 cap スキャンにする)
- 比較基準(主さまに確認したベースブランチ名、または
main/master上での upstream /HEAD)。main/master上であることも併せて伝える
high_level_design.md の更新
- 構造の描写(コンポーネント配置、処理パイプライン等)が変わった場合のみ更新
- 識別子リネームの追従は上記「識別子リネーム時の横断追従」で実施済み。本セクションでは構造変更の有無のみ判断する
- 「設計上の特徴」セクションも、スコープガードに通った範囲であれば内容に応じて更新してよい(スコープガードが複雑な設計判断の変更を先に弾いている前提)
harae.md への転記
- proposal に「祓え検証」セクションがある場合、その内容を
miko/<capability>/harae.mdに適用する。harae.md のフォーマットは.miko/guides/harae_format_guide.mdに従う - 既存指摘のステータス変更: 祓え検証に記載されたステータス変更を harae.md の該当エントリに反映する。指摘一覧テーブルのステータスセル更新・打ち消し線付与、詳細セクションのステータスと解決フィールドの更新を行う
- 新規指摘の追加: 祓え検証の新規指摘を harae.md に追加する。番号は既存の最大番号の続きから採番する。ステータス・解決フィールドが省略されている場合は
open/—として補完する - proposal がない、または祓え検証セクションがない場合はスキップ
親プロポーザルの進捗更新
- proposal の先頭に
<sub-proposal@{親のmiko相対パス}>マーカーがある場合、miko/{パス}で親プロポーザルを開き、該当フェーズのチェックボックスにチェックを入れる(- [ ]→- [x]) - 該当しなければスキップ
更新内容を提示し、主さまの確認を取る。
8. 完了報告
以下をサマリーテーブルで提示する:
- 入力種別(proposal / cap / 変更指示)と入力内容
- 変更ファイル数・行数
- テスト数・実行結果
- セルフレビュー修正数
- BR 本文変更件数(該当なしなら 0)
- 実装マッピング更新件数(cap 別、該当なしなら 0)
- HLD 更新有無
- harae 転記件数(該当なしなら 0)
テストの実行を依頼する。
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.plan
speckit.plan を拡張し、テスト設計(test_design.md)を追加生成する。
miko.speckit.implement
speckit.implement を拡張し、フェーズごとの確認停止と test_design.md の活用を追加する。