使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/alexbruno/dev-skills --skill planning-and-task-breakdown开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Planning & Task Breakdown
Decompose specifications into clear execution steps (workflow/PLAN.md) and, when warranted, small verifiable tasks (workflow/TASKS.md) before writing any implementation code.
Language & Architecture Agnostic: This skill applies to any technology stack, domain, or project structure. Reason in terms of deliverables, boundaries, dependencies, and verification—never assume specific languages, frameworks, or architectural patterns.
Core Rule
Plan in read-only mode. Explore the repository, map dependencies, and write the plan before modifying any deliverable files. Do not start implementing while planning.
When to Apply
- Translating
workflow/SPEC.mdinto an actionable execution plan (workflow/PLAN.md). - Work feels too large, ambiguous, or multi-faceted to execute in a single pass.
- Multiple independent deliverables or parallel/asynchronous agent executions are possible.
- Skip formal breakdown for trivial, single-step edits where planning adds no value.
Planning Process
1. Ground in workflow/SPEC.md
- Read
workflow/SPEC.md(orworkflow/<change-slug>/SPEC.mdfor scoped initiatives).
- If
SPEC.mddoes not exist yet for a non-trivial change, create and align onSPEC.mdfirst.
- Confirm goals, non-goals, constraints, and acceptance criteria are unambiguous. Surface open questions before committing to a plan.
2. Explore & Map Dependencies (Read-Only)
- Inspect the relevant areas of the repository (preferring indexed context if
codebase-indexingis active). - Identify affected components, shared boundaries, and external constraints.
- Map the dependency graph: determine what blocks what, which steps must run sequentially, and which units are truly independent.
3. Author workflow/PLAN.md
Create or update workflow/PLAN.md (initializing workflow/ if missing):
- Reference
SPEC.mdrequirements rather than duplicating them. - Order steps logically—tackle high-risk or high-uncertainty unknowns early.
- Define a concrete Verification Strategy (automated checks, validations, or manual verification) for each step and for the overall change.
- Note risks and rollback considerations.
4. Shard into workflow/TASKS.md (Conditional)
Create workflow/TASKS.md only when at least one spec-driven-workflow trigger applies:
PLAN.mdis too large or comprehensive to execute cleanly in a single pass.PLAN.mdspans two or more distinct scopes, task types (feature,bugfix,refactor,docs), or independent deliverables that benefit from separate tracking.- Work can be split into independent units executed in parallel or asynchronously by different agents or contributors.
When creating TASKS.md, ensure every task has:
- Unique ID & Type (e.g.,
T1,feature|bugfix|refactor|docs|chore). - Explicit Dependencies: Clearly state blocking task IDs (or
None). - Disjoint Scope: Assign non-overlapping files or modules to parallel tasks to prevent merge conflicts.
- Objective Done Criteria: Concrete, verifiable conditions that prove the task is complete.
Quality Checklist
Before handing off PLAN.md (and TASKS.md) for execution:
- Every requirement and acceptance criterion in
workflow/SPEC.mdis covered by at least one step or task. - No circular dependencies exist, and parallel tasks have non-overlapping scopes.
- Every step/task is small enough to implement and verify in a single focused pass.
- No implementation code has been written prematurely during the planning phase.