如何安装并使用 WeeklyPlanner 任务规划 Skill
2026年8月4日
你安装的到底是什么
任务规划 Skill 不是第二套计划工具，也不是一段孤立提示词。它是一组可以重复使用的指令、工作流和参考文件，告诉兼容的 AI 智能体怎样操作真实任务。
当前 WeeklyPlanner 任务规划 Skill把 WeeklyPlanner 作为唯一可信来源。它可以根据请求进入早间、午间或晚间摘要，整理收集箱，完成每周复盘，辅助排期，或者直接管理任务。Skill 提供执行方法，另行注册的连接器负责提供结构化任务工具。
安装时必须保留这层区别。复制 Skill 不会自动认证账号、注册连接器、创建定时任务或发送消息。这些动作彼此独立，都需要单独授权。
开始前准备三项内容
- 支持本地 Skills 的 Codex 或 Claude 环境。
- 完整的当前
task-planner目录，包括SKILL.md、workflows/和references/。 - 一个 WeeklyPlanner 账号，以及新会话能够发现的对应连接器。
不要只复制 SKILL.md。主文件会把具体执行分流到相关工作流和安全参考；删掉这些文件，经过约束的执行合同就会退化成一段残缺提示词。
当前 V1 以本地 Skill 目录形态分发。不同 AI 客户端并没有统一安装命令，因此应使用客户端官方支持的本地 Skill 导入或目录机制。本指南只说明跨环境必须保持一致的部分，不虚构尚不存在的一键安装器。
第一步：导入完整 Skill 目录
把 task-planner 目录导入或复制到 AI 客户端用于加载本地 Skills 的位置，保留目录名称和内部结构。
导入后，先确认客户端能发现名为 task-planner 的 Skill。这只能证明工作流文件已经可见，不能证明当前会话已经具备 WeeklyPlanner 工具和账号访问能力。
如果客户端提供 Skill 详情页，检查 setup、收集箱整理、每周复盘和排期辅助等引用工作流是否都在。不要为了适配一台机器，把平台专属路径硬写进 Skill；跨平台适配层应负责映射等价能力。
第二步：新建会话并明确调用
安装后新开一次会话，给智能体一个边界清楚的 WeeklyPlanner 请求，并点名 Skill：
使用 task-planner 列出我本周尚未完成的 WeeklyPlanner 任务，按日期汇总；不要创建、修改、完成、移动或删除任何内容。
这条请求同时限定了读取日期范围和禁止写入的边界。用户要求查看某天、某周或某种筛选条件，只授权对应范围的读取；智能体不应该为了测试连接而顺手查询无关设置或统计。
Skill 会在运行时发现连接器操作。如果当前会话没有暴露所需逻辑操作，正确结果是 SESSION_CAPABILITY_NOT_EXPOSED。这个状态只描述当前会话，不能据此推断连接器未安装、密钥缺失或服务不可用。
第三步：需要时单独连接 WeeklyPlanner
如果 Skill 已经加载，但 WeeklyPlanner 操作没有暴露，应按平台批准的连接器配置流程处理。MCP 任务管理器页面说明公开的 MCP 连接与最小 scopes 模型；至于本地连接器配置应该放在哪里，以你所用客户端的当前文档为准。
不要把凭据写进提示词、截图、代码仓库或 Skill 目录。Skill 只记录环境变量名称和非秘密偏好，真实值应通过连接器或获准运行环境的受保护配置注入。
注册连接器、完成认证、执行首次只读调用、配置推送通道、发送测试消息和创建定时任务，是六个不同步骤。授权其中一步，不会自动授权下一步。
第四步：用一次窄范围读取验证
执行前面的只读周任务请求，并与可视化计划逐项核对：
- 日期和时间块是否与周视图一致；
- 已完成和未完成任务有没有混在一起；
- 未安排任务是否继续保持未安排，而不是被虚构日期；
- 有没有任务被创建、移动、完成或删除；
- 响应中是否没有凭据和原始内部事件记录。
如果智能体返回历史 day review，应保留 coverage 信息。完成率为 null 时必须继续保持 null。当前任务统计与历史上当天开始时的承诺回答的是不同问题，不能悄悄拼成一个数字。
WeeklyPlanner 任务规划 Skill 说明页集中列出了 V1 工作流和安全边界，可用来判断某项能力是正常缺口，还是页面做出了不受支持的承诺。
第五步：授权一次测试写入
只读路径正确后，再测试一次可回退的单项写入。例如：
创建一项名为“验证 task-planner 配置”的任务，安排在明天上午，然后回读这项任务；不要修改其他任务。
智能体应创建任务、记录 task ID，再读取同一任务。确认它真实出现在周视图以后，才进入批量修改。
更新时只指定一项任务和一个字段；完成任务时，使用最近一次列表里的编号并点名该项；删除时只选择刚才的测试任务。“把所有事情整理一下”无法证明哪些写入获得了授权，不适合作为安装验收请求。
排期辅助为什么更严格
多任务排期遵循更严格的顺序：
- 读取当前任务和更新版本。
- 预览建议日期或时间块。
- 等待明确确认。
- 使用冲突感知补丁执行已批准修改。
- 回读每一项受影响任务。
Skill 不会批量移动循环任务子项。清除日期时，也不会让任务残留有效时间块或具体时间。这些规则是工作流的一部分，不能为了“更方便”在安装时删掉。
每日摘要与外部推送是两件事
早间、午间和晚间工作流可以直接在当前对话生成摘要，外部投递只是可选能力。
飞书/Lark 与 Telegram 需要另外配置的能力或受保护运行时变量。选择通道不等于授权登录、选择收件人、发送测试消息或创建定时任务，每一个外部动作都需要明确批准和真实成功证据。
这层分离可以避免常见误区：把“安装 Skill”当作创建持久后台自动化的许可。安装只让工作流可用，不会扩大权限。
正式使用前的最小验收清单
- 客户端能发现
task-planner以及全部引用文件； - 新会话能找到所需 WeeklyPlanner 逻辑操作；
- 一次窄范围读取与可视化计划一致；
- 一次测试写入后按 task ID 回读；
- 多任务排期在确认前展示完整预览；
- 能力缺失时如实报告，不猜测凭据状态；
- 未经单独授权，不存在推送消息或定时任务。
这些检查通过后，再逐步扩大使用范围。建议顺序是直接读写任务、整理收集箱、排期辅助、每周复盘，最后才是可选的外部投递。
让同一份计划承担最终核验
计划 Skill 的长期价值，不是让 AI 输出更长的回答，而是让跨会话工作流保持一致，同时由可视化计划承担最终核验。
完整导入目录，有意识地连接能力，先证明一次窄范围读取，再授权最小写入。当前兼容范围、工作流和权限合同，以 WeeklyPlanner 任务规划 Skill 页面为准。