design-plan
Installation
SKILL.md
Design Plan
把需求转成可执行方案。小任务只做轻量确认;中大型任务生成 design.md 和 plan.md。
核心原则
- 只追问阻塞性问题;非阻塞不确定点写入 Assumptions 后继续。
- 文档服务当前任务,不为未来扩展预留复杂设计。
- 所有文件和影响范围必须基于用户需求、功能路由图和代码事实。
- 小任务默认不生成重文档,除非用户要求。
任务分级
small:需求明确、影响文件少、无架构变化。输出轻量执行说明,可直接进入exec-plan。medium:多文件、完整功能链路或有行为变化。生成design.md和plan.md。large:跨模块、架构调整、数据迁移、安全风险。生成完整文档,并等待用户确认后执行。
工作流
- 读取
route-lookup技能的输出结果(功能定位、路由图覆盖状态、任务规模初判),结合相关功能路由图和必要代码上下文开展工作。本技能依赖route-lookup的结果,如尚未执行 route-lookup,应先加载该技能。 - 判断需求是否存在 Blocking Questions。
- 如有阻塞问题,一次性列出并等待用户回答;非阻塞问题写入 Assumptions。
- 输出需求确认摘要。
- 根据任务规模决定输出:
- 小任务:输出轻量执行说明(格式参考
exec-plan技能的「小任务执行说明」),不强制写文件。 - 中大型任务:写入任务目录,默认
docs/routespec/yyyy-MM-dd-{taskName}/。
- 小任务:输出轻量执行说明(格式参考
- 生成设计和执行计划后,说明是否需要用户确认。
需求确认摘要
# Requirement Summary
## Goal
- ...
## Scope
- In: ...
- Out: ...
## Assumptions
- 无 / ...
## Quick Checks
- 初步验收要点(详细 Acceptance Criteria 见 design.md)
## Blocking Questions
- 无 / ...
design.md 精简格式
# Design: {taskName}
## Goal
- ...
## Non-goals
- ...
## Current Behavior
- ...
## Proposed Behavior
- ...
## Affected Files
- `path/to/file`:影响说明
## Risks
- 无 / ...
## Test Strategy
- ...
## RouteSpec Impact
- Need route-sync: yes / no / uncertain
- Affected routes: ...
## Acceptance Criteria
- ...
plan.md 精简格式
# Execution Plan: {taskName}
## Summary
- ...
## Tasks
- [ ] Task 1: ...
- Files: ...
- Change: ...
- Verify: ...
- Depends on: none / ...
## Verification
- Commands: ...
- Manual checks: ...
## RouteSync
- Need route-sync: yes / no / uncertain
- Expected updates: ...
## Risks
- 无 / ...
plan.md 是交接给 exec-plan 技能的输入文件。
结束条件
- 阻塞问题已解决,或明确等待用户回答。
- 小任务已有足够执行说明。
- 中大型任务已生成
design.md和plan.md。 - 下一步明确指向
exec-plan或等待用户确认。
Related skills
More from gmwenterprise/route-spec
route-sync
同步、废弃或审计功能路由图;仅在用户明确要求整理归档时执行归档。适用于核心功能新增或删除、功能入口变化、核心实现迁移、关键测试入口变化,以及用户要求检查路由图是否过期时触发。
6route-lookup
查询功能路由图,定位相关功能、入口文件、核心代码和测试。当用户提出编码、修改、新增、删除功能等需求时触发。所有规模编码任务均需先加载。
6exec-plan
在 RouteSpec 工作流中执行 plan.md 或实施已定位的小型改动。当 route-lookup、plan 或 design 建议进入编码阶段时加载。
6route-init
首次创建功能路由图,定义格式模板并写入初始条目。仅当功能路由图不存在且当前任务需要代码定位时触发。
2