dsh-crwu-workbench 0.0.10

package/skills/dws/dingtalk-minutes/scripts/test_minutes_scripts.py

@@ -0,0 +1,222 @@
+"""Minutes 示例脚本的离线 Contract 回归测试。"""
+
+import io
+import re
+import subprocess
+import sys
+import unittest
+from contextlib import redirect_stdout
+from pathlib import Path
+from unittest import mock
+
+
+SCRIPTS_DIR = Path(__file__).resolve().parent
+SKILL_DIR = SCRIPTS_DIR.parent
+SKILL_FILE = SKILL_DIR / 'SKILL.md'
+REFERENCES_DIR = SKILL_DIR / 'references'
+if str(SCRIPTS_DIR) not in sys.path:
+    sys.path.insert(0, str(SCRIPTS_DIR))
+
+import minutes_recent_summary
+from minutes_recent_summary import uuid_title_pairs_from_payload
+
+
+class MinutesScriptContractTest(unittest.TestCase):
+    def test_reference_graph_has_no_dead_or_orphaned_files(self):
+        markdown_files = [SKILL_FILE, *sorted(REFERENCES_DIR.rglob('*.md'))]
+        markdown_link = re.compile(r'\[[^\]]+\]\(([^)]+)\)')
+        graph = {path.resolve(): set() for path in markdown_files}
+        linked_scripts = set()
+
+        for source in markdown_files:
+            for raw_target in markdown_link.findall(
+                source.read_text(encoding='utf-8')
+            ):
+                target = raw_target.split('#', 1)[0].strip()
+                if not target or '://' in target or target.startswith('mailto:'):
+                    continue
+                resolved = (source.parent / target).resolve()
+                self.assertTrue(
+                    resolved.exists(),
+                    f'dead link: {source.relative_to(SKILL_DIR)} -> {target}',
+                )
+                if resolved in graph:
+                    graph[source.resolve()].add(resolved)
+                if resolved.parent == SCRIPTS_DIR.resolve():
+                    linked_scripts.add(resolved)
+
+        reachable = set()
+        pending = [SKILL_FILE.resolve()]
+        while pending:
+            current = pending.pop()
+            if current in reachable:
+                continue
+            reachable.add(current)
+            pending.extend(graph.get(current, ()))
+
+        orphaned = sorted(
+            str(path.relative_to(SKILL_DIR))
+            for path in graph
+            if path != SKILL_FILE.resolve() and path not in reachable
+        )
+        self.assertEqual(orphaned, [], f'orphan references: {orphaned}')
+
+        production_scripts = {
+            path.resolve()
+            for path in SCRIPTS_DIR.glob('*.py')
+            if not path.name.startswith('test_')
+        }
+        missing_scripts = sorted(
+            path.name for path in production_scripts - linked_scripts
+        )
+        self.assertEqual(
+            missing_scripts, [],
+            f'production scripts missing from references: {missing_scripts}',
+        )
+
+    def test_list_parser_accepts_runtime_item_list(self):
+        payload = {
+            'result': {
+                'itemList': [{'taskUuid': 'u1', 'title': '周会'}],
+            },
+        }
+        self.assertEqual(
+            uuid_title_pairs_from_payload(payload), [('u1', '周会')]
+        )
+
+    def test_summary_accepts_runtime_full_summary(self):
+        payload = {'result': {'fullSummary': '完整摘要'}}
+        self.assertEqual(
+            minutes_recent_summary.summary_text_from_payload(payload),
+            '完整摘要',
+        )
+
+    def test_dws_failure_is_not_treated_as_empty_result(self):
+        failed = subprocess.CompletedProcess(
+            args=['dws'], returncode=2, stdout='', stderr='boom'
+        )
+        with mock.patch.object(
+            minutes_recent_summary.subprocess, 'run', return_value=failed
+        ):
+            with self.assertRaises(minutes_recent_summary.DWSCommandError):
+                minutes_recent_summary.run_dws(['minutes', 'list', 'mine'])
+
+    def test_summary_dry_run_never_starts_subprocess(self):
+        argv = ['minutes_recent_summary.py', '--max', '2', '--dry-run']
+        with mock.patch.object(sys, 'argv', argv):
+            with mock.patch.object(
+                minutes_recent_summary.subprocess,
+                'run',
+                side_effect=AssertionError('dry-run called subprocess'),
+            ):
+                output = io.StringIO()
+                with redirect_stdout(output):
+                    minutes_recent_summary.main()
+        rendered = output.getvalue()
+        self.assertIn('dws minutes list mine --max 2', rendered)
+        self.assertIn(
+            'dws minutes get summary --id <TASK_UUID>', rendered
+        )
+
+    def test_phase2_execution_capsules_and_capability_boundaries(self):
+        skill = SKILL_FILE.read_text(encoding='utf-8')
+        intent_guide = (REFERENCES_DIR / 'intent-guide.md').read_text(
+            encoding='utf-8'
+        )
+        minutes_reference = (REFERENCES_DIR / 'minutes.md').read_text(
+            encoding='utf-8'
+        )
+        workflow_reference = (REFERENCES_DIR / '07-minutes.md').read_text(
+            encoding='utf-8'
+        )
+
+        for command in (
+            'dws minutes +search --query "<关键词>" --scope all --page-all',
+            'dws minutes +list-mine --page-all --format json',
+            'dws minutes +list-shared --page-all --format json',
+            'dws minutes +list-all --page-all --format json',
+            'dws minutes +export-pack --id <taskUuid>',
+            'dws minutes record start --dry-run --format json',
+        ):
+            self.assertIn(command, skill)
+        self.assertNotIn('+record-start --dry-run', skill)
+
+        self.assertIn('--pair "旧词1=>新词1"', intent_guide)
+        self.assertIn('total` 是替换规则数', intent_guide)
+        self.assertIn('minutes tag query --tag-id <tagId>', intent_guide)
+        self.assertNotIn('+replace-batch ...', intent_guide)
+        self.assertNotIn('minutes tag ...', intent_guide)
+
+        self.assertIn('无公开 `permission list/get/inspect` 命令', minutes_reference)
+        self.assertIn('`0` | 管理员', minutes_reference)
+        self.assertIn('`4` | 仅查看', minutes_reference)
+        self.assertIn('verification.mode=write_ack_only', minutes_reference)
+        self.assertIn('dws minutes +share --id <taskUuid>', workflow_reference)
+        self.assertIn('dws minutes +unshare --id <taskUuid>', workflow_reference)
+
+    def test_phase3_bad_case_guidance_is_general_and_executable(self):
+        skill = SKILL_FILE.read_text(encoding='utf-8')
+        intent_guide = (REFERENCES_DIR / 'intent-guide.md').read_text(
+            encoding='utf-8'
+        )
+        minutes_reference = (REFERENCES_DIR / 'minutes.md').read_text(
+            encoding='utf-8'
+        )
+        workflow_reference = (REFERENCES_DIR / '07-minutes.md').read_text(
+            encoding='utf-8'
+        )
+
+        for fact in (
+            '--direction 1',
+            '等我确认后再继续',
+            'dws minutes +detail --ids <uuid1,uuid2> --artifacts basic',
+            '不能用当前 profile 的组织名代替每条听记的归属',
+            '不得为了验证预览而执行真实写入后再还原',
+            '纯能力、规则或错误说明',
+            'requested/resolved/missing/artifacts/status',
+            '只有 `title/basic` 时只列元数据',
+        ):
+            self.assertIn(fact, skill)
+
+        self.assertIn('不查询 Help、不编造替换词', intent_guide)
+        self.assertIn('逐来源证据台账', minutes_reference)
+        self.assertIn(
+            '不能生成摘要、关键词、主题或内容分类',
+            minutes_reference,
+        )
+        self.assertIn(
+            'dws minutes +update --id <taskUuid> --title "<目标标题>" --dry-run',
+            minutes_reference,
+        )
+        self.assertIn('当前 profile 的 `corpName`', minutes_reference)
+        self.assertIn(
+            'dws minutes hot-word list --format json', workflow_reference
+        )
+        self.assertIn(
+            'dws minutes +list-mine --page-all --format json',
+            workflow_reference,
+        )
+        self.assertIn('不能通过真实 create 后 cancel 来伪造预览', workflow_reference)
+        for case_id in (
+            '0052',
+            '0060',
+            '0066',
+            '0068',
+            '0070',
+            '0071',
+            '0110',
+            '0121',
+            '0132',
+            '0136',
+            '0137',
+            '0142',
+            '0145',
+        ):
+            self.assertNotIn(case_id, skill)
+            self.assertNotIn(case_id, intent_guide)
+            self.assertNotIn(case_id, minutes_reference)
+            self.assertNotIn(case_id, workflow_reference)
+
+
+if __name__ == '__main__':
+    unittest.main()

package/skills/dws/dingtalk-misc/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: dingtalk-misc
+description: 长尾产品集合技能，覆盖低频钉钉产品：OA审批查询与处理/考勤/直播/DING紧急消息/开放平台应用管理/Agoal目标管理/日志日报周报/电子表格/开放平台文档搜索与OpenAPI逃生舱/文档内嵌白板/钉钉招聘/DWS技能市场安装/组织大脑Hrbrain/原生Markdown/PAT行为授权/多组织profile。Use when 用户提到上述任一产品，或查待审批/同意拒绝转交撤销审批/打卡/排班/OKR/日报周报/单元格读写/白板节点读写/招聘职位/JD/创建职位/搜索安装技能/开发者后台应用/未封装OpenAPI/llms.txt/dws api/人才池/员工档案/职业历程/绩效/原生.md文件/Markdown版本比较/本地草稿diff/Markdown评论/PAT授权/切换组织/跨组织/profile 等相关操作。未来审批任务或实例变化的实时监听不属于本 skill，应使用 dingtalk-event。命中后由本 skill 的「产品索引表」定位具体子产品和命令前缀，再按对应子产品说明执行。
+metadata:
+  cli_version: ">=0.2.14"
+  category: product
+  requires:
+    bins:
+      - dws
+---
+
+# 长尾产品集合 Skill（dingtalk-misc）
+
+## 执行前路由
+
+本文件只负责产品路由。先由下表确定唯一产品：单一、清晰的 Attendance 任务以及 Report/Sheet 任务直接读取对应 reference（内含该任务所需的最小执行契约）；其它产品先读取 [`dingtalk-shared`](../dingtalk-shared/SKILL.md)，再读取唯一产品 reference。仅在实际触发认证、profile、确认或错误恢复时补读一份精确 shared reference，不做冷启动预读。
+
+Attendance 任务直接按产品索引读取一份最匹配的 `attendance*.md`，不要重复预读 `dingtalk-shared`。只有出现跨产品编排、profile/认证问题、未知全局错误或 Reference 明确指向 shared 时，才按需读取 shared 对应内容。
+
+## 产品索引表
+
+| 触发关键词 | 一句话范围 | 命令前缀 | 详细参考 |
+|---|---|---|---|
+| OA / 审批 / 待处理审批 / 同意 / 拒绝 / 撤销 / 已发起审批 | OA 审批：待处理/详情/同意/拒绝/撤销/已发起/批量审批 | `dws oa` | [oa.md](references/oa.md) |
+| 考勤 / 打卡 / 班次 / 考勤组 / 排班 / 考勤报表 / 假期余额 | 考勤记录、规则与配置、排班、报表、假期 | `dws attendance` | 日常查询/规则/设置：[attendance.md](references/attendance.md)；排班导入或排班表导出：[attendance-schedule.md](references/attendance-schedule.md)；考勤 Excel/报表导出：[attendance-report.md](references/attendance-report.md)；假期/余额：[attendance-vacation.md](references/attendance-vacation.md) |
+| 直播 / 我的直播 / 直播列表 | 直播列表与直播记录查询 | `dws live` | [live.md](references/live.md) |
+| DING / 紧急通知 / 电话DING / 短信DING / 必达消息 | DING 紧急消息（应用内/短信/电话），个人DING | `dws ding` | [ding.md](references/ding.md) |
+| 开放平台应用 / 企业内部应用 / 应用成员 / 应用权限 / 应用版本 / agentId / clientId / 机器人配置 / 版本发布 / connect / MCP 服务开发 / MCP 工具发布 / MCP 凭证 | 开放平台企业内部应用，以及 MCP 服务、工具、鉴权、凭证和协作者的开发管理 | `dws dev` / `dws devapp` / `dws dev mcp` | [devapp.md](references/devapp.md)，MCP 细节见 [dev/mcp.md](references/dev/mcp.md) |
+| 目标管理 / 战略解码 / 经营合约 / 计分卡 / OKR / 周月报统计 | Agoal 目标管理与经营目标跟进 | `dws agoal` | [agoal.md](references/agoal.md) |
+| 日报 / 周报 / 月报 / 写日志 / 收件箱日志 / 发件箱日志 | 日志（日报/周报/月报）查询与按模版提交 | `dws report`（别名 `dws log`） | [report.md](references/report.md) |
+| 电子表格 / 工作表 / 单元格读写 / 公式 / 超链接 / 浮动图片 | 电子表格创建/读写/公式/超链接/浮动图片/导出 | `dws sheet` | [sheet.md](references/sheet.md) |
+| 开放平台文档 / API文档 / 接口文档 / 接口报错 | 开放平台开发文档搜索 | `dws devdoc` | [devdoc.md](references/devdoc.md) |
+| 未封装 OpenAPI / llms.txt / dws api / Raw API / API 逃生舱 | 官方 llms.txt 分层发现，仅对企业内部应用 App Token 服务端 API 生成并确认 Raw 调用 | `dws api` | [openapi-explorer.md](references/openapi-explorer.md) |
+| 白板 / 画布 / OpenNodes / 白板节点 | 读取和更新钉钉文档中的内嵌白板 | `dws whiteboard` | [whiteboard.md](references/whiteboard.md) |
+| 招聘 / 职位 / JD / 在招职位 / 创建职位 / 职位详情 | 钉钉招聘职位的查询、详情与创建 | `dws recruit` | [recruit.md](references/recruit.md) |
+| 搜索技能 / 找技能 / 安装技能 / 技能市场 / 安装 DWS mono 或 multi skill | DWS 技能市场搜索、下载、安装与内置技能部署 | `dws skill` | [skill.md](references/skill.md) |
+| 人才池 / 储备干部池 / 员工档案 / 职业历程 / 绩效记录 / 员工标签 / 组织大脑 / 人才搜索 | 组织大脑：人才池、员工档案专项模块与结构化人才搜索 | `dws hrbrain` | [hrbrain.md](references/hrbrain.md) |
+| 原生 Markdown / `.md` 原文 / Markdown 版本比较 / 本地草稿 diff / 覆盖 Markdown / 局部替换 Markdown / Markdown 评论 | 原生 `.md` 文件读取、创建、版本或草稿对比、全量覆盖、局部替换与评论列表 | `dws markdown` | [markdown.md](references/markdown.md) |
+| PAT 授权 / 行为权限 / scope 授权 / 一次性授权 / 会话授权 / 永久授权 / 授权浏览器策略 | PAT 行为授权与本地浏览器策略 | `dws pat` | [pat.md](references/pat.md) |
+| 切换组织 / 换组织 / 跨组织 / 多组织 / profile / 看登录了哪些组织 | 多组织 / profile 管理与跨组织取数 | `dws profile` / `dws auth` / `--profile` | [profile.md](references/profile.md) |
+| 宜搭 / AI应用脚本 / 财务辅助脚本（未产品化） | **无**稳定命令面；仅仓库内辅助脚本 | （非默认路由） | [unsupported-scripts.md](references/unsupported-scripts.md) |
+
+## 说明
+
+- 命中产品后必须读取其 `references/<product>.md`，不要只凭索引推测命令。Report 只读 [report.md](references/report.md)；Sheet 常见闭环只读 [sheet.md](references/sheet.md)，复杂任务按进入阶段顺序加载子 reference，每阶段最多一份、常规任务最多三份，禁止批量预读或重复读取。
+- **考勤例外**：按索引表直接读取一份最匹配的 `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](references/unsupported-scripts.md)；默认不要当正式能力调用。
+- 开放平台应用的命令组细文档在 [references/dev/](references/dev/)；命中后先读 [devapp.md](references/devapp.md)，再按需加载对应子文件。
+- 查询、同意、拒绝、转交或撤销审批走 [oa.md](references/oa.md)；要求未来审批任务或实例发生变化时实时通知，切换独立的 [`dingtalk-event`](../dingtalk-event/SKILL.md)。开放平台应用事件配置仍属于 DevApp，按 [dev/event.md](references/dev/event.md) 执行，不要与个人实时事件混淆。
+- 原生 `.md` 与在线富文本 `adoc`、通用文件存储的边界见 [markdown.md](references/markdown.md)；跨组织 / profile 规则见 [profile.md](references/profile.md)。
+- PAT 行为授权不是开放平台应用权限；后者见 [devapp.md](references/devapp.md)。

package/skills/dws/dingtalk-misc/references/05-reporting.md

@@ -0,0 +1,29 @@
+# 工作汇报
+
+> lite recipe（`view-report-inbox`、`check-report-read-status`）见 [report-lite-recipes.md](./report-lite-recipes.md)。
+
+## 路径分歧（先判定后选 recipe）
+
+`dws report` 与 `dws doc` 是两个不同的产品，覆盖不同的"周报 / 日报"场景。在选 recipe 前先做一次判定：
+
+| query 中是否含强信号 | 选哪个 recipe | 默认值 |
+|---------------------|---------------|--------|
+| 含「钉钉日志 / OA 周报 / 我的钉钉日志 / 日报模板 / 周报模板 / 提交日志 / 填模版」 | `submit-report`（走 dws report entry submit） | — |
+| 含「在线文档 / 写一篇文档 / 整理成文档 / 文档保存」 | `generate-*-report`（走 dws doc create） | — |
+| **无强信号**（如"写日报"、"写周报"、"整理本周工作"）| `generate-*-report`（走 dws doc create） | 默认 |
+
+注：
+
+- "钉钉日志"在用户口语中多指 OA 周报应用，但偶有泛指日志/记录，必要时反问澄清。
+- 仅当用户**明确**说"钉钉日志（OA 应用）"或类似强信号时才切到 `submit-report`；否则不要主动推荐 OA 日志路径——多数用户的"周报"实际期望是文档（可分享、可编辑、长文本）。
+
+## Recipe 速查
+
+| Recipe | 行动指南（固定路线） |
+|--------|-------------------|
+| query-report | **0. 前置判定**：query 含「查日志 / 看日志 / 我发过的日志 / 收到的日志 / 日志详情」且语义指向钉钉日志 OA 应用？是 → 直接走 `dws report`；CSV 附件、群聊导出日志、系统日志或聊天记录核验不属于 OA 日志，应转到文件/群聊/表格相关 skill；其余歧义先按 doc/report 分歧澄清<br>1. 第一条有效查询必须按视角选择新命令：用户说「我发过 / 我创建 / 已发送」→ `report outbox list --cursor 0 --size 20 --format json`；用户说「收到 / 收件箱 / 别人发给我 / 最近收到」→ `report inbox list --start "<YYYY-MM-DDT00:00:00+08:00>" --end "<YYYY-MM-DDT23:59:59+08:00>" --cursor 0 --size 20 --format json`；不要先生成 `report list` / `report sent` 等 deprecated alias，也不要用 inbox 代替 outbox<br>2. 时间 flag 只允许 `--start` / `--end`；裸日期必须展开完整 ISO + `+08:00`；禁止 `--start-date` / `--end-date` / `--date`、UTC `Z`、`date -u`；用户只说「最近 / 近期 / 最近收到 / 最近一周」默认最近 7 天；`--size` 最大 20，更多结果按 `cursor` 分页，禁止传 50/100<br>3. 按发件人查收件箱时，先 `aisearch person --query "<姓名>" --dimension name --format json` 取 `userId/staffId`，再给 `inbox list` 加 `--sender-user-ids <id>`；如果列表中找不到目标发件人或目标标记日志，必须说明不可见 / 未找到，不得改选其他发件人或其他日志<br>4. 从列表返回中取 `reportId` 留给内部后续调用；如果用户已直接提供 `reportId`，跳过列表；面向用户展示列表时基于 `result[]` 拼 Markdown 表：`日期 | 标题 | 发送人 | 状态 | 钉钉链接`，不要把日志 ID 作为主列，缺失字段不编造<br>5. 用户要正文、详情、汇总、总结多篇日志或检查内容时，必须对选中的每篇日志逐条执行 `report entry get --report-id <reportId> --format json`；例如“总结最近收到的 5 篇”应先 list 取前 5 篇（不足 5 篇按实际数量说明），再执行相同数量的 `entry get`；用户要统计 / 已读情况时执行 `report entry stats --report-id <reportId> --format json`<br>**不要把 inbox list/outbox list 当正文接口**；查询正文必须补 `entry get`<br>**不要再生成** `report list` / `report sent` / `report detail` / `report stats`（deprecated alias，仍能跑但会打 stderr 警告） |
+| generate-daily-report | 1. 按[「多源并行采集」](./report-conventions.md#多源并行采集公共模式)执行（时间=今日）<br>2. 交叉汇总并把日报内容写入临时文件 `<tmp>.md`（UTF-8，真实换行）<br>3. **创建文档**：`doc create --name "<日报名>" --content-file <tmp>.md`（> 200KB 按 write-doc 兜底（见 `dingtalk-doc/references/04-document.md`） 走 create 空 → 循环 update） |
+| generate-weekly-report | 1. 按[「多源并行采集」](./report-conventions.md#多源并行采集公共模式)执行（时间=本周）<br>2. 交叉对比并把周报内容写入临时文件 `<tmp>.md`<br>3. **创建文档**：`doc create --name "<周报名>" --content-file <tmp>.md`（兜底同上） |
+| submit-report | **0. 前置判定**：query 含「钉钉日志 / OA 周报模板 / 我的钉钉日志」等强信号？是 → 继续；否 → 切换到 `generate-weekly-report` 或 `generate-daily-report`（走 dws doc）<br>1. 按[「多源并行采集」](./report-conventions.md#多源并行采集公共模式)执行（时间=当日）<br>2. `report template list --format json` → 取 `report_template_id`<br>3. `report template get --name "<模版名>" --format json` → 取 `result.report_template_fields[]`，每项含 `field_name`/`field_sort`/`field_type`<br>4. **把 contents 写入临时文件**（避免 shell 引号问题）：每项含 `key`/`sort`/`content`/`contentType`/`type` 五个字段，**严格映射** `field_name → key`、`field_sort → sort`、`field_type → type`，再填 `content` 与 `contentType`<br>5. `report entry submit --template-id <id> --contents-file <tmp>.json --to-user-ids <userId1>,<userId2> --format json` → `--to-user-ids` 必填：无接收人的提交服务端仍返回成功但日志对任何人都不可见；CLI 会在提交成功后自动反查详情并追加 `dingtalkOpenMarkdownLink` / `dingtalkOpenUrl` / `dingtalkOpenLink` 字段；取返回的 `reportId` 与钉钉打开链接<br>6. final reply 优先直接使用 `dingtalkOpenMarkdownLink`，让用户点击跳转钉钉客户端查看 / 修改；仅当 submit 返回中缺少 `dingtalkOpenUrl` 时，才手动执行 `report entry get --report-id <reportId> --format json` 补取 `result.url`，再包装成 `[在钉钉中查看日志](result.url)`<br>**不要走 doc 写文档**；**禁止跳过 2/3 步**直接 submit；**禁止把 raw `dingtalk://...` URL 直接粘到回复**，必须包成 markdown link<br>**不要再生成** `report template detail` / `report create`（deprecated alias，仍能跑但会打 stderr 警告） |
+| generate-monthly-report | 1. 按[「多源并行采集」](./report-conventions.md#多源并行采集公共模式)执行（时间=当月）<br>2. `report outbox list --start "<月初ISO>" --end "<月末ISO>"` → 取当月已提交日志<br>3. 按周分段归纳并把月报内容写入临时文件 `<tmp>.md`<br>4. **创建文档**：`doc create --name "<月报名>" --content-file <tmp>.md`（兜底同上） |
+| generate-topic-report | 1. 提取主题关键词；推断时间范围（"最近"默认近 30 天）<br>2. 按[「多源并行采集」](./report-conventions.md#多源并行采集公共模式)执行<br>3. 按时间线排列，交叉归纳核心结论/决策/行动项/未解决问题/演进脉络，并把内容写入临时文件 `<tmp>.md`<br>4. **创建文档**：`doc create --name "<报告名>" --content-file <tmp>.md`（兜底同上） |

package/skills/dws/dingtalk-misc/references/agoal.md

@@ -0,0 +1,302 @@
+# Agoal（目标管理）
+
+## 产品说明
+
+Agoal 是钉钉目标管理工具，支持战略解码、经营合约、计分卡、用户目标、目标模板、周月报六大模块，帮助组织将战略目标从顶层分解到个人并持续跟踪。
+
+**CLI 前缀**: `dws agoal`
+
+## 命令总览
+
+### strategy (战略解码管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `strategy list` | 获取战略解码列表 | `--scope-type` `--scope-id` | scopeType: DEPT/PERSONAL；scope-id 为 scope-type 对应的部门 id 或用户 id |
+| `strategy detail` | 获取战略解码详情 | `--profile-id` | 根据战略解码 id 查询 |
+| `strategy update` | 更新战略解码 | `--profile-id` `--content` | **覆盖逻辑，必须基于查询返回的老数据修改后再传入**；`--content` 为 JSON 数组 |
+
+> **`strategy update` 是覆盖式更新**：一定要先 `strategy detail` 获取完整数据，在原数据基础上修改后再传入，会根据战略解码id进行对应的修改。
+
+#### strategy update --content 实体字段说明
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 实体 id |
+| `title` | 标题对象，如 `{"title":"标题文本"}` |
+| `linkEntityId` | 所属实体 ID（查询接口中有值时必须回传） |
+| `entityType` | 类型枚举：`OGSM_OBJECTIVE`(目的)、`OGSM_GOAL`(目标)、`OGSM_STRATEGY`(策略)、`OGSM_MEASUREMENT`(衡量标准)、`OGSM_TACTICS`(行动方案) |
+| `status` | 状态枚举：`NORMAL`(正常)、`PRE_PUBLISH_THEN_UPDATE`(预发布更新)、`PRE_PUBLISH_THEN_CREATE`(预发布新增)、`PRE_PUBLISH_THEN_DELETE`(预发布删除) |
+| `supporters` | 承接人数组 `[{type, dingId, staffId}]`；type: `USER`/`DEPARTMENT`；staffId 在 type=USER 时必填 |
+| `indicators` | 关键指标 id 字符串数组 |
+| `linkSources` | 资源关联数组 `[{id, linkType, linkId, source, objectId, keyResultId}]`；linkType: project/task/campaign/product/doc/standard；source: teambition |
+| `executors` | 人员 dingId 字符串数组 |
+| `teams` | 部门 dingId 字符串数组 |
+
+### contract (经营合约管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `contract list` | 获取经营合约列表 | `--scope-type` `--scope-id` | scopeType: DEPT/PERSONAL；scope-id 为 scope-type 对应的部门 id 或用户 id |
+| `contract fields` | 获取经营合约字段列表 | — | 获取组织下经营合约的字段配置 |
+| `contract detail` | 获取经营合约详情 | `--contract-id` | 根据合约 id 查询 |
+| `contract update` | 更新经营合约 | `--contract-id` `--dimensions` | **覆盖逻辑**；可选 `--audit-config`、`--objective-template` |
+
+> **`contract update` 同样是覆盖式更新**：必须基于 `contract detail` 返回的数据修改后再传入。
+
+#### contract update --dimensions 维度字段说明
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 维度 id |
+| `title` | 维度名称 |
+| `description` | 维度描述 |
+| `weight` | 维度权重 |
+| `objectives` | 目标列表 |
+| `dimensionConfig` | 维度配置 |
+| `children` | 子维度列表 |
+
+#### contract update 可选参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `--audit-config` | 审批配置 JSON | `{"needAudit":true,"processTemplateId":"TPL_ID"}` |
+| `--objective-template` | 合约模板 JSON | `{"id":"TPL_ID","title":"模板名称"}` |
+
+### scorecard (计分卡管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `scorecard detail` | 获取计分卡详情 | `--selected-time` `--dept-id` | selectedTime 为 ISO-8601 字符串，如 `"2026-01-01T00:00:00+08:00"` |
+| `scorecard entity-detail` | 获取计分卡实体详情 | `--sc-id` `--entity-id` | 根据计分卡 id 和实体 id 查询 |
+| `scorecard update` | 更新计分卡 | `--dept-id` `--selected-time` `--id` `--tracking-period-type` `--content` | trackingPeriodType: MONTHLY/QUARTERLY |
+| `scorecard search-entities` | 搜索计分卡指标与关键事项 | `--keyword` | 可选 `--page`、`--page-size`；keyword 为标题模糊匹配关键词 |
+
+#### selectedTime 时间说明
+
+`--selected-time` 接受 ISO-8601 字符串，传入对应周期起始时刻：
+
+- **2026年** → `"2026-01-01T00:00:00+08:00"`
+- **2026年5月** → `"2026-05-01T00:00:00+08:00"`
+
+#### scorecard update --content 维度字段说明
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 维度 id |
+| `title` | 维度名称 |
+| `items` | 指标或关键事项列表 |
+
+items 每项包含：
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 实体 id |
+| `title` | 名称 |
+| `reference` | 参考信息 |
+| `start` | 起始值 |
+| `target` | 目标值 |
+| `executors` | 负责人列表，每项包含 `openId` |
+
+#### trackingPeriodType 枚举
+
+| 值 | 说明 |
+|------|------|
+| `MONTHLY` | 月度追踪 |
+| `QUARTERLY` | 季度追踪 |
+
+### user (用户目标管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `user rules` | 获取用户规则周期列表 | — | 可选 `--user-id`，不传则默认取操作人自己 |
+| `user objectives` | 查询用户目标列表 | `--user-id` `--rule-id` `--period-ids` | `--period-ids` 为逗号分隔的周期 id 列表 |
+
+### obj-template (目标模板管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `obj-template list` | 获取目标模板列表 | — | 可选 `--keyword` 搜索关键词、`--page` 页码、`--page-size` 每页数量 |
+| `obj-template create-or-update` | 新增或更新目标模板 | `--dimensions` | **覆盖逻辑**；新增时 `--title` 必填；更新时 `--template-id` 必填，dimensions 必须基于老数据修改 |
+
+> **`obj-template create-or-update` 同样是覆盖式更新**：更新时必须基于 `obj-template list` 返回的数据修改后再传入。新增时建议先参考已存在的模板数据再构建 dimensions。
+
+#### obj-template create-or-update 参数说明
+
+| 参数 | 说明 | 类型 |
+|------|------|------|
+| `--template-id` | 模板 id（更新时必填） | string |
+| `--title` | 模板标题（新增时必填） | string |
+| `--objective-weight` | 是否启用目标权重 | bool |
+| `--dimension-weight` | 是否启用维度权重 | bool |
+| `--compute-by-weight` | 维度是否参与计算 | bool |
+| `--dimensions` | 模板关联的维度 JSON 字符串 | string |
+
+### report (周月报管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `report list-statistics` | 获取周月报数据跟催列表 | — | 返回各规则的人员提交情况统计（按时/迟交/未提交人数）；可选 `--keyword` 搜索规则名称 |
+| `report submit-detail` | 获取周月报规则提交详情 | `--template-id` `--submit-state` | submitState: `ON_TIME`(按时)/`LATE`(迟交)/`NOT_SUBMITTED`(未提交)；可选 `--query-date`(ISO-8601)、`--page`、`--page-size`、`--keyword`(搜索员工名称) |
+
+#### report submit-detail --submit-state 枚举
+
+| 值 | 说明 |
+|------|------|
+| `ON_TIME` | 按时提交 |
+| `LATE` | 迟交 |
+| `NOT_SUBMITTED` | 未提交 |
+
+## 意图判断
+
+用户说"战略解码/战略目标/OGSM":
+- 查看/列表 → `strategy list`
+- 详情 → `strategy detail`
+- 修改/更新 → `strategy update`（先查后改）
+
+用户说"经营合约/合约/KPI合约":
+- 查看/列表 → `contract list`
+- 字段配置 → `contract fields`
+- 详情 → `contract detail`
+- 修改/更新 → `contract update`（先查后改）
+
+用户说"计分卡/scorecard/绩效看板":
+- 查看详情 → `scorecard detail`
+- 实体详情 → `scorecard entity-detail`
+- 修改/更新 → `scorecard update`
+- 搜索计分卡指标与关键事项 → `scorecard search-entities --keyword "关键词"`
+
+用户说"目标/OKR/我的目标/个人目标":
+- 规则周期 → `user rules`
+- 目标列表 → `user objectives`
+
+用户说"目标模板/模板管理":
+- 查看模板列表 → `obj-template list`
+- 新增模板 → `obj-template create-or-update --title "模板名称"`
+- 更新模板 → `obj-template create-or-update --template-id TPL_ID`
+
+用户说"周月报/周报统计/提交情况/跟催/迟交/未提交":
+- 查看提交统计列表 → `report list-statistics`
+- 查看某规则的提交详情（按时/迟交/未提交人员明细） → `report submit-detail`
+
+## 核心工作流
+
+```bash
+# 1. 查看战略解码列表（按部门）
+dws agoal strategy list --scope-type DEPT --scope-id DEPT_ID
+
+# 1.1 查看战略解码列表（按个人）
+dws agoal strategy list --scope-type PERSONAL --scope-id USER_ID
+
+# 2. 查看战略解码详情
+dws agoal strategy detail --profile-id PROFILE_ID
+
+# 3. 更新战略解码（基于详情返回的数据修改后传入）
+dws agoal strategy update --profile-id PROFILE_ID \
+  --content '[{"id":"entity1","title":{"title":"新目标"},"entityType":"OGSM_OBJECTIVE","status":"NORMAL","executors":["dingId1"]}]'
+
+# 4. 查看经营合约列表（按个人）
+dws agoal contract list --scope-type PERSONAL --scope-id USER_ID
+
+# 4.1 查看经营合约列表（按部门）
+dws agoal contract list --scope-type DEPT --scope-id DEPT_ID
+
+# 5. 查看经营合约字段列表
+dws agoal contract fields
+
+# 6. 查看经营合约详情
+dws agoal contract detail --contract-id CONTRACT_ID
+
+# 7 更新经营合约（基于详情返回的数据修改后传入）
+dws agoal contract update --contract-id CONTRACT_ID \
+  --dimensions '[{"id":"dim1","title":"维度名称","objectives":[...]}]'
+
+# 8. 查看计分卡详情
+dws agoal scorecard detail --selected-time "2025-01-01T00:00:00+08:00" --dept-id DEPT_ID
+
+# 9. 查看计分卡实体详情
+dws agoal scorecard entity-detail --sc-id SC_ID --entity-id ENTITY_ID
+
+# 10. 更新计分卡
+dws agoal scorecard update --dept-id DEPT_ID --selected-time "2025-01-01T00:00:00+08:00" --id SC_ID --tracking-period-type MONTHLY --content '[{"id":"dim1","title":"业绩","items":[{"id":"item1","title":"收入","target":"100"}]}]'
+
+# 10.1 搜索计分卡指标与关键事项
+dws agoal scorecard search-entities --keyword "业绩"
+dws agoal scorecard search-entities --keyword "业绩" --page 1 --page-size 20
+
+# 11. 查看用户规则 → 提取 ruleId 和 periodId
+dws agoal user rules --user-id USER_ID
+
+# 12. 查看用户目标
+dws agoal user objectives --user-id USER_ID --rule-id RULE_ID --period-ids "period1,period2"
+
+# 13. 查看周月报提交统计列表
+dws agoal report list-statistics
+
+# 13.1 按关键词搜索规则
+dws agoal report list-statistics --keyword "周报规则"
+
+# 14. 查看某规则的按时提交详情
+dws agoal report submit-detail --template-id TPL_ID --submit-state ON_TIME
+
+# 14.1 查看迟交详情（带分页和日期）
+dws agoal report submit-detail --template-id TPL_ID --submit-state LATE --query-date "2026-06-18T00:00:00+08:00" --page 1 --page-size 20
+
+# 15. 获取目标模板列表
+dws agoal obj-template list
+
+# 15.1 搜索目标模板
+dws agoal obj-template list --keyword "业绩"
+
+# 16. 新增目标模板
+dws agoal obj-template create-or-update --title "业绩模板" --objective-weight --dimension-weight --dimensions '[...]'
+
+# 16.1 更新目标模板
+dws agoal obj-template create-or-update --template-id TPL_ID --title "业绩模板" --dimensions '[...]'
+```
+
+## 上下文传递表
+
+| 操作 | 从返回中提取 | 用于 |
+|------|-------------|------|
+| `strategy list` | `profileId` | `strategy detail` / `strategy update` 的 `--profile-id` |
+| `strategy detail` | 完整实体数据 | `strategy update` 的 `--content`（基于此修改） |
+| `contract list` | `contractId` | `contract detail` / `contract update` 的 `--contract-id` |
+| `contract detail` | 完整维度数据 | `contract update` 的 `--dimensions`（基于此修改） |
+| `scorecard detail` | `scId`、`entityId` | `scorecard entity-detail` / `scorecard update` 的 `--id` |
+| `user rules` | `ruleId`、`periodIds` | `user objectives` 的 `--rule-id` `--period-ids` |
+| `report list-statistics` | `templateId`（列表项中） | `report submit-detail` 的 `--template-id` |
+| `obj-template list` | `templateId` | `obj-template create-or-update` 的 `--template-id`(更新时) |
+
+## 注意事项
+
+- **所有 update 命令都是覆盖逻辑**：必须先用对应的 detail/list 查询到完整数据，在原数据基础上修改后再传入，否则未传入的数据会被删除
+- 所有命令支持可选参数 `--request-id`
+- `--scope-type` 仅支持 `DEPT`（按部门）和 `PERSONAL`（按个人）两种
+- `--selected-time` 接受 ISO-8601 字符串（如 `"2026-01-01T00:00:00+08:00"`）
+- `--period-ids` 为逗号分隔的字符串，如 `"period1,period2"`
+- `report submit-detail` 的 `--query-date` 接受 ISO-8601 字符串（如 `"2026-06-18T00:00:00+08:00"`），不传则默认当天
+- `report submit-detail` 的 `--page` 和 `--page-size` 默认为 1 和 10，不传时由服务端使用默认值
+
+---
+
+## SKILL 摘要（原 dingtalk-agoal/SKILL.md 正文）
+
+## 意图表
+
+| 用户说 | 命令 |
+|--------|------|
+| "查战略解码 / 战略列表" | `dws agoal strategy list` |
+| "查战略详情" | `dws agoal strategy detail --profile-id <id>` |
+| "更新战略解码" | 先 `strategy detail` 获取完整内容，再 `strategy update` 覆盖更新 |
+| "查经营合约" | `dws agoal contract list` / `contract detail` |
+| "更新经营合约" | 先 `contract detail` 获取完整内容，再 `contract update` 覆盖更新 |
+| "查计分卡" | `dws agoal scorecard detail` / `scorecard entity-detail` |
+| "搜索计分卡指标与关键事项" | `dws agoal scorecard search-entities --keyword <KW>` |
+| "更新计分卡" | 先查详情，再按 [agoal.md](./agoal.md) 覆盖更新 |
+| "查周月报统计/提交情况/跟催" | `dws agoal report list-statistics` / `report submit-detail` |
+
+## 硬约束
+
+- `strategy update`、`contract update`、`scorecard update` 都是覆盖式更新，必须先查询详情，在返回数据基础上修改后再提交。
+- 所有命令带 `--format json`；涉及写操作时回查确认。

package/skills/dws/dingtalk-misc/references/attendance-intent-guide.md

@@ -0,0 +1,7 @@
+# attendance 局部意图消歧
+
+本文件从单 Skill `intent-guide.md` 拆分而来，仅保留与本产品相关的跨产品消歧规则。
+
+| 用户说... | 真实意图 | 应该用 | 不要用 | 理由 |
+|---|---|---|---|---|
+| "查/提交 请假/加班/外出/出差/补卡 审批单" | 考勤业务审批单 | `attendance approve`（查询走 `attendance approve list`；提交走 `attendance approve templates --type leave\ | overtime\ | repair-check\ |