Task Pack 运行方式

Task Pack 是复杂 AI Coding 任务的运行包。它把一次较长任务拆成可执行、可恢复、可验证的结构，让 AI 执行会话即使中断，也能从状态文件继续。

它适合功能开发、文档迁移、审计整改、发布准备、公开 Pack 整理等需要多步推进的任务。

一个 Task Pack 包含什么

文件	作用
README.md	给人看的任务包说明。
manifest.json	任务包名称、版本、目标、适用仓库和入口。
PLAN.md	分阶段计划和完成条件。
EXECUTE_PROMPT.md	给 AI 执行会话的入口。
prompts/00-session-runbook.md	会话运行规则、上下文边界和恢复方式。
tasks/*.md	编号子任务，每个子任务有目标和验收。
SESSION_STATE.md	当前进度、下一步、验证和恢复点。

执行流程

1. 校验任务包结构是否完整。
2. 阅读 README.md、manifest.json、PLAN.md 和 EXECUTE_PROMPT.md。
3. 从 SESSION_STATE.md 判断是新任务还是恢复任务。
4. 按编号子任务执行，每完成一段就更新状态。
5. 运行对应检查并记录结果。
6. 最后给出收口，说明变更、验证、风险和下一步。

SESSION_STATE 示例

# SESSION_STATE

status: in_progress
current_task: tasks/02-update-docs.md
next_task: tasks/03-run-checks.md
resume_from: "完成 Seed 手册新增页面，待更新导航和检查脚本"

## 已完成
- tasks/01-audit-source.md
- tasks/02-update-docs.md

## 验证记录
- 待运行 npm run official-site:check

什么时候不需要 Task Pack

以下任务直接用 Prompt Spec 就够了：

• 单文件文案修正。
• 小型 bug 修复。
• 一次性命令查询。
• 不需要跨会话恢复的轻量任务。

公开任务包要求

公开 Task Pack 必须：

• 只使用仓库相对路径。
• 不包含真实密钥、客户名称、未公开 URL 或日志。
• 不引用私有仓库地址。
• 写清适用版本和验证方式。
• 通过脱敏和公开发布 gate。

下一步

阅读 创建 Task Pack，按模板写一个可以被执行和恢复的任务包。