任务同步包

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install task-sync-pack
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 task-sync-pack。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Task Sync Pack 是 Openclaw Skills 中用于可靠任务交接和人机协作的工具。它将确认后的任务定义提取为结构化 JSON 合同，并从同一来源确定性地生成面向人类和 AI 的任务说明。
输出是一个用于审查、执行和验证的 .task-sync.zip 包。合同始终是唯一权威来源；字节级检查、修订跟踪和安全覆盖行为可防止任务视图之间出现未记录的偏移。它适用于任务交接、外部协作和人机对齐，但不用于授予执行权限、传输完整聊天记录，或证明两段自由文本含义完全相同。

应用场景

将已确认的任务从人类交接给 AI 编码或运维代理。
为人和 AI 提供同一范围、交付物、约束和验收标准的不同视图。
使用带修订版本的任务合同协调外包工作或外部协作者。
创建可审查的任务确认和确定性重新生成档案。
任务说明更新或跨团队转移时防止指令偏移。
在需要跨机器执行状态、证据或落地检查时，将任务定义与 Task Passport 配对。
需求不完整时通过在
open_questions
中保留未解决事项来安全停止。

工作原理

从对话或现有任务系统提取结构化任务合同，并确认目标、范围、完成定义、约束、权限、交付物、下一步和未决问题。
按照 schema/task-contract.schema.json 编写合同。用户或现有任务系统提供 task_id 和 revision；每次合同更新都会递增修订版本，而不是替换之前的包。
运行本地确定性渲染器，生成包含权威合同、人类任务说明、AI 任务说明和面向验证内容的 .task-sync.zip 档案。
在分享或执行前运行验证器。它会检查档案内部一致性，并拒绝合同与渲染视图之间的偏移或篡改。
人类审查 任务说明.md 的范围和验收内容，AI 读取 AI任务说明.md 和 任务合同.json。
任一方发现歧义时，编辑源合同、递增 revision、重新构建并验证新包，不要手动修改生成的 Markdown 视图。
AI 执行期间遵循 definition_of_done、constraints 和 permissions；未解决需求保留在 open_questions 中，不得凭假设补充。
将执行结果、验证证据和新发现的问题写回任务系统或 Task Passport，而不是把完整聊天记录放入任务包。

配置指南

确保 Node.js 可用，因为 Openclaw Skills 元数据要求 node 二进制文件。
获取 Task Sync Pack 仓库或技能目录并进入：
git clone https://github.com/dongsheng123132/task-sync-pack.git
cd task-sync-pack
node --version
准备符合 schema/task-contract.schema.json 的 JSON 任务合同。不要编造未知值；将未解决需求记录在 open_questions 中。
构建同步包：
node scripts/task-sync-pack.mjs build --input --out .task-sync.zip
交付或执行前验证生成的档案：
node scripts/verify-task-sync-pack.mjs .task-sync.zip
若目标档案已存在且字节完全相同，构建具有幂等性并报告 changed: false。若内容不同，除非用户明确确认使用 --replace，否则不要覆盖；通常应创建新修订版本。
此设置不会授予运行时执行授权。合同权限必须保持在用户或已连接任务系统明确提供的范围内。

数据架构

权威来源
该包围绕一个以 JSON 存储、并根据 schema/task-contract.schema.json 验证的结构化任务合同组织。
字段 用途
task_id 任务的稳定标识，由用户或现有任务系统提供。
revision 单调递增的合同修订版本，用于区分更新后的包。
Objective and scope fields 定义预期结果和工作边界。
definition_of_done 可由人和 AI 检查的完成标准。
constraints 执行必须遵守的规则和限制。
permissions 明确可用的权限；任务文本不会授予额外的实时授权。
Deliverables and next step 指定预期输出和即时交接动作。
open_questions 不得用猜测填补的未知事项或未解决决定。
landing_checks 与 Task Passport 或相关任务系统协调时使用的集成或交接检查。
生成的档案
渲染器根据合同生成 .task-sync.zip 包。其核心同步视图包括：
任务合同.json：唯一权威的结构化合同。
任务说明.md：面向人类的任务范围、确认详情和验收指导。
AI任务说明.md：根据同一合同生成的面向 AI 的执行说明。
根据合同和渲染器版本生成的检查清单及验证内容。
该包使用确定性渲染：相同的合同内容、渲染器版本和文件名会产生完全相同的 ZIP 字节。验证和字节哈希使输出可复现；修订历史则为任务身份、版本、范围、验收、权限和未决问题提供安全分类。

高级特性

从一个源合同确定性地生成面向多个受众的视图。
通过字节级可复现性和基于哈希的验证检查档案完整性并检测偏移。
幂等构建，避免修改已存在且相同的包。
安全覆盖保护：除非用户明确提供 --replace ，否则拒绝覆盖内容已改变的目标。
以修订版本优先的工作流，保留早期包而不是静默覆盖任务历史。
由模式驱动的合同，为范围、验收、约束、权限、交付物和未决问题提供明确字段。
实现人机同步，但不把生成的 Markdown 当作权威来源。
保守处理歧义：AI 代理必须在
open_questions
处停止，而不是推断缺失需求。
当需要执行状态、跨机器继续、证据和落地检查时，为 Task Passport 或 TaskPack 提供集成指导。
清晰的安全边界：任务说明记录工作，但不授予外部操作权限，也不授权超出用户当前批准范围的操作。

name: task-sync-pack slug: task-sync-pack
display_name: 任务同频器
display_name_en: Task Sync Pack
displayName: 任务同频器 / Task Sync Pack
description: 把一项中文任务制作成“同频任务包”：从一个结构化任务合同，确定性生成给人看的任务说明、给 AI 执行的任务说明和可校验压缩包。适用于任务交接、外包协作、人机同屏确认；不用于传递聊天全文或替代跨机器事实复验。 description_zh: 一份任务合同，确定性生成给人和 AI 的两份中文说明及可校验压缩包。
description_en: Generate human and AI task views plus a verifiable archive from one structured task contract.
summary: 从一份任务合同确定性生成给人和 AI 的中文说明及可校验压缩包。
version: 0.1.1
license: MIT
homepage: https://github.com/dongsheng123132/task-sync-pack
tags:

• task-handoff
• task-contract
• ai-agent author: 2Origin