泛微E10计划报告

要解决的问题

E10 的计划报告（周报、月报、季报、年中报告、年报）功能分散在一组 HTTP 接口后面。直接对接时，开发者要自己拼完整地址、处理认证、把人员 id 从名称解析出来、按 ISO8601 算周期序号，还要记得雪花 id 必须当字符串传，否则精度会丢。更麻烦的是状态约束：只有草稿和被退回的报告能发布，只有已发布和审批中的能撤回，而写操作一旦发出就不可撤销。这个 Skill 把这些细节收敛成一条可预期的调用链路。

核心能力与工作方式

Skill 封装了报告的新建、查询、修改、发布、撤回、共享列表、提交提醒和评论查看，接口文档放在 references/ 目录。调用前先读 references/catalog.md 看目录，再读对应单接口文档，不凭印象猜参数。

几个关键步骤值得说明：

• 接口地址与认证分离。单接口文档里的 URL 都是去域名路径，完整地址和认证统一交给 weaver-e10-login，本 Skill 不拼接地址也不实现认证，生成的参数里不含 token、签名等字段。
• 周期序号按 ISO8601 计算，1 月 4 日所在的那个星期算当年第 1 个星期。
• 写操作前先查详情。修改、发布、撤回都要先取报告 id 并核对状态，不能跳过查询直接写。
• 查询详情必带评论统计。评论为 0 条时完全忽略评论模块；大于 0 条时只提示条数，等用户明确说要看才输出评论内容。
• 人员名称先解析为 id，取 id 或 employeeId，不取 userId；提醒他人时 ids 用英文逗号拼接。

适用边界与注意点

• 只能操作当前登录用户自己的报告，不支持代他人新建、修改、发布或撤回。
• 新建、修改、发布、撤回、发送提醒都属于有副作用的写操作，必须先拿到用户明确确认。
• 同类候选接口调用失败后停止并说明原因，不会自动切到近义接口或兜底接口重试。
• 找不到匹配接口时直接说明，不会自行构造不存在的路径或参数。
• 需要用户上传附件或解析文件内容时，先提醒文件内容会发给大模型服务，确认无敏感信息后再继续。
• 所有雪花 id 类型参数（人员 id、报告 id）通过请求体传参时必须用引号包裹为字符串。