Dingtalk Misc

长尾产品集合 Skill（dingtalk-misc）

执行前路由

本文件只负责产品路由。先由下表确定唯一产品：单一、清晰的 Attendance、Report、Sheet 或 Dev 任务直接读取对应 reference（内含该任务所需的最小执行契约）；其它产品先读取 dingtalk-shared，再读取唯一产品 reference。仅在实际触发认证、profile、确认或错误恢复时补读一份精确 shared reference，不做冷启动预读。

同一请求同时出现日报、周报或简报名称与审批人、抄送人、审批路径、审批单等审批意图时，审批意图优先，统一路由 OA 并读取 oa.md；本次任务不得执行 dws report。OA 中没有同名模板也不能降级提交 Report，只能交付 OA 搜索结果或请求消歧。只有用户明确要求提交钉钉日志，且没有审批流语义时，才路由 Report。

Attendance 任务直接按产品索引读取一份最匹配的 attendance*.md，不要重复预读 dingtalk-shared。只有出现跨产品编排、profile/认证问题、未知全局错误或 Reference 明确指向 shared 时，才按需读取 shared 对应内容。

产品索引表

说明

• 命中产品后必须读取其 references/<product>.md，不要只凭索引推测命令。Report 只读 report.md；Sheet 常见闭环只读 sheet.md，复杂任务按进入阶段顺序加载子 reference，每阶段最多一份、常规任务最多三份，禁止批量预读或重复读取。
• Agoal / Report 边界：填写、提交或查询普通日报/周报/月报正文走 Report；规则级提交统计、按时/迟交/未提交人数、人员清单和跟催走 Agoal。出现“月报”不能单独判给 Report，必须结合“规则/统计/迟交/未提交/跟催”等业务词判断。
• 考勤例外：按索引表直接读取一份最匹配的 attendance*.md；不要先读 attendance.md 再读排班、报表或假期专项 Reference。只有一个任务确实跨两个独立考勤域时，才加载第二份。
• 考勤性能优化只允许减少重复的 shared/Reference/Help/Schema 加载和重复远程查询；禁止为节省 token 省略用户要求的记录、业务字段、分页、失败项、warning 或写后验证。需要“全部/完整”结论时必须保留并检查 endpoint exhaustion/总数等完整性证据。
• 考勤命令路径、flag、约束和返回声明以当前 live Cobra/Contract/精确 leaf Schema 为权威；attendance Reference 只维护业务路由、能力边界和工作流。已知命令直接执行，确有不确定性时最多读取一次精确 compact leaf，避免复制命令全集造成信息漂移。
• 产品自己的局部意图消歧文档命名为 references/<product>-intent-guide.md，不是共享的 references/intent-guide.md。
• 各产品之间跨产品协作若指向本包内的其它产品，已在对应 references/<product>.md 里写成"见本包 references/X.md"，无需切换 skill；若指向 top10 独立产品（如 chat/aisearch/doc），仍按 dingtalk-<product> 切换 skill。
• scripts/ 下 yida / finance / aiapp_create_and_poll.py 等见 unsupported-scripts.md；默认不要当正式能力调用。
• Dev 直达规则：应用状态、增删改查、能否删除→app.md；凭证→credentials.md；开放平台应用的管理成员/角色汇总→member.md，不是 Chat 群成员；权限→permission.md；安全配置→security.md；网页应用→webapp.md；机器人线上配置→robot.md；版本历史/待发布版本/发布→version.md；事件订阅→event.md；本机机器人连接器/Stream连接→connect.md；MCP→先读mcp.md，仅在进入对应阶段时再增量读取其 API 转换、映射、鉴权、表达式或故障定位子 reference，禁止一次性预读全集；明确跨两个以上 Dev 域→只先读recipes.md。单域任务只读一份；跨域也不要预读各专题，仅当真实响应出现本页未覆盖的特殊状态或字段时补读一份。无需先读 dingtalk-shared、devapp.md 或索引，禁止重复读取 Reference。
• Dev 命令纪律：默认使用可审计的 dws dev ... 原子路径，不为发现 shortcut 调用 dws dev help、子组 help 或 dws devapp +...。应用按名称定位只有 dws dev app list --name，没有 dws dev app search；现有应用的机器人名称、模式、状态用 dws dev app robot get，不走 dws chat bot；连接器是 dws dev connect ...，不在 dws dev app 下。已知 leaf 直接执行；只有当前参数确有不确定性时才读取一次该 leaf 的 compact Schema，Schema 不可用时才调用一次精确 leaf --help。不要用 group help 探路。
• Dev JSON 与分页：所有命令带 --format json；connect list/status 还必须带它们自己的 --json，否则实际输出是表格。app list、permission list、event list、version list 只接受游标分页：读取返回的 meta.pagination.endpoint_exhausted/next_token，续页传 --cursor <next_token>；禁止猜 --page、--page-num，也不要从 data 中找旧版 hasMore/nextCursor。
• Dev 完成纪律：执行前记下用户要求的每个交付项；按依赖顺序执行，删除/停用等清理放到最后。用户最初请求写操作只授权 dry-run，不是看过预检后的正式确认。必须先展示 dry-run 的准确对象、动作、业务参数和影响，再取得用户对该预览的明确确认；随后只把同一命令的 --dry-run 换成 --yes，目标或业务参数有任何变化都重新 dry-run、展示并确认。确认前不得发出非 dry-run 写调用；--dry-run 不是完成。写后只做一次必要回读。相同业务错误且参数、状态均未改变时不要重试；仅在新证据实际改变命令、参数或状态后重试一次。最终逐项回答，空列表也明确写“暂无”，不要用大段原始 JSON 挤掉其它结果。
• DevDoc 搜索预算：开放平台文档任务对每个用户主题先用原短语精确搜索一次；某主题无结果时最多再用一个由结果证据支持的同义词，随后如实报告未命中。禁止用 10 轮以上近义词、help 或跨产品搜索碰运气。
• OA 任务先读核心 oa.md。只有进入真实提单阶段才增量读取 oa-create.md，只有处理审批附件才增量读取 oa-attachments.md；不要为普通查询预读创建、控件、节点和附件全集。要求未来审批任务或实例发生变化时实时通知，切换独立的 dingtalk-event。开放平台应用事件配置仍属于 DevApp，按 dev/event.md 执行，不要与个人实时事件混淆。
• 原生 .md 与在线富文本 adoc、通用文件存储的边界见 markdown.md；原生 .html/.htm 文件读写见 html.md；跨组织 / profile 规则见 profile.md。
• PAT 行为授权不是开放平台应用权限；后者见 dev/permission.md。

Agent 使用 OpenNodes 带内容创建白板时，必须先执行 whiteboard render，展示 SVG 和渲染提示后停止，等待用户明确确认当前版本才能创建；修改后重新渲染和确认。不得跳过预览直接创建，最初的创建请求及创建后回读不能替代预览确认。详见白板入口的创建流程；空白创建、直接套用模板和已有白板更新不由此规则扩展。

Agent 更新已有白板内容（追加、修改、删除、清空）必须先执行 whiteboard +diff，展示差异和风险后停止，等待用户明确确认当前差异，再用同一 sourceDigest 执行 +update；diff 失败或有 blocker 时不得写入。不得换原子 update 绕过，render、dry-run 和写后回读不能替代 diff。详见白板入口的更新流程。