speckit-tasks 是 SpecKit 规范驱动开发流程中的一个任务生成技能,作用是根据已有的设计文档,为某一功能生成一份可直接执行的 tasks.md。
用途 它面向已经完成需求与设计阶段、需要把方案拆解为开发任务的场景。生成结果按依赖关系排序,便于按阶段推进实现。
主要能力
- 读取设计文档:必需 plan.md(技术栈、库、项目结构)与 spec.md(带优先级的用户故事);可选 data-model.md(实体)、contracts/(接口契约)、research.md(决策)、quickstart.md(测试场景),若存在 .specify/memory/constitution.md 也会加载项目原则与治理约束。
- 按用户故事组织任务:每个用户故事(P1、P2、P3 等)单独成阶段,阶段内按测试(如要求)、模型、服务、接口、集成的顺序组织,保证每个阶段可独立测试。
- 生成依赖关系与并行示例:输出用户故事的完成顺序依赖图,以及每个故事的并行执行示例。
- 严格清单格式:每个任务以 - [ ] 开头,包含顺序任务 ID(T001、T002…)、可并行标记 [P]、仅用于用户故事阶段的故事标签(如 [US1]),以及明确文件路径的描述。
- 阶段结构:阶段一为项目初始化设置,阶段二为所有用户故事的前置基础任务,阶段三及以后按优先级排列用户故事,最后为打磨与跨领域关注阶段。
- 完成报告:输出 tasks.md 路径、任务总数、各用户故事任务数、并行机会、各故事独立测试标准,以及建议的 MVP 范围(通常为用户故事 1)。
使用方式 通过命令接收用户输入($ARGUMENTS)作为任务生成上下文。执行前会检查项目根目录的 .specify/extensions.yml,读取 hooks.before_tasks 下的扩展钩子:过滤 enabled 为 false 的项,无 condition 或 condition 为空的钩子视为可执行,含非空 condition 的钩子跳过并交给 HookExecutor 处理;钩子命令名中的点号替换为连字符(如 speckit.git.commit → /speckit-git-commit)。可选钩子输出提示供用户手动执行,强制钩子则输出 EXECUTE_COMMAND 并等待结果。随后从仓库根目录运行 .specify/scripts/powershell/setup-tasks.ps1 -Json,解析 FEATURE_DIR、TASKS_TEMPLATE 与 AVAILABLE_DOCS。生成 tasks.md 时以 TASKS_TEMPLATE 为结构模板,若为空则回退到 .specify/templates/tasks-template.md。完成后执行 mandatory post-execution hooks:读取 hooks.after_tasks,按同样的过滤与条件规则分发,强制钩子必须输出 EXECUTE_COMMAND。最后输出完成报告并校验所有任务符合清单格式。
适用场景 适用于采用 SpecKit 工作流、需要把规格与设计文档转化为分阶段开发任务清单的软件项目,尤其适合希望以用户故事为单位进行独立实现和测试、并明确 MVP 交付范围的团队。
限制 tasks.md 仅依据现有文档生成,不是所有项目都具备全部文档,缺失文档时基于已有内容生成;测试任务仅在功能规格明确要求或用户要求 TDD 时生成。关于收费、价格、支持平台与效果等信息,资料暂未提供。