long-task-harness
为多会话长任务提供进度跟踪和上下文延续的智能体技能。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：long-task-harness。 它的用途是：为多会话长任务提供进度跟踪和上下文延续的智能体技能。 完整的 Skill 内容见：https://321skill.com/skills/long-task-harness/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请调用 long-task-harness 技能来帮助我们开发这个新的微服务。”，它会引导你在项目中初始化进度跟踪文件，创建功能清单，并为你安装合适的会话钩子。在后续每次开始工作时，钩子会自动提醒你或智能体先读取最新进度，确保无缝衔接上次的工作。
介绍
Long Task Harness 旨在解决AI智能体在跨多个会话执行长周期任务时，因上下文窗口重置而导致的“换班”问题，即每次新会话都从零开始，丢失了之前的进度和连续性。
该技能通过建立结构化的文件系统工作流来维持任务连续性。它会在项目根目录创建 .long-task-harness/ 文件夹，其中包含记录详细会话日志的 long-task-progress.md 和以JSON格式跟踪功能点完成状态的 features.json。用户或智能体可以通过配套脚本高效读取历史进度，例如仅加载最近几次会话以节省大量上下文Token。
它非常适合需要数天甚至更长时间才能完成的复杂项目，例如开发一个完整应用、撰写长篇技术文档或进行深度数据分析。无论是全栈开发、项目经理还是智能体开发者，只要面临需要中断和恢复的长期工作，都能从中受益。
使用建议是，在项目启动之初就立即调用该技能进行初始化。对于支持原生钩子的智能体（如Claude Code），建议启用会话启动和预提交钩子，以获得自动提醒和提交前检查，确保进度更新不被遗漏。
核心特点
与简单的笔记或待办事项技能不同，它深度集成了智能体工作流，提供了针对Claude Code、Pi等不同智能体的原生钩子，能在会话开始时自动提醒更新进度，并在提交代码前检查进度文件是否已更新，实现了真正的“交接班”自动化。其核心模式直接借鉴并代码化了Anthropic和HumanLayer关于长任务智能体工程的最佳实践。
注意事项
该技能主要面向基于文件系统操作的编码或文档类智能体，对于纯对话型或无法访问本地文件系统的智能体环境支持有限。
常见问题
这个技能如何节省上下文Token？
通过 `read_progress.py` 脚本，可以仅加载最近几次会话的摘要，相比加载全部历史，能减少约78%的上下文消耗。
支持哪些AI智能体或编辑器？
原生支持Claude Code、Factory Droid和Pi，并通过Git预提交钩子为其他环境（如Cursor/Codex）提供基础警告功能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/long-task-harness/raw/index.md 读取 long-task-harness 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/long-task-harness/raw/index.md（查看排版版本）