泛微E10计划报告
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../weaver-e10-shared-connector/SKILL.md,其中包含安装、E10 认证、JSON 输出和高风险写入规则。该文件由连接器随包提供,读取失败时必须停止执行;不要自行安装 CLI 或 Skill。
本技能覆盖报告业务域:汇总生成报告(多模块采集后整合)、查询报告详情、分页查询报告、新建、修改、发布、撤回、发送提交提醒、查看报告评论。写操作全部走 prepare→apply 确认协议。
零、第一步:意图判定(先于任何接口调用)
自上而下命中即止,不需要二次询问:
| 命中信号 | 走向 | 是否采集业务数据 |
|---|---|---|
| 查看 / 查询 / 列表 / 共享给我的 / 团队 / 下属 / 成员 / 某某某的报告 / 已提交 / 发布 / 撤回 / 修改 / 提醒他们交报告 | B 查询与管理链路 | 禁止调用任何业务模块采集数据 |
| 动词(汇总 / 生成 / 写 / 整理 / 总结 / 帮我出一份)+ 对象(周期词 + 报告类名词),且未命中上面任何信号 | A 生成与汇总链路 | 必须按采集作业链采集 |
歧义消解:「汇总上周报告」「生成本周报告」「帮我写周报 / 写月报 / 写季报 / 写年报」「帮我整理上周工作写报告」「把上周的工作总结成周报」一律归入 A 生成链路,不得因为出现「报告」二字而改走查询链路。
A 链路细节(采集模块、时间范围、输出规范)读 references/plan-collect-and-compose.md;B 链路读 references/plan-report-query.md。
命令入口
weaver-work-cli plan --help
weaver-work-cli --profile eteams plan schema
weaver-work-cli --profile eteams --json plan run <operation> --input-json '{"key":"value"}'
plan schema 是可用能力的唯一事实来源。禁止把源文档里的接口路径当成 Agent 可直接调用的地址,也禁止把未出现在 schema 中的能力当作可用 operation。
Reference 路由表
命中任一条件时,执行下一步前读取对应 reference。
| 触发条件 | Reference |
|---|---|
| 意图判定 A/B、版本路由与租户缓存、operation 总表、通用基础规则(周期、跳转、分页表格、人员 ID、字段名禁止项) | references/plan-overview-and-routing.md |
| 查看/查询某份报告、查看共享给我的报告或下属报告、查看报告评论 | references/plan-report-query.md |
| 新建报告、修改报告、发布报告、撤回报告 | references/plan-report-write.md |
| 提醒他人提交报告、生成提交提醒默认文案 | references/plan-report-remind.md |
| 汇总本周/上周/本月/上月工作并生成报告(多模块采集、去重润色、输出规范) | references/plan-collect-and-compose.md |
高优先级语义
- 报告:work report,用户常说「周报」「月报」「季报」「年报」「年中报告」「工作总结」「汇报」。
- 报告类型:
week(周报)/month(月报)/season(季报)/halfYear(年中报告)/year(年报)。 - 报告周期:
year(年份)+serialNumber(周期序号)。周报年份与周数严格遵循 ISO8601,1 月 4 日所在周为当年第 1 周;「上周」= 上周一至上周日。 - 发布状态:
0草稿 /1已发布 /2已撤回 /3审批中 /4被退回。CLI 输出已附带postStatusLabel。 - 报告详情链接:查询与写入成功后 CLI 会在
detailUrl返回可点击的详情页地址,必须呈现给用户。
版本路由(CLI 已内置,不要手工选择接口)
报告侧接口存在标准版与 e10-ebuilder 版两套链路。判定规则:先读租户缓存(有效期 1 天),命中即复用;未命中调用版本接口读取 ver_name,V2 → e10-ebuilder 链路,其它 → 标准版链路,并写回租户缓存。
- 判断当前链路:
plan.version.check(plan route同义)。 - 禁止跳过版本判定硬编码选择链路,禁止在某条链路命中后混用另一条链路的接口。
- 采集业务数据阶段(A 链路第 1~7 步)禁止调用版本接口或任何报告侧接口。
- eb 链路报告详情页链接依赖报告详情 eb 表单 id,
plan.eb.form.resolve会解析并长期缓存;不要手工拼链接。
报告侧 operation 表
| 用户意图 | operation |
|---|---|
| 判断当前租户报告链路 | plan.version.check |
| 解析 eb 报告详情表单 id | plan.eb.form.resolve |
| 查询某份报告(按 id 或按周期),判断某周期是否已提交 | plan.report.get |
| 分页查询报告列表(共享给我的、下属的) | plan.report.page |
| 查看报告评论内容 | plan.comment.list |
| 新建报告 | plan.report.create.prepare → plan.report.create.apply |
| 修改报告 | plan.report.update.prepare → plan.report.update.apply |
| 发布报告 | plan.report.publish.prepare → plan.report.publish.apply |
| 撤回报告 | plan.report.withdraw.prepare → plan.report.withdraw.apply |
| 发送提交提醒 | plan.report.remind.prepare → plan.report.remind.apply |
写操作确认链(必须遵守)
- 先调用
*.prepare:只做只读回查、字段归一化、差异摘要并签发 continuation,不写入。 - 把目标、差异、风险读给用户,并明确询问是否执行。
- 用户明确确认后,才调用
*.apply,并原样传入confirm=true与 prepare 返回的continuation。 *.apply遇到网络中断或partial/write_uncertain时立即停止,禁止自动重试,先做一次只读回查(plan.report.get)再决定下一步。continuation不可手工构造、不可跨操作复用;过期或上下文变化时重新prepare。
判断某周期是否已提交报告,只能通过 plan.report.get 按周期查询(必须传报告年份、报告类型、报告周期,创建人缺省为当前登录人)完成;只有确认需要创建时才做重复性判断,已存在时不得重复创建,必须告知用户并征询是否改为编辑。
通用基础规则(两条链路均生效)
- 周期计算遵循 ISO8601;未明确周期类型(周/月/季/年)时先向用户确认,确认前不得臆造区间。
- 报告新建/查询/修改/发布/撤回成功后,必须呈现
detailUrl,支持点击跳转详情页。 - 分页结果必须用表格展示,固定列为 报告名称 / 报告创建人名称 / 发布时间,报告名称可点击跳转
detailUrl。 - 涉及人员 ID 时只取
id或employeeId字段,禁止取userId;人员信息通过 weaver-e10-hrm-connector skill 获取。 - 请求体中的雪花 ID(人员 ID、报告 ID 等)必须加引号包裹为字符串,避免精度丢失;直接用 CLI 的业务字段即可,CLI 会完成归一化。
- 执行阶段与创建出的报告内容中,决不允许出现报告相关的数据库英文字段名(如
content、f_content、summary、f_summary、plans、f_plans、year、f_year、type、f_type、serial_number、f_serial_number)。CLI 已把 eb 链路返回值归一化为业务字段,Agent 直接使用report.*业务键即可,不要向用户复述接口原始结构。 - 认证与会话由 CLI 托管(Cookie 完整原始串、eteamsid、User-Agent 三件套缺一不可);若未登录先按共享规则读取
../weaver-e10-shared-connector/references/e10-auth-and-session.md并通过weaver-work-cli auth ...完成会话确认,禁止输出或索取任何凭证。
失败处理
- 认证类错误(
authentication/session_expired):引导用户断开并重新连接本连接器以重新登录,不要用其他方式排查。 policy/link_unsupported:该能力在当前链路不可用(例如 eb 链路的撤回、提交提醒、评论),按错误message给出的替代路径处理。validation/not_found/report_exists/already_published/not_published:属业务前置条件不满足,先向用户说明再决定下一步,禁止反复重试。partial/write_uncertain:立即停止写入流程,做一次只读回查后向用户说明。- 其它业务失败看 stderr JSON 的
error.type/error.subtype/error.message。
不在范围
- 不绕过 CLI 直接 curl/fetch 访问 E10 接口,不自行拼报告侧接口路径。
- 业务数据采集不在本技能内实现:按
references/plan-collect-and-compose.md的对应关系调用已安装的业务模块技能。 - eb 链路的「撤回报告」为 ESB 动作流,CLI 返回
policy/link_unsupported;改由weaver-e10-esbskill 用esb.input-format+esb.trigger.prepare/apply触发同名动作流(需要动作流 ID 或唯一值,见该 skill)。 - 人员「姓名 → 人员 ID」解析交给 weaver-e10-hrm-connector skill。
- 禁止把未出现在
plan schema中的能力当作可用 operation。
平台兼容
命令示例同时兼容 Windows 与 macOS/Linux。简单 JSON 用 --input-json,复杂或多行 JSON 存为 UTF-8 文件后用 --input <path>。
Windows PowerShell:
weaver-work-cli --profile eteams --json plan run plan.report.get --input-json '{"type":"week","serialNumber":36}'
macOS/Linux(bash/zsh):
weaver-work-cli --profile eteams --json plan run plan.report.get --input-json '{"type":"week","serialNumber":36}'