gsd:discuss-phase

Agent Skills › davepoon/buildwithclaude › gsd:discuss-phase

gsd:discuss-phase

GitHub

通过自适应提问收集实现决策，识别未决灰色区域并引导用户深入讨论，最终生成CONTEXT.md以锁定关键选择，为下游研究者和规划者提供清晰执行依据。

plugins/gsd/skills/discuss-phase/SKILL.md davepoon/buildwithclaude

Trigger Scenarios

需要确定技术实现细节梳理需求中的模糊地带为后续开发阶段准备上下文

Install

npx skills add davepoon/buildwithclaude --skill gsd:discuss-phase -g -y

More Options

Non-standard path

npx skills add https://github.com/davepoon/buildwithclaude/tree/main/plugins/gsd/skills/discuss-phase -g -y

Use without installing

npx skills use davepoon/buildwithclaude@gsd:discuss-phase

指定 Agent (Claude Code)

npx skills add davepoon/buildwithclaude --skill gsd:discuss-phase -a claude-code -g -y

安装 repo 全部 skill

npx skills add davepoon/buildwithclaude --all -g -y

预览 repo 内 skill

npx skills add davepoon/buildwithclaude --list

SKILL.md

Frontmatter

{
    "name": "gsd:discuss-phase",
    "description": "Gather phase context through adaptive questioning before planning. Use --all to skip area selection and discuss all gray areas interactively. Use --auto to skip interactive questions (Claude picks recommended defaults). Use --chain for interactive discuss followed by automatic plan+execute. Use --power for bulk question generation into a file-based UI (answer at your own pace).",
    "allowed-tools": [
        "Read",
        "Write",
        "Bash",
        "Glob",
        "Grep",
        "AskUserQuestion",
        "Task",
        "mcp__context7__resolve-library-id",
        "mcp__context7__query-docs"
    ],
    "argument-hint": "<phase> [--all] [--auto] [--chain] [--batch] [--analyze] [--text] [--power]"
}

Extract implementation decisions that downstream agents need — researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.

How it works:

Load prior context (PROJECT.md, REQUIREMENTS.md, STATE.md, prior CONTEXT.md files)
Scout codebase for reusable assets and patterns
Analyze phase — skip gray areas already decided in prior phases
Present remaining gray areas — user selects which to discuss
Deep-dive each selected area until satisfied
Create CONTEXT.md with decisions that guide research and planning

Output: {phase_num}-CONTEXT.md — decisions clear enough that downstream agents can act without asking the user again

<execution_context> @${CLAUDE_PLUGIN_ROOT}/workflows/discuss-phase.md @${CLAUDE_PLUGIN_ROOT}/workflows/discuss-phase-assumptions.md @${CLAUDE_PLUGIN_ROOT}/workflows/discuss-phase-power.md @${CLAUDE_PLUGIN_ROOT}/templates/context.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. </runtime_note>

Phase number: $ARGUMENTS (required)

Context files are resolved in-workflow using init phase-op and roadmap/state tool calls.

**Mode routing:** ```bash DISCUSS_MODE=$(gsd-sdk query config-get workflow.discuss_mode 2>/dev/null || echo "discuss") ```

If DISCUSS_MODE is "assumptions": Read and execute @${CLAUDE_PLUGIN_ROOT}/workflows/discuss-phase-assumptions.md end-to-end.

If DISCUSS_MODE is "discuss" (or unset, or any other value): Read and execute @${CLAUDE_PLUGIN_ROOT}/workflows/discuss-phase.md end-to-end.

MANDATORY: The execution_context files listed above ARE the instructions. Read the workflow file BEFORE taking any action. The objective and success_criteria sections in this command file are summaries — the workflow file contains the complete step-by-step process with all required behaviors, config checks, and interaction patterns. Do not improvise from the summary.

<success_criteria>

Prior context loaded and applied (no re-asking decided questions)
Gray areas identified through intelligent analysis
User chose which areas to discuss
Each selected area explored until satisfied
Scope creep redirected to deferred ideas
CONTEXT.md captures decisions, not vague vision
User knows next steps </success_criteria>

Version History

502fc01 Current 2026-07-05 15:12

Metadata

Files: 0
Version: 13c9cb5
Hash: 75da5406
Indexed: 2026-07-05 15:12

gsd:discuss-phase