任务续接 han719307-dotcom/task-continuity

任务连续性：长时间运行的 AI 智能体任务交接技能

一个只含指令的 Agent Skill，让长时间运行的工作在暂停、上下文压缩和线程交接之后仍能接着做。

一个只含指令的 Agent Skill，让长时间、多阶段任务在暂停、上下文压缩或会话交接后仍可恢复。

想恢复长时间运行的 AI 编码任务、在上下文压缩后找回任务，或者把没做完的工作交给新线程？这个 Skill 就是为这类问题准备的。

想恢复被上下文压缩打断的长任务、让新线程继续未完成的工作，或避免 AI 智能体重复已经做过的事情？这个 Skill 面向的正是这类问题。

flowchart LR
A[Long-running task] --> B[Compact task card]
B --> C[Pause / compaction / new thread]
C --> D[Verify workspace evidence]
D --> E[Resume the next concrete action]

概述

Task Continuity 维护一张紧凑、有证据支撑的任务卡，而不是试图保住整段对话。它帮智能体判断：什么时候该做连续性管理、一个任务在哪里结束、怎么交接工作、怎么根据工作区里核实过的证据恢复。

这个仓库只包含指令和 UI 元数据。没有要启动的服务，不用装依赖，也没有构建步骤。

为什么需要 Task Continuity？

长时间运行的智能体会话，出问题的地方往往在边界上，而不在单条命令里：

- 上下文压缩之后，最初的目标和完成标准丢了；
- 已经做完的工作、失败过的做法，又被重新发现一遍；
- 新线程启动时，不知道哪些决策仍然有效；
- 摘要说工作已完成，工作区里却不是这么回事。

Task Continuity 只保留那些会改变后续行动的、已核实的状态，这样智能体就能接着做，而不是从头再来。

常见搜索意图

这个技能适用于这类任务：

- 「上下文压缩后恢复长时间运行的 Codex 任务」；
- 「把没做完的工作交接给新的 Claude Code 线程」；
- 「跨会话保留 AI 智能体任务状态」；
- 「智能体上下文用尽后防止重复劳动」；
- 「为 Codex、WorkBuddy 或 DeepSeek Harness 生成紧凑的任务交接」。

功能

- 维护一份 TASK_CARD.md，每个进行中的交付各占一节。
- 记录完成标准、已核实的证据、下一步行动、约束和未解决的风险。
- 区分继续、独立交付和无关任务这三种边界。
- 生成紧凑的交接，不用复制整段对话。
- 把恢复时的说法与当前文件、diff、测试和产物逐一核对。
- 明确把密钥、访问令牌、私钥和敏感日志排除在任务卡之外。
- 简单的问答和单轮编辑不建多余的任务卡。

仓库结构

task-continuity/
├── SKILL.md # Skill metadata and complete workflow instructions
├── agents/
│ └── openai.yaml # Display name, short description, and default prompt
├── .gitignore # Excludes secrets, local state, dependencies, and outputs
├── LICENSE # MIT license
└── README.md # Bilingual project documentation

环境要求

使用支持 Agent Skills 格式的宿主。技能本身不需要任何编程语言运行时，也不需要第三方包。

安装

把整个目录装到宿主使用的技能根目录下：

| 宿主 | 用户级根目录 | 项目级根目录 | 调用方式 |
| Codex | $CODEX_HOME/skills/task-continuity/（默认：~/.codex/skills/task-continuity/） | 在支持的情况下，使用宿主的项目技能根目录 | $task-continuity |
| Claude Code | ~/.claude/skills/task-continuity/ | .claude/skills/task-continuity/ | /task-continuity |
| WorkBuddy / CodeBuddy | ~/.codebuddy/skills/task-continuity/ | .codebuddy/skills/task-continuity/ | 技能选择器；启用斜杠调用时用 /task-continuity |
| DeepSeek Harness | ~/.dsh/skills/task-continuity/ 或 ~/.agents/skills/task-continuity/ | .dsh/skills/task-continuity/ 或 .agents/skills/task-continuity/ | /task-continuity |
| 其他 Agent Skills 宿主 | 宿主文档给出的技能根目录；支持共享根目录时用 ~/.agents/skills/task-continuity/ | 支持时用 <project>/.agents/skills/task-continuity/ | 因宿主而异；否则显式加载 SKILL.md |

克隆到用户级根目录之前，先建好父目录。

macOS 或 Linux：

export SKILLS_ROOT="$HOME/.codex/skills"
mkdir -p "$SKILLS_ROOT"
git clone https://github.com/han719307-dotcom/task-continuity.git "$SKILLS_ROOT/task-continuity"

Windows PowerShell：

$skillsRoot = Join-Path $HOME ".codex\skills"
New-Item -ItemType Directory -Force $skillsRoot | Out-Null
git clone https://github.com/han719307-dotcom/task-continuity.git (Join-Path $skillsRoot "task-continuity")

换用表中其他宿主时，把 SKILLS_ROOT / $skillsRoot 替换成对应的根目录。技能没出现就重开或重启宿主。

agents/openai.yaml 是 Codex 专用的；其他宿主会忽略它，直接读 SKILL.md。WorkBuddy 的托管技能编辑器还要求安装副本的 frontmatter 里有 agent_created: true。只给 WorkBuddy 托管的副本加这个字段，这样仓库里的标准 SKILL.md 对 Codex 和其他宿主仍然有效。

用法

没有独立的启动命令。安装完成后，用宿主的调用形式，或者直接让宿主应用这个技能：

$task-continuity

也可以写进请求里：

使用 $task-continuity 维护一份精简的任务卡，并核验这个长时间运行的任务应该从哪里继续。

在 Claude Code、DeepSeek Harness 以及支持斜杠命令的 WorkBuddy 会话中使用 /task-continuity。如果宿主没有技能加载器，就把它的 SKILL.md 作为附件或项目指令文件提供。

当任务与 SKILL.md 中的描述匹配时，宿主也可以自动选中该技能。用宿主的技能选择器确认它可用。

典型场景包括迁移、重构、发布、先调研后实现、长时间验证，以及必须经受暂停或交接的工作。它不适用于简单问答、单条命令检查，或一轮就能完成的编辑，除非你明确要求连续性。

如果它解决了你遇到的问题，请加一个 GitHub star，让更多智能体用户更容易发现这个项目。

验证

1. 确认 SKILL.md 的 YAML frontmatter 中包含 name 和 description。
2. 确认 agents/openai.yaml 包含预期的展示元数据。
3. 打开 Codex 技能选择器，确认其中出现 Task Continuity。
4. 在一个多阶段任务上调用 $task-continuity，检查生成的任务卡是否精简、及时，并且有工作区证据支撑。

项目目前没有自动化测试套件，因为它不包含可执行代码。

安全与本地状态

不要在 TASK_CARD.md、SKILL.md 或仓库元数据中存放凭据、私钥、个人数据或完整的敏感日志。根目录 .gitignore 已排除常见密钥文件、本地配置、依赖目录、构建产物和本地任务卡。每次提交前先检查暂存文件列表。

贡献

让技能专注于连续性管理。保留它精简的任务卡格式、证据优先的恢复工作流，以及纯指令式设计。当用户可见行为或安装步骤发生变化时，同步更新本 README 的两个语言部分。

许可证

本项目基于 MIT License 提供。

项目简介

Task Continuity 通过简短且有证据支撑的任务卡保存会影响后续行动的状态，而不是试图保留整段对话。它帮助智能体判断何时需要管理任务连续性、如何划分任务边界、如何交接，以及如何根据工作区证据恢复任务。

本仓库仅包含指令和界面元数据，不需要启动服务、安装依赖或执行构建。

为什么需要 Task Continuity？

长时间运行的智能体会话通常不是败在单条命令，而是败在任务边界：

- 上下文压缩后忘记最初目标和完成标准；
- 重新探索已经完成的工作或已经排除的方案；
- 新线程不知道此前已经确认的决定和约束；
- 摘要声称任务已经完成，但工作区实际情况并不一致。

Task Continuity 只保存会影响后续行动且已被验证的状态，让智能体接着做，而不是从头开始。

常见搜索需求

这个技能适用于寻找以下能力的人：

- “上下文压缩后恢复 Codex 长任务”；
- “把未完成任务交接给新的 Claude Code 线程”；
- “让 AI 智能体跨会话保留任务状态”；
- “避免智能体因上下文不足重复已完成的工作”；
- “为 Codex、WorkBuddy 或 DeepSeek Harness 生成精简任务交接”。

主要功能

- 使用一份 TASK_CARD.md，并为每个活动交付维护独立的任务卡段落。
- 记录完成标准、已验证证据、下一步行动、约束和未解决风险。
- 区分同一交付的延续、独立交付和无关任务的边界。
- 生成交接摘要，避免复制整段对话。
- 恢复任务时，根据当前文件、差异、测试和产物核验既有结论。
- 明确禁止在任务卡中记录密钥、访问令牌、私钥和敏感日志。
- 避免为简单问答和单轮即可完成的小修改创建不必要的任务卡。

项目结构 text task-continuity/ ├── SKILL.md # Skill 元数据与完整工作流说明 ├── agents/ │ └── openai.yaml # 显示名称、简短说明和默认提示词 ├── .gitignore # 排除密钥、本地状态、依赖和构建产物 ├── LICENSE # MIT 许可证 └── README.md # 中英文双语项目文档

环境要求

需要支持 Agent Skills 格式的宿主。技能本身不依赖编程语言运行时或第三方软件包。

安装方式

将完整目录安装到目标宿主使用的技能根目录：

| 宿主 | 用户级目录 | 项目级目录 | 调用方式 |
| Codex | $CODEX_HOME/skills/task-continuity/（默认：~/.codex/skills/task-continuity/） | 使用宿主支持的项目级技能目录 | $task-continuity |
| Claude Code | ~/.claude/skills/task-continuity/ | .claude/skills/task-continuity/ | /task-continuity |
| WorkBuddy / CodeBuddy | ~/.codebuddy/skills/task-continuity/ | .codebuddy/skills/task-continuity/ | 技能选择器，或启用斜杠调用时使用 /task-continuity |
| DeepSeek Harness | ~/.dsh/skills/task-continuity/ 或 ~/.agents/skills/task-continuity/ | .dsh/skills/task-continuity/ 或 .agents/skills/task-continuity/ | /task-continuity |
| 其他 Agent Skills 宿主 | 宿主文档指定的目录；支持共享目录时可用 ~/.agents/skills/task-continuity/ | 支持时使用 <project>/.agents/skills/task-continuity/ | 取决于宿主，或显式加载 SKILL.md |

用户级安装前需要先创建父目录。

macOS 或 Linux： bash
export SKILLS_ROOT="$HOME/.codex/skills"
mkdir -p "$SKILLS_ROOT"
git clone https://github.com/han719307-dotcom/task-continuity.git "$SKILLS_ROOT/task-continuity"

Windows PowerShell： powershell $skillsRoot = Join-Path $HOME ".codex\skills" New-Item -ItemType Directory -Force $skillsRoot | Out-Null
git clone https://github.com/han719307-dotcom/task-continuity.git (Join-Path $skillsRoot "task-continuity")

将 SKILLS_ROOT / $skillsRoot 替换为上表中目标宿主的目录。如果安装后没有显示，请重新打开或重启宿主。

agents/openai.yaml 仅用于 Codex；其他宿主会忽略它并读取 SKILL.md。WorkBuddy 的托管技能编辑器还要求安装副本的 frontmatter 包含 agent_created: true。只应在 WorkBuddy 托管的副本中添加该字段，确保仓库中的标准 SKILL.md 仍能被 Codex 和其他宿主校验。

使用与启动

本项目没有独立的启动命令。安装后，使用宿主的调用形式，或要求宿主应用该技能： text $task-continuity

也可以直接在请求中使用： text Use $task-continuity to maintain a compact task card and verify where this long-running task should continue.

在 Claude Code、DeepSeek Harness 和支持斜杠命令的 WorkBuddy 会话中可使用 /task-continuity。如果宿主没有技能加载器，可将 SKILL.md 作为附件或项目指令文件提供。

当任务符合 SKILL.md 中的描述时，宿主也可以自动选择此技能。可通过对应宿主的技能选择器确认它是否可用。

典型场景包括迁移、重构、发布、先研究后实施、长时间验证，以及需要跨暂停或交接继续的工作。除非用户明确要求管理连续性，否则它不适用于简单问答、单命令检查或单轮完成的修改。

如果这个项目解决了你遇到的问题，可以添加一个 GitHub Star，让更多 Agent 用户更容易发现它。

验证方法

1. 确认 SKILL.md 的 YAML frontmatter 包含 name 和 description。
2. 确认 agents/openai.yaml 包含预期的显示元数据。
3. 打开 Codex 技能选择器，确认能看到 Task Continuity。
4. 在一个多阶段任务中调用 $task-continuity，检查生成的任务卡是否精简、最新且有工作区证据支撑。

由于项目不包含可执行代码，目前没有自动化测试套件。

安全与本地状态

不要在 TASK_CARD.md、SKILL.md 或仓库元数据中保存凭据、私钥、个人数据或完整敏感日志。根目录 .gitignore 已排除常见密钥文件、本地配置、依赖目录、构建产物和本地任务卡。每次提交前仍应检查暂存文件清单。

贡献说明

请让技能始终聚焦于任务连续性管理，保留精简任务卡、证据优先的恢复流程和纯指令设计。用户可见行为或安装步骤发生变化时，请同步更新本 README 的中英文部分。

许可证

本项目使用 MIT 许可证。

References / 参考资料

- OpenAI: Build skills
- 智能体技能规范
- Claude Code：用技能扩展 Claude
- DeepSeek Harness 仓库
- DeepSeek Harness 文档