agent-infra: Skill for Claude Code

还原任务

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

从带有 sync 标记的平台 Issue 评论中恢复本地任务工作区文件。

行为边界 / 关键规则

• 只从匹配 .agents/rules/issue-sync.md 标记注册表的评论恢复文件
• 先恢复到 <task-workspace>/ 内的受控 staging，校验后由 lifecycle 原子落位到 active/{task-id}/
• 如果目标目录已存在，立即停止并提示用户先处理目录冲突
• 执行本技能后，你必须立即更新恢复出的 task.md

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

任务入参短号别名

如果 {task-id} 入参匹配 ^[#]?[0-9]+$（裸数字或带 # 前缀），先读取 .agents/rules/task-short-id.md 的「SKILL 入参解析」段执行解析；后续命令视 {task-id} 为解析后的全长 TASK-YYYYMMDD-HHMMSS 形式。

步骤开始：本地生命周期边界

评论解析阶段不写正式 active 目录。步骤 6 的单次 restore intent 统一校验 staging，并原子完成基础元数据、started/done 日志、正式落位和短号分配。

执行步骤

1. 验证输入与环境

检查：

• 必填参数 {issue-token}
• 可选参数 {task-id}
• 执行前先读取 .agents/rules/issue-pr-commands.md，并按其中的认证命令验证当前平台访问能力

如果用户传入了 {task-id}，校验其格式为 TASK-{yyyyMMdd-HHmmss}。

2. 获取 Issue 评论

调用 agent-infra-internal platform-comment list --issue {issue-token} 读取全部分页评论，保留原始顺序和评论 ID；平台上下文、认证和 upstream 由 internal intent 处理。

3. 确定 task-id 与待恢复文件

按 .agents/rules/issue-sync.md 中定义的 task、artifact 与分片 artifact 标记筛选评论。

处理规则：

• 用户提供了 {task-id} 时，仅匹配该任务
• 未提供时，优先从 task 评论标记推断
• 若找不到唯一 task-id，立即停止并告知用户
• 忽略 summary 标记评论；它是 complete-task 的聚合产物，不对应本地任务文件
• task、artifact 和交付摘要评论顶部的折叠恢复元数据由受控 recovery core 验证并重建活动日志。
• 将 {file-stem} 映射回文件名：
  • task -> task.md
  • analysis / analysis-r{N} -> 对应 .md
  • review-analysis / review-analysis-r{N} -> 对应 .md
  • plan / plan-r{N} -> 对应 .md
  • review-plan / review-plan-r{N} -> 对应 .md
  • code / code-r{N} -> 对应 .md
  • review-code / review-code-r{N} -> 对应 .md
  • pr-review / pr-review-r{N} -> 对应 .md

4. 处理分片并检查本地目录

执行本步骤前先读取 .agents/rules/issue-sync.md。

对每个文件执行：

• 收集单条评论或分片评论
• 从 task 评论恢复当前任务投影，再只从通过校验的 artifact 恢复元数据重建活动日志；不得根据缺失记录推测过程状态
• 如分片标记中存在 part 和 total 序号，按 part 升序排序并校验分片完整
• 从评论正文中提取文件内容，去掉隐藏标记、标题、恢复元数据和页脚
• 拼接得到最终文件内容

在写文件前检查：

• <task-workspace>/active/{task-id}/、blocked/{task-id}/、completed/{task-id}/ 均不存在
• 创建唯一 <task-workspace>/.restore-staging-* 路径，且与 active 位于同一文件系统