W00 Workflow Checkpoint（仅存档 + 读档）

这是独立于 w01~w05 的基础能力层，只负责两件事：存档（checkpoint） 和 读档（resume）。

⚠️ 核心强制要求

职责边界（严格）

• w00-workflow-checkpoint 只负责：

• 存档：写入/更新 checkpoint

• 读档：读取并恢复最近 checkpoint 上下文

• w00-workflow-checkpoint 不负责：

• 初始化 issue（由 w01/w02 等主流程阶段触发）

• 关闭任务（由 w05-task-closure 触发）

术语约定（避免歧义）

• 存档：默认指 checkpoint 更新（不是关闭任务）

• 读档：默认指恢复 checkpoint 上下文

• 归档/收尾：由 w05-task-closure 处理，不属于本 skill

触发方式（自动 + 手动）

• 自动触发：主流程阶段在关键节点自动调用本 skill 执行“存档/读档”。

• 手动触发（高频）：用户说 存档 、读档 时触发。

• 额外条件（存档兜底）：执行“存档”时，若上下文无可更新 issue（未提供 #issue 、无绑定 Issue # 、候选 0 条），允许直接创建 issue 并写入首个 checkpoint（创建并存档）。

管理对象

• 仓库：无固定默认值，按上下文解析（用户显式指定 > 当前 Git 仓库远程 > 用户选择）

• 示例仓库：qiao-925/qiao-skills （仅示例，不作为默认值）

• 任务标题：[<repo>] <目标短句> （示例：[qiao-skills] 优化 W00 自动存档触发 ）

• 仓库名写法：沿用仓库原始定义，不额外做大小写转换

• 标签：status:*

• type:*
• repo:*
• wf:* （可选：term:* ）

• wf:* 规范：使用完整阶段名（示例：wf:w02-task-planning ）

• 最小字段：Goal / Next / Last Turn（最后一轮对话）

AI Agent 行为要求

两个标准动作

存档（checkpoint）

• 写入：已完成 / 阻塞 / 下一步

• 追加：Last Turn （至少保留最后一轮对话内容：用户最后一次输入 + Agent 最后一次输出）

• 若阻塞：状态建议更新为 status:blocked

读档（resume）

• 读取 issue + 最近 checkpoint

• 返回：最后状态 + 下一步

存档判定流程（更新哪一个）

• 用户给出 #issue ：直接更新该 issue。

• 上下文有绑定 Issue # ：更新该 issue。

• 否则拉取当前仓库候选 issue（open + repo:* ）。

• 分支：

• 0 条：触发下文“额外条件（创建并存档）”。

• 1 条：自动选中并回报。

• 2+ 条：列出 3~5 条候选让用户选择；未选择前不写入。

读档判定流程（读哪一个）

• 用户给出 #issue ：直接读档。

• 上下文有绑定 Issue # ：优先读档该 issue。

• 否则列出当前仓库候选（优先 status:in-progress / status:blocked ）。

• 确定后输出读档摘要。

命令参考（统一使用 gh issue 原生命令）

• 存档：gh issue comment <id> -R <owner>/<repo> --body "检查点 YYYY-MM-DD HH:mm\nGoal: ...\n已完成: ...\n阻塞: ...\n下一步: ...\n\nLast Turn (verbatim)\nUser: ...\nAgent: ..."

• 读档：gh issue view <id> -R <owner>/<repo> --comments

• 候选列表：gh issue list -R <owner>/<repo> --state open --label "repo:<repo>" --limit 20 --json number,title,updatedAt,labels,url

输出规范

• 每次调用后返回：执行动作、Issue 编号/链接、当前状态、下一步建议。

• 多候选时必须先列候选并请求用户选择。

一行回执模板（强制）

• 存档回执：

• 已存档 #<issue> | 状态:<status> | 下一步:<next> | <url>

• 读档回执：

• 已读档 #<issue> | 状态:<status> | 下一步:<next> | <url>

字段规则：

• status / next 若缺失，使用 - 占位，不省略字段。

• 回执必须为单行，便于快速扫读与复制。

额外条件（创建并存档）

• 该条件仅在执行“存档”时生效，属于兜底分支，不改变“仅存档 + 读档”的主职责。

• 触发条件：未提供 #issue 、无绑定 Issue # 、候选 issue 为 0 条。

• 执行动作：创建 issue 后立即写入首个 checkpoint（不要求用户先手动初始化）。

• 回执：沿用存档回执模板（已存档 #<issue> | 状态:<status> | 下一步:<next> | <url> ）。

与 W01~W05 的关系

• w01/w02 ：负责初始化或绑定 issue；随后调用 W00 存档。

• w03/w04 ：执行中高频调用 W00 存档/读档。

• w05 ：负责关闭任务；必要时调用 W00 补最后一次存档。

手动调用示例

• 存档

• 读档

交互规则：用户只需输入关键词；issue 选择、字段补齐与候选列表由系统自动判定并交互确认。

边界情况

• 未提供 issue 且无候选：触发“额外条件（创建并存档）”。

• 候选过多：仅展示最近更新的 3~5 条。

• 仓库上下文不明确：先要求用户确认 <owner>/<repo> ，再执行存档/读档。

• gh 未登录：提示 gh auth login 。

• 不使用 alias，统一按上文原生命令执行。