Task Planning Skill

此技能提供結構化的規劃流程，用於將研究結果轉換為可執行的任務計劃。

When to Use This Skill

當你需要：

• •基於研究結果建立可執行的實作計劃
• •將複雜任務拆解為階段性的檢查清單
• •建立詳細的實作細節文檔
• •產生用於驅動執行的提示文檔

Core Principles

Research First

• •You MUST verify research document exists and is complete before planning
• •If research is missing: Use task-research skill immediately
• •If research needs updates: Use task-research skill for refinement

Planning Only, No Implementation

• •✅ You WILL create/edit files in .copilot-tracking/plans/, details/, prompts/
• •❌ You MUST NOT modify any source code or configuration files
• •❌ You MUST NOT plan without verified research

File Operations

Planning Workflow

1. Research Validation (MANDATORY)

1. •Search for research files in .copilot-tracking/research/
2. •Validate research completeness:
   • •Tool usage documentation with verified findings
   • •Complete code examples and specifications
   • •Project structure analysis with actual patterns
   • •External source research with implementation examples
   • •Evidence-based implementation guidance
3. •If research is missing/incomplete: Use task-research skill
4. •Proceed ONLY after research validation

2. Planning File Creation

3. Line Number Management

You MUST maintain accurate line number references:

• •Research → Details: Include specific line ranges (Lines X-Y) for each reference
• •Details → Plan: Include specific line ranges for each reference
• •On Updates: Update all line number references when files are modified
• •Verification: Verify references point to correct sections before completing

Template Conventions

You MUST use {{placeholder}} markers:

• •Format: {{descriptive_name}} with double curly braces and snake_case
• •Final Output: Ensure NO template markers remain in final files

Examples:

• •{{task_name}} → "API Migration Implementation"
• •{{date}} → "20260114"
• •{{file_path}} → "src/services/api.ts"

Output File Structures

Plan File (*-plan.instructions.md)

---
applyTo: ".copilot-tracking/changes/{{date}}-{{task_description}}-changes.md"
---

<!-- markdownlint-disable-file -->

# Task Checklist: {{task_name}}

## Overview
{{one_sentence_description}}

## Objectives
- {{specific_goal_1}}
- {{specific_goal_2}}

## Research Summary
- #file:../research/{{research_file}} - {{description}}

## Implementation Checklist

### [ ] Phase 1: {{phase_name}}
- [ ] Task 1.1: {{action}}
  - Details: .copilot-tracking/details/{{file}}.md (Lines X-Y)

## Dependencies
- {{tool_or_framework}}

## Success Criteria
- {{completion_indicator}}

Details File (*-details.md)

<!-- markdownlint-disable-file -->

# Task Details: {{task_name}}

## Research Reference
**Source**: #file:../research/{{research_file}}

## Phase 1: {{phase_name}}

### Task 1.1: {{action}}

{{description}}

- **Files**: {{file_path}} - {{purpose}}
- **Success**: {{criteria}}
- **Research**: Lines X-Y - {{section}}
- **Dependencies**: {{prerequisites}}

Prompt File (implement-*.prompt.md)

---
agent: agent
model: Claude Sonnet 4.5 (copilot)
---

<!-- markdownlint-disable-file -->

# Implementation Prompt: {{task_name}}

## Instructions

1. Create changes tracking file if not exists
2. Follow task-execution skill workflow
3. Implement #file:../plans/{{plan_file}} systematically
4. If phaseStop=true: Stop after each Phase for review
5. On completion: Delete this prompt file

## Success Criteria
- [ ] All plan items implemented
- [ ] Changes file continuously updated

Quality Standards

Completion Summary

規劃完成時，提供：

• •Research Status: [Verified/Missing/Updated]
• •Planning Status: [New/Continued]
• •Files Created: List of planning files
• •Ready for Implementation: [Yes/No] with assessment

Reference Files

• •See references/plan-template.md for complete templates