3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
125 lines
6.7 KiB
Markdown
125 lines
6.7 KiB
Markdown
# フェーズを自律的に実行する方法
|
||
|
||
残りのすべてのフェーズ、または限定した範囲のフェーズを無人で実行します。GSD がすべてのステップを自分でドライブすることなく、各フェーズの discuss → plan → execute を処理します。
|
||
|
||
自律実行中にフェーズループが何をしているかの背景については [フェーズループ](../explanation/the-phase-loop.md) を参照してください。
|
||
|
||
---
|
||
|
||
## 前提条件
|
||
|
||
- `.planning/ROADMAP.md` と `.planning/STATE.md` が存在するアクティブなプロジェクト
|
||
- 実行したいすべてのフェーズが自律モードで処理できる状態（pending または in-progress; 完了済みでない）
|
||
- 重要な設計上の決定事項は `PROJECT.md` に記載済みか、事前の `/gsd-discuss-phase` で記録済みであること。自律モードは `--interactive` を使用した場合のみグレーゾーンをインタラクティブに確認できます
|
||
|
||
---
|
||
|
||
## 残りのすべてのフェーズを実行する
|
||
|
||
```bash
|
||
/gsd-autonomous
|
||
```
|
||
|
||
GSD は `ROADMAP.md` を読み込み、数値順で未完了のすべてのフェーズを見つけ、それぞれについて discuss → plan → execute を実行します。すべてのフェーズが完了すると、マイルストーンライフサイクル（audit → complete → cleanup）を自動的に実行します。
|
||
|
||
---
|
||
|
||
## 特定の範囲のフェーズを実行する
|
||
|
||
`--from` と `--to` を使用して実行範囲を限定します。両フラグは小数のフェーズ番号（例: `3.1`）を受け入れます。
|
||
|
||
```bash
|
||
/gsd-autonomous --from 3 # フェーズ 3、4、5 …（完了済みのフェーズ 1、2 はスキップ）
|
||
/gsd-autonomous --to 5 # フェーズ 5 まで（5 を含む）
|
||
/gsd-autonomous --from 3 --to 5 # フェーズ 3、4、5 のみ
|
||
```
|
||
|
||
`--to` に達するとライフサイクルステップはスキップされます。マイルストーンのすべてのフェーズが完了していないためです。完了バナーに再開方法が表示されます:
|
||
|
||
```text
|
||
Resume with: /gsd-autonomous --from 6
|
||
```
|
||
|
||
---
|
||
|
||
## インタラクティブな検討を行いながら実行する
|
||
|
||
デフォルトでは、自律モードはスマート discuss（バッチテーブル提案）を使って検討の質問に自動的に回答します。プランと実行をメインコンテキスト外に保ちながら設計上の質問に自分で回答したい場合:
|
||
|
||
```bash
|
||
/gsd-autonomous --interactive
|
||
```
|
||
|
||
インタラクティブモードでは:
|
||
- `/gsd-discuss-phase` はインラインで実行され、あなたの回答を待機します
|
||
- プランニングと実行はバックグラウンドエージェントとしてディスパッチされるため、現在のフェーズがビルドされている間に次のフェーズについて検討できます
|
||
- メインコンテキストはリーンに保たれ — 検討の会話のみが蓄積されます
|
||
|
||
---
|
||
|
||
## 適用されるセーフティゲート
|
||
|
||
自律モードは GSD の品質パイプラインをバイパスしません。各フェーズは引き続き:
|
||
|
||
- 実行前にプランチェッカーを実行します
|
||
- 実行後に `VERIFICATION.md` を読み込み、結果に応じてルーティングします
|
||
- 検証状態が `human_needed` または `gaps_found` の場合、一時停止して対応を求めます
|
||
- いずれかのステップが失敗した場合、停止してオプション（修正して再試行、フェーズのスキップ、または停止）を提示します
|
||
|
||
手動実行との唯一の違いは、`passed` の検証が自動的に次へ進む点です — 決定が必要な場合を除き、フェーズ間でプロンプトが表示されません。
|
||
|
||
パッケージ正当性ゲートも有効です。プランに不審なパッケージの `checkpoint:human-verify` タスクが含まれている場合、エグゼキュータは停止してチェックポイントを表示します。自律モードはフラグが立ったパッケージを無言でインストールしません。
|
||
|
||
---
|
||
|
||
## 自律モードを使用しない場合
|
||
|
||
`/gsd-autonomous` を使用しないケース:
|
||
|
||
- **フェーズに未解決の設計上の決定事項がある場合。** `/gsd-discuss-phase` を実行しておらず、`PROJECT.md` にあなたの方針が記載されていない場合、スマート discuss はあなたが同意しない自律的な選択をする可能性があります。先にインタラクティブで discuss を実行するか、`--interactive` を使用してください。
|
||
|
||
- **単一フェーズを細かく制御する必要がある場合。** 1 つのフェーズであれば、`/gsd-execute-phase N` で段階的な出力を確認しながら続行前に対応できます。自律モードは大規模な無人実行向けに設計されています。
|
||
|
||
- **フェーズに新規性の高い、またはリスクの高い作業が含まれる場合。** 自律モードはブロッカーに当たらない限り一時停止をスキップします。予期しない事態が想定されるフェーズでは、手動実行でループに留まってください。
|
||
|
||
- **部分的な実行が済んでいる途中フェーズの場合。** 自律モードは未完了フェーズを引き継ぎますが、部分的に実行されたウェーブは再開しません。すでに進行中のフェーズを完了させるには `/gsd-execute-phase N` を使用してください。
|
||
|
||
実行が途中で停止した場合、何が問題だったかの診断方法については [実行失敗のデバッグ](debug-a-failed-execution.md) を参照してください。
|
||
|
||
---
|
||
|
||
## 実行中の進捗確認
|
||
|
||
自律モードは各フェーズの前に進捗バナーを表示します:
|
||
|
||
```text
|
||
GSD ► AUTONOMOUS ▸ Phase 3/7: Auth Middleware [████░░░░] 28%
|
||
```
|
||
|
||
セッション途中で実行状況を確認する必要がある場合は、別のターミナルを開いて次を実行します:
|
||
|
||
```bash
|
||
/gsd-progress
|
||
```
|
||
|
||
---
|
||
|
||
## 停止後の再開
|
||
|
||
ブロッカープロンプトで「Stop autonomous mode」を選択した場合、またはセッションが中断された場合は、停止した場所から再開します:
|
||
|
||
```bash
|
||
/gsd-autonomous --from 4 # 4 を最初の未完了フェーズ番号に置き換える
|
||
```
|
||
|
||
GSD は完了済みのフェーズを自動的にスキップするため、停止した場所が不明な場合は早めのフェーズ番号から安全に再実行できます。
|
||
|
||
---
|
||
|
||
## Related
|
||
|
||
- [フェーズの実行](execute-a-phase.md)
|
||
- [実行失敗のデバッグ](debug-a-failed-execution.md)
|
||
- [コマンド](../COMMANDS.md)
|
||
- [ドキュメント索引](../README.md)
|