前言¶

在 Cursor、Claude Code 等环境里，Agent 往往「一听就做」：范围没对齐就改代码，计划里只有任务名，验收写成「测试已通过」。用户真正需要的是先讨论取舍、再给出带实施方案的计划、共同确认最终验收目标，执行后还要审查与有限次修复，而不是把工具成功当成完成。

Task Driver 是 SkillHub 上由社区发布者 user_88546431 维护的 ai-agent 类 Skill（坐标 @user_88546431/task-driver-user-88546431，当前版本 1.1.6）。它用中文 Markdown 协议约束主控流程：九类参考模块提供方法，状态与授权由主控统一判断；不内置模型或业务 API，能力取决于宿主工具与环境。SkillHub 页面标注 requires_api_key=false，安装本 Skill 本身不要求 API Key。

这是什么¶

一句话定位：在用户用固定前缀唤起时，按固定链路完成分析讨论、计划与验收目标、授权后执行、验证与审查修复，并适配宿主目标工具同步任务状态。

与「直接改文件」的差异在于：讨论期每轮只请求一个独立用户回答；计划项须同时写「已确认」与「实施方案」；执行前区分计划确认、目标确认与执行授权；异常先分类，仅可修复问题进入修复循环（默认同一最终目标最多 3 次，用户可指定其他上限）。

核心功能¶

以下能力来自 Skill 包内 SKILL.md、README.md 及 references/ 文档，与 SkillHub 简介一致。

触发方式¶

用户消息以下列任一前缀开头时，Agent 须立即进入任务驱动：

tdr- ...
task-driver ...
/task-driver ...

SkillHub 与 SKILL.md 的 description 字段均写明上述规则。

固定链路与模块¶

主链路为：分析讨论 → 计划与目标 → 有效授权 → 执行 → 验证 → 审查及必要修复 → 必要交付/验收与已开启的独立复核 → 完成。已有条件不重走；范围变化只重开受影响部分。

主控按环节路由到九个职责模块（调查分析、讨论决策、计划设计、目标设计、子代理管理、执行控制、验证取证、审查修复、记录恢复），模块交回事实与缺口，不自行切换任务状态。

计划与验收目标¶

• 计划顶层事项对应已确认需求；每项包含「已确认」和「实施方案」，禁止只有任务名。
• 验收目标用可验证的终极结果表述，不把改文件、加测试等内部步骤膨胀成目标清单。
• 计划与目标默认分开展示与确认；执行前在内容已确认的前提下，再提供「执行（可选子代理）/ 不执行继续讨论」等选项（见主控展示策略）。

执行与目标工具适配¶

执行模块优先使用宿主聚合目标能力，或 TaskCreate、TaskList、TaskUpdate 等工具；对 deferred 工具需先加载 schema（例如文档中示例的 ToolSearch query="select:TaskCreate" 等，具体以宿主为准）。

若报 Invalid tool parameters，须核对 schema 后重试；仍失败则降级，且不计入目标修复次数。目标工具不可用时降级到计划类工具（如 update_plan）；两类均不可用时才在对话内维护轻量目标。

审查、异常分类与修复上限¶

主模型审查为必需步骤。未达标时先区分产物缺陷与证据缺口；必要验证未做且环境允许时，先取证，不计修复次数。

可修复问题走「打回 → 修复 → 重新审查」；需要用户验收、授权或决定、以及外部受阻等路径分别处理，多数不计修复次数。未指定时，同一最终目标最多修复 3 次；最后一次修复后仍须复验。独立复核次数单独累计（默认最多 3 次），与修复次数不因恢复或换代理而重置。

适用边界（30 秒选择器）¶

README 建议：目标或验收不清、多文件/多系统、涉及权限费用发布或重要文件变更、用户要求先计划或完整推进时使用；简单问答、单一安全命令、用户明确要求的小改动可直接处理。即使不用本 Skill，也不得伪造验收或越权执行。

安装与启用¶

安装 SkillHub CLI¶

若尚未安装 CLI，可按 SkillHub 官方安装说明检查或安装：

command -v skillhub && skillhub --version

# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装 Task Driver¶

SkillHub 页面给出的安装提示为：参阅 SkillHub 安装文档，安装坐标 @user_88546431/task-driver-user-88546431。

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能不被识别：

skillhub install @user_88546431/task-driver-user-88546431 --dir <skills 目录>

常见路径（来自 SkillHub 安装文档，按你实际使用的客户端选择）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按宿主要求重启或刷新 Agent，使 Skill 被加载。本 Skill 为通用 SKILL.md 格式，协议正文在包内 SKILL.md 与 references/ 下。

典型用法¶

下面示例摘自 README「最短完整流程」，展示默认的分阶段确认路径（前文多轮讨论在示例中省略，实际仍须逐项闭合）。

用户以 tdr- 开头提出需求，经讨论确认范围后要求计划：

用户：tdr- 先讨论登录按钮错位的修复，再给计划。只修位置，不统一其他按钮样式。

确认计划与验收目标后，助手在计划与目标内容均已确认的前提下给出执行方式（开启子代理 / 主模型执行 / 继续讨论）。用户选择「执行，不开启子代理」后，按目标工具跟踪状态，完成实施、主模型审查修复与必要交付；若无法直接检查 UI，须给出验收步骤与通过条件，在用户反馈前不得标为完成。

日常唤起可写成：

tdr- 先和我讨论登录页按钮错位的修复范围，再形成计划并执行

环节话术、反例与受阻通知格式见包内 references/quick-start.md。

适用场景与注意¶

适合谁

• 需要可控授权链路的个人或小团队，在 Agent 里做功能开发、改造或运维类任务。
• 已具备 Cursor Goals、TaskCreate/TaskUpdate 或计划类工具之一的宿主，希望执行阶段有可见状态同步。
• 愿意在讨论与确认上多花轮次，换取范围与验收目标清晰。

限制与注意

• 协议不能替代宿主缺失的权限、设备或外部服务；受阻时应停止机械重试，见 references/review.md 异常分类。
• 原生选择器不可用时，文档要求降级为正文编号选项，不能声称已弹窗。
• SkillHub 元数据（截至抓取）：社区来源、分类 ai-agent、评分 100000、下载 903；统计会随 SkillHub 更新变化，以页面为准。
• 发布者提供的自测脚本依赖 Bash、rg、python3，面向 Skill 维护者而非终端用户日常步骤。

结尾¶

Task Driver 把「讨论—计划—验收目标—授权执行—验证审查」写成可执行的 Agent 协议，并对接 deferred 目标工具与有限次修复，适合复杂、有风险的编码与交付任务。安装与说明以 SkillHub 为准：

• SkillHub 页面：https://www.skillhub.cn/skills/user_88546431/task-driver-user-88546431
• API 坐标页：https://api.skillhub.cn/user_88546431/task-driver-user-88546431