Cancel Task

---
name: cancel-task
description: >
  取消不再需要的任务并转移。
  当某个任务不再需要、应从 active 工作中撤下时使用。
  仅当对话包含可解析的任务引用时才可自动调用本技能。
---

# 取消任务
> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」。


## 行为边界 / 关键规则

- 本命令用于终止一个不再需要继续执行的任务，并转移到 `completed/`
- 只有在确认该任务无需继续实现、审查或修复时才可取消
- 有效 `platform_issue_identity` 存在时，Issue 同步属于必做项

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

## 任务上下文解析

> 入口可省略 task ref；显式 task scope 仅接受 `--task <ref>` 或 `-t <ref>`，不再解释位置 task ref。保留其余业务操作数后调用 `agent-infra-internal task-context resolve {task-scope}`；`{task-scope}` 为空或 task flag 之一。只读取结构化结果的 `taskId`，后续把 `{task-id}` 绑定为完整 `TASK-YYYYMMDD-HHMMSS`。解析失败时透传非零退出码，不自行扫描任务。

> 解析任务引用，并确认任务位于本技能支持的状态或目录且存在 `task.md`；无法定位时按未找到任务处理并停止。

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

确认前置条件后，由步骤 3 的单次 lifecycle intent 原子完成基础元数据、started/done 日志、目录转移和短号处理；不得提前手工写入局部状态。

## 执行步骤
### 1. 验证任务存在

依次检查以下目录：
- `.agents/workspace/active/{task-id}/`
- `.agents/workspace/blocked/{task-id}/`
- `.agents/workspace/completed/{task-id}/`

处理规则：
- 如果在 `active/` 或 `blocked/` 中找到：继续
- 如果只在 `completed/` 中找到且 `cancelled_at` 与 `cancel_reason` 有效：复用已记录的取消原因，跳过步骤 3-5，继续步骤 6 补齐 Issue 关闭与评论；其他 completed 任务停止
- 如果都不存在：提示 `Task {task-id} not found`

### 2. 判断取消标签

从 completed 任务重试时，只使用 `task.md` 已记录的 `cancel_reason`，不得采用本次输入改写取消原因。

根据取消原因推断 Issue 关闭标签：
- `status: superseded`：原因包含“重复”、“替代”、“合并到”、“已由 #123 / PR 替代”等语义
- `status: invalid`：原因包含“误报”、“不存在”、“无法复现”、“排查后无问题”等语义
- `status: declined`：原因包含“不做”、“暂不实现”、“优先级调整”、“方案否决”等语义
- 以上都不匹配：回退到 `status: declined`

后续同步到 Issue 时，使用最终推断结果替换现有 `status:` labels。

### 3. 执行本地生命周期意图

```bash
agent-infra-internal task-lifecycle {task-id} cancel --agent {standard-agent-token} --reason "{一行取消原因}"
```

仅 `status=applied|no-op` 视为本地取消完成。`status=failed` 时展示结构化 `error` 与 recovery steps，并以同一 intent 重试；不得手工编辑 task.md、移动目录或释放短号。

### 4. 验证本地终态

确认 `targetState=completed`、终态字段与短号效果符合结构化结果。

### 5. 验证转移

```bash
ls .agents/workspace/completed/{task-id}/task.md
```

确认任务目录已成功移动。

### 6. 同步到 Issue

检查 `task.md` 中是否存在有效的 `platform_issue_identity`。如果没有，跳过此步骤。

如果存在有效的 `platform_issue_identity`，以下操作均须取得 `applied` / `no-op` 且无错误后才能宣称取消全部完成；失败时保留本地终态和待恢复记录，修复后以同一任务重试本技能：
- 调用 `agent-infra-internal platform-issue sync {task-id} --agent {standard-agent-token} --status {reason} --in-labels none --assignees none --milestone none --state closed --close-reason not_planned`
- 将取消正文写入临时文件，调用 `agent-infra-internal platform-comment sync {task-id} --kind cancel --body-file {path} --agent {standard-agent-token}`
- 调用 `agent-infra-internal platform-comment sync {task-id} --kind task --agent {standard-agent-token}`

取消评论至少包含：
- 取消原因
- 选定的 `status:` label

### 7. 完成校验

运行完成校验，确认任务转移和同步状态符合规范：

```bash
agent-infra-internal task-verify {task-id} cancel-task.completed --format text
```

处理结果：
- 退出码 0（全部通过）-> 继续到「告知用户」步骤
- 退出码 1（校验失败）-> 根据输出修复问题后重新运行校验
- 退出码 2（网络中断）-> 停止执行并告知用户需要人工介入

按 `.agents/rules/validation-output.md` 展示当次校验摘要；没有当次校验输出，不得声明完成。

### 8. 告知用户

> 仅在校验通过后执行本步骤。

> 渲染下一步前先读取 `.agents/rules/next-step-output.md`，仅为已选场景调用统一 helper，并将 stdout 填入 `{next-step-commands}`。

> **可选沙箱清理提示（门控渲染）**：仅当同时满足 (1) `.agents/.airc.json` 存在 `sandbox` 字段、(2) task.md 的 `branch` 字段存在且不是 `main` / `master` 时，才渲染下方输出中「目标路径」之后、「下一步」之前的「可选：清理本任务的沙箱」块；任一不满足则整段省略。清理时使用完整 `{task-id}`，不要改用 branch 名。该块独立于「下一步」语义。

输出格式：
使用 `agent-infra-internal agent-client next-steps --skill check-task --task-ref {task-ref}` 生成本场景的 `{next-step-commands}`。

```
任务 {task-id} 已取消，任务目录已转移到 completed/。

取消原因：{reason}
状态标签：{status-label 或 skipped}
目标路径：.agents/workspace/completed/{task-id}/

可选：清理本任务的沙箱
（任务已完成并归档，沙箱容器和 per-branch 配置目录不会自动回收。如果不再需要可执行：）

ai sandbox rm {task-id}

下一步 - 查看已转移任务：
{next-step-commands}
```



## 完成检查清单

- [ ] 已记录取消原因并更新 task.md
- [ ] 已将任务目录移动到 `.agents/workspace/completed/`
- [ ] 已在存在 Issue 时完成 Issue 同步
- [ ] 已运行 gate 校验并通过
- [ ] 已通过统一 helper 渲染已选场景的下一步命令

## 注意事项

1. 取消任务不会新增 `cancelled` 状态值，而是复用 `completed`
2. 必须通过 `cancelled_at` 和 `cancel_reason` 区分“取消”与“正常完成”
3. 如果 Issue 关闭失败，不要宣称取消完成

## 错误处理

- 任务未找到：`Task {task-id} not found`
- 任务已转移：提示任务已在 `completed/` 中
- Issue 同步失败：保留本地转移结果，并告知用户需要人工补齐平台操作