gsd-plan-phase
GitHub生成可执行的阶段计划(PLAN.md)，支持研究、规划与验证闭环。提供强制刷新、仅查看、跳过验证及PRD/ADR导入等模式，适配VS Code Copilot环境，实现低成本迭代与跨AI评审集成。
Trigger Scenarios
Install
npx skills add AjayIrkal23/agentic-mercy-10x --skill gsd-plan-phase -g -y
SKILL.md
Frontmatter
{
"name": "gsd-plan-phase",
"description": "Create detailed phase plan (PLAN.md) with verification loop",
"allowed-tools": [
"Read",
"Write",
"Bash",
"Glob",
"Grep",
"Agent",
"AskUserQuestion",
"WebFetch",
"mcp__context7__*"
],
"argument-hint": "[phase] [--auto] [--research] [--skip-research] [--research-phase <N>] [--view] [--gaps] [--skip-verify] [--prd <file>] [--ingest <path-or-glob>] [--ingest-format <auto|nygard|madr|narrative>] [--reviews] [--text] [--tdd] [--mvp]"
}
Default flow: Research (if needed) → Plan → Verify → Done
Research-only mode (--research-phase <N>): Spawn gsd-phase-researcher for phase N, write RESEARCH.md, then exit before the planner runs. Useful for cross-phase research, doc review before committing to a planning approach, and correction-without-replanning loops where iterating on research alone is dramatically cheaper than re-spawning the planner. Replaces the deleted /gsd-research-phase command (#3042).
Research-only modifiers:
- No flag — when
RESEARCH.mdalready exists, prompt the user to chooseupdate / view / skip. --research— force-refresh: re-spawn the researcher unconditionally, no prompt. Skips the existing-RESEARCH.md menu.--view— view-only: print existingRESEARCH.mdto stdout. Does not spawn the researcher. Cheapest mode for the correction-without-replanning loop. If noRESEARCH.mdexists yet, errors with a hint to drop--view.
Orchestrator role: Parse arguments, validate phase, research domain (unless skipped), spawn gsd-planner, verify with gsd-plan-checker, iterate until pass or max iterations, present results.
<execution_context> @$HOME/.claude/get-shit-done/workflows/plan-phase.md @$HOME/.claude/get-shit-done/references/ui-brand.md </execution_context>
<runtime_note>
Copilot (VS Code): Use vscode_askquestions wherever this workflow calls AskUserQuestion. They are equivalent — vscode_askquestions is the VS Code Copilot implementation of the same interactive question API. Do not skip questioning steps because AskUserQuestion appears unavailable; use vscode_askquestions instead.
</runtime_note>
Flags:
--research— Force re-research even if RESEARCH.md exists--skip-research— Skip research, go straight to planning--gaps— Gap closure mode (reads VERIFICATION.md, skips research)--skip-verify— Skip verification loop--prd <file>— Use a PRD/acceptance criteria file instead of discuss-phase. Parses requirements into CONTEXT.md automatically. Skips discuss-phase entirely.--ingest <path-or-glob>— Use one or more ADR files instead of discuss-phase. Parses locked decisions + scope fences into CONTEXT.md automatically. Skips discuss-phase entirely.--ingest-format <auto|nygard|madr|narrative>— Optional ADR parser format override (autodefault).--reviews— Replan incorporating cross-AI review feedback from REVIEWS.md (produced by/gsd:review)--text— Use plain-text numbered lists instead of TUI menus (required for/rcremote sessions)--mvp— Vertical MVP mode. Planner organizes tasks as feature slices (UI→API→DB) instead of horizontal layers. On Phase 1 of a new project, also emitsSKELETON.md(Walking Skeleton). Can be persisted on a phase via**Mode:** mvpin ROADMAP.md.
Normalize phase input in step 2 before any directory lookups.
Version History
- 581d130 Current 2026-07-19 09:10
