用途:这是一个 Spec-Kitty 工作流例程,/spec-kitty.tasks-packages 用于从 tasks.md 的纲要生成个体任务提示文件 tasks/WP*.md。前提是 tasks.md 已存在并包含完整 WP 定义。工作目录为项目根检出,不创建 worktree;多特性仓库中每个 spec-kitty 命令都应传 --feature <slug>。
主要能力与用法:
- 先运行 spec-kitty agent context resolve --action tasks_packages --json,再执行返回的 check_prerequisites 命令并捕获 feature_dir,所有路径须为绝对路径。
- 读取 feature_dir/tasks.md,解析工作包、子任务与依赖。
- 为每个 WP 生成提示文件。文件必须放在扁平的 feature_dir/tasks/ 目录,文件名 WPxx-slug.md;不得放入 planned/、doing/ 等状态子目录;状态由 status.events.jsonl 管理。frontmatter 需含 work_package_id、subtasks、dependencies、history、requirement_refs,以及 owned_files、authoritative_surface、execution_mode。正文含目标、上下文、逐子任务指引、测试策略(仅在需要时)、完成定义、风险与评审指引,并更新 tasks.md 引用文件名。目标规模 200-500 行、3-7 个子任务;上限 700 行、10 个子任务,超限应拆分。
- 依赖与所有权:无依赖用 spec-kitty implement WP01,有依赖用 spec-kitty implement WP02 --base WP01。不同 WP 的 owned_files 不得重叠,authoritative_surface 须为某个 owned_files 的前缀,execution_mode 取 code_change 或 planning_artifact。代理不得修改 owned_files 之外的文件。
- 自检子任务数与预计行数,判断能否单次会话完成。
限制:资料未提供具体收费、运行环境要求与错误排查细节;输出是否成功需依赖 tasks.md 内容与工具实际返回。