Skip to content

Commit 33bcd48

Browse files
committed
feat: update update-plan prompt draft
1 parent c638114 commit 33bcd48

2 files changed

Lines changed: 13 additions & 260 deletions

File tree

docs/SKILL.md

Lines changed: 0 additions & 252 deletions
This file was deleted.

docs/SKILL_new.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,20 @@ This Skill helps you automatically plan and execute requirements. It creates a s
1212
When you need to work through a multi-step request:
1313

1414
1. Analyze the requirements and explore enough project context
15-
2. Create a markdown task list by calling the UpdatePlan tool
16-
3. Execute tasks one by one, updating the tool plan in real time
17-
4. Revise the remaining plan as new context appears
15+
2. Clarify unclear or ambiguous requirements with AskUserQuestion
16+
3. Create a markdown task list by calling the UpdatePlan tool
17+
4. Execute tasks one by one, updating the tool plan in real time
18+
5. Revise the remaining plan as new context appears
1819

1920
## Instructions
2021

2122
### Step 1: Analyze the requirements
2223

2324
Identify the requirements from the available context. Explore the project enough to make the plan concrete and accurate.
2425

25-
If a required referenced file path is missing, ask for it:
26+
If the original requirements are unclear, incomplete, or ambiguous, call the AskUserQuestion tool before creating the task list. Ask only the questions needed to avoid implementing the wrong behavior, and keep each question specific to the decision that affects the plan or acceptance criteria.
27+
28+
If a required referenced file path is missing, ask for it with AskUserQuestion:
2629

2730
```
2831
What is the path to the referenced file?
@@ -35,6 +38,7 @@ Referenced files can be in any text format (.md, .txt, etc.) that contains task
3538
- Are there dependencies between tasks?
3639
- What is the complexity level?
3740
- Which files, modules, commands, or tests are relevant?
41+
- What ambiguity would change the implementation or acceptance criteria?
3842

3943
### Step 2: Create the task list
4044

@@ -229,13 +233,14 @@ Add implementation notes or findings:
229233
## Workflow Summary
230234

231235
1. Analyze the requirements and relevant project context
232-
2. Call UpdatePlan with the structured markdown task list
233-
3. Refresh the remaining plan before the first task
234-
4. For each task:
236+
2. Call AskUserQuestion if the original requirements are unclear or ambiguous
237+
3. Call UpdatePlan with the structured markdown task list
238+
4. Refresh the remaining plan before the first task
239+
5. For each task:
235240
- Update to `[>]` with UpdatePlan
236241
- Execute the task
237242
- Update to `[x]` with UpdatePlan
238243
- Re-evaluate and revise remaining tasks before moving on
239-
5. Call UpdatePlan with all tasks completed and summarize the result
244+
6. Call UpdatePlan with all tasks completed and summarize the result
240245

241246
This approach keeps planning and progress tracking in the UpdatePlan display, leaving source materials unchanged unless the actual task requires editing them.

0 commit comments

Comments
 (0)