任务清
通过任务清 CLI 访问同一套 HTTPS MCP、权限、任务状态机和审计记录。让 Agent 负责理解自然语言与选择动作；让任务清服务端负责身份、租户隔离、可信数据、提醒和审计。
安全开始
- 将本 Skill 所在目录记为
<skill-dir>，通过bash "<skill-dir>/scripts/taskqing.sh" ...执行命令。不要自行拼接 HTTP 请求，也不要读取 CLI 凭据文件。 - 首次调用需要账号的命令时，CLI 会自动打开任务清 OAuth 授权页并等待用户确认。提前告诉用户需要在浏览器完成一次授权；绝不要求用户把访问令牌、授权码或密码粘贴到对话中。
- 如果系统没有全局 CLI，包装脚本会用固定版本
@taskqing/cli@0.1.0启动。执行前允许宿主展示正常的 Shell/联网确认，不绕过宿主权限提示。 - 先运行最小查询，不把“登录成功”当成业务操作成功。每次调用只代表当前已认证用户和工作区，绝不推断可访问其他租户或冒充其他成员。
- 需要准确命令和 JSON 约定时读取 references/cli.md；需要选择工具、角色或状态流转时读取 references/mcp-tools.md；混合动作或授权含义不明确时读取 references/interaction-examples.md。
判断用户意图
选择能满足用户意图的最小工作流：
- 责任摘要： 对“有什么变化”“现在轮到我做什么”、每日准备和站会，运行
focus。 - 查询任务： 先运行
tasks list查找候选项，再运行tasks get <task-id>获取权威详情、历史或证据。 - 通知摘要： 运行
notifications list，只陈述 CLI 返回的事实。 - 新建任务： 调用
create_task前，先判断负责人是否使用任务清；只需结构化标题和负责人。截止日期、验收标准和项目仅在用户提供或确有需要时补充。 - 生命周期操作： 必要时先刷新任务详情，再且仅再调用一个匹配的状态流转工具。
除非用户明确授权创建，否则不要把讨论、头脑风暴、会议纪要或提取出的行动项直接变成正式指派。“安排给小王”这类直接命令，在对象和必填信息没有歧义时，视为已经授权。
查询并汇总
生成责任摘要时：
- 运行
bash "<skill-dir>/scripts/taskqing.sh" focus。 - 优先展示
action_needed、未读变化、阻塞和逾期任务。 - 分开呈现“我安排的”和“指派给我的”。不要把纯信息变化误判为必须由用户处理的动作。
- 仅当下一步确实来自返回状态和
suggested_tools时才提出操作建议。
处理通知时，先汇总已返回通知，再标记已读。只有用户要求读取并清除通知时，才将本次摘要中实际展示的通知 ID 传给 mark_notifications_read。除非用户明确要求全部标记已读，否则不要传 all: true。
准备写操作
写入前：
- 确定唯一任务。如果标题匹配多项，展示候选项并询问用户选择，绝不猜测。
- 消除重要歧义。新建任务必须有明确负责人和跟进方式；截止日期与验收标准均可选。负责人是否使用任务清不明确时先询问；截止日期只精确到天。
- 遵守任务角色。协作任务只能由负责人本人接受和上报；代跟进任务由当前认证用户代录线下进度、阻塞和完成，绝不冒充负责人。
- 对从内容中推断的指派、取消、拒绝或最终验收，如果用户意图尚不直接，先说明实质影响并取得明确授权。
- 为每个逻辑写操作生成新的 UUID
command_id。完全相同的重试复用同一 UUID；参数改变或动作不同绝不复用。
执行并验证写操作
- 使用
bash "<skill-dir>/scripts/taskqing.sh" call <tool> --input '<json>'。大段或含复杂引号的 JSON 写到临时文件后使用--input @file.json，或通过 stdin 使用--input -。 - 如果尚不知道任务当前状态，在执行依赖状态的操作前调用
get_task。 - 使用最少必填参数调用一个匹配的写工具。只有 CLI 退出码为 0 且 JSON 返回成功结果时，才认为操作成功。
- 保留结构化错误的
code和服务端含义；遇到权限或状态错误时说明下一项有效操作，不绕过限制。 - 如果超时或连接失败导致结果未知，不要用新的
command_id盲目重试。先查询任务；只有确认未生效时才重试，并复用原命令 ID。
绝不编造成员、负责人、验收标准、截止日期、进度、阻塞、完成证据、接受或验收。自己的任务和代跟进任务提交完成后会原子进入 closed；只有提交人与验收人不同的协作任务才进入 completion_submitted 等待独立验收。
输出结果
先说已验证的结果，不罗列内部命令过程：
- 查询先列最需要处理的事项，再列相关变化或风险。
- 写操作说明改了什么、下一步由谁处理、可用时附上截止日期和新状态。
- 后续需要消歧时附任务 ID，省略内部成员 ID、OAuth 信息和原始载荷噪声。
- 没有待处理事项时直接说明，不虚构建议。
- 登录或联网失败时报告 CLI 的错误
code；不要建议用户复制 Token。可让用户手动运行包装脚本的login --no-open并打开其输出的授权地址。
