Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
122 lines
6.5 KiB
Markdown
122 lines
6.5 KiB
Markdown
# クイックタスクと高速タスクの処理方法
|
||
|
||
すべての作業がフェーズの中に収まるわけではありません。MSD は、discuss → plan → execute → verify の完全なループを必要としない作業向けに 2 つの軽量コマンドを提供します。
|
||
|
||
フェーズパイプライン全体がそのオーバーヘッドに見合うかどうかの判断基準については [コンテキストエンジニアリング](../explanation/context-engineering.md) を参照してください。
|
||
|
||
---
|
||
|
||
## どちらのコマンドを使うかを決める
|
||
|
||
| 状況 | コマンド |
|
||
|-----------|---------|
|
||
| バグ修正、小さな機能追加、または単一の自明な編集として要約できないタスク | `/msd-quick` |
|
||
| タイポ修正、設定値の更新、`.gitignore` へのエントリ追加など、3 ファイル以下でかつ 1 分以内の変更 | `/msd-fast` |
|
||
| タスクに未知の要素があり、リサーチが必要、または複数のファイルに影響する場合 | `--research` 付きの `/msd-quick` |
|
||
|
||
**目安:** タスクが自明かどうかを一瞬でも迷ったら `/msd-quick` を使ってください。`/msd-fast` はスコープが自明でないと判断した場合、自動的に `/msd-quick` にリダイレクトします。
|
||
|
||
---
|
||
|
||
## `/msd-quick` — MSD の品質保証付きアドホックタスク
|
||
|
||
`/msd-quick` はフルフェーズと同じアトミックコミットおよび STATE.md トラッキングの保証付きでプランナーとエグゼキュータを実行しますが、フェーズのオーバーヘッドなしに動きます(ROADMAP エントリなし、discuss-phase なし、複数プランにまたがるウェーブ調整なし)。
|
||
|
||
### 基本的な使い方
|
||
|
||
```bash
|
||
/msd-quick
|
||
```
|
||
|
||
MSD がタスクの説明を求め、プランニングと実行を行います。成果物は `.planning/quick/` に配置されます。
|
||
|
||
説明を直接渡すこともできます:
|
||
|
||
```bash
|
||
/msd-quick "Fix the login button not responding on mobile Safari"
|
||
```
|
||
|
||
### フラグ
|
||
|
||
タスクに応じて品質パイプラインをより多く組み込むためにフラグを追加します。
|
||
|
||
| フラグ | 追加される内容 |
|
||
|------|-------------|
|
||
| `--discuss` | プランナー実行前にグレーゾーンを浮き彫りにし、決定事項を `CONTEXT.md` に記録する軽量な事前検討 |
|
||
| `--research` | 対象を絞ったリサーチエージェントがプランニング前にアプローチ、ライブラリ、潜在的な問題を調査 |
|
||
| `--validate` | プランチェック(最大 2 回の反復)と実行後の検証 |
|
||
| `--full` | 上記すべて — `--discuss --research --validate` と同等 |
|
||
|
||
フラグは自由に組み合わせられます:
|
||
|
||
```bash
|
||
/msd-quick --research --validate # リサーチ + プランチェック + 検証(検討なし)
|
||
/msd-quick --discuss # プランニング前にグレーゾーンのみ確認
|
||
/msd-quick --full # 完全な品質パイプライン
|
||
```
|
||
|
||
### フラグを追加するタイミング
|
||
|
||
- タスクへのアプローチや使用するライブラリが不明な場合は `--research` を追加します。
|
||
- タスクがクリティカルなコードパスに触れており、検証エージェントに must-haves が満たされたことを確認させたい場合は `--validate` を追加します。
|
||
- タスクに設計上の選択肢があり、プランナーが実行する前に確定させたい場合(例: 適切なエラーハンドリングの挙動が明らかでない場合)は `--discuss` を追加します。
|
||
- タスクが実質的に重要でフェーズとしてプランするべきだが ROADMAP に含めたくない場合は `--full` を使います。
|
||
|
||
### クイックタスクの一覧と再開
|
||
|
||
```bash
|
||
/msd-quick list # すべてのクイックタスクとステータスを表示
|
||
/msd-quick status my-task-slug # 特定のタスクのステータスを表示
|
||
/msd-quick resume my-task-slug # 中断されたタスクを再開
|
||
```
|
||
|
||
---
|
||
|
||
## `/msd-fast` — インラインでの自明な編集
|
||
|
||
`/msd-fast` は現在のコンテキストで直接作業を実行します。サブエージェント、`PLAN.md`、リサーチはありません。自分で 1 分以内に実行できる変更のみに適しています。
|
||
|
||
```bash
|
||
/msd-fast "fix typo in README"
|
||
/msd-fast "add .env to .gitignore"
|
||
```
|
||
|
||
説明を省略すると MSD が求めます。
|
||
|
||
`/msd-fast` は続行前にタスクが実際に自明かどうかを確認します。スコープが大きすぎると判断した場合は停止してリダイレクトします:
|
||
|
||
```text
|
||
This looks like it needs planning. Use /msd-quick instead:
|
||
/msd-quick "your task description"
|
||
```
|
||
|
||
変更後、`/msd-fast` はアトミックにコミットし、`.planning/STATE.md` に `Quick Tasks Completed` テーブルが存在する場合はその行を追記します。
|
||
|
||
---
|
||
|
||
## `/msd-quick` が `/msd-fast` にない機能
|
||
|
||
| 機能 | `/msd-fast` | `/msd-quick` |
|
||
|------------|------------|--------------|
|
||
| サブエージェントプランナー | なし | あり |
|
||
| サブエージェントエグゼキュータ | なし | あり |
|
||
| リサーチエージェント | なし | オプション(`--research`) |
|
||
| プランチェック | なし | オプション(`--validate`) |
|
||
| 実行後の検証 | なし | オプション(`--validate`) |
|
||
| 検討フェーズ | なし | オプション(`--discuss`) |
|
||
| ワークツリー分離 | なし | あり(デフォルト) |
|
||
| タスクごとのアトミックコミット | 単一コミット | プランタスクごとに 1 つ |
|
||
| STATE.md トラッキング | テーブルが存在すれば行を追記 | 常に更新 |
|
||
| `.planning/quick/` 成果物 | なし | あり |
|
||
|
||
主な違いはサブエージェントの分離です。`/msd-quick` は新鮮なプランナーとエグゼキュータを別々のコンテキストウィンドウで起動するため、作業が適切にプランされ、コミットはタスクごとにアトミックになり、オーケストレータが結果を検証できます。`/msd-fast` は現在のコンテキストウィンドウのみを使用し、それらを必要としないほど自明な変更に意図的に限定されています。
|
||
|
||
---
|
||
|
||
## Related
|
||
|
||
- [フェーズループ](../explanation/the-phase-loop.md)
|
||
- [コンテキストエンジニアリング](../explanation/context-engineering.md)
|
||
- [コマンド](../COMMANDS.md)
|
||
- [ドキュメント索引](../README.md)
|