Huibao

---
name: huibao
description: Turn scattered work materials into evidence-grounded daily, weekly, monthly, retrospective, handoff, and custom reports in the user's own reporting voice for a chosen audience. Use when the user asks to write, summarize, revise, or standardize a report; do not use for generic copywriting without source material.
license: MIT
metadata:
  short-description: Evidence-grounded reports in your voice
---

# 汇报.skill

把“做过什么”整理成“别人看得懂、自己也愿意回看的汇报”。本 Skill 的核心不是替用户制造一套漂亮话，而是把材料里的事实、用户的汇报人格和受众真正关心的内容接起来。

## 工作原则

- 当前材料决定“说什么”；汇报人格只决定“怎么说”。本次用户要求优先于本地档案，本地档案优先于内置默认。
- 先把材料理清，再写正文。内部记录哪些已经发生、哪些只是用户判断、哪些还要确认；给人看的默认报告只说“做成了什么、还差什么、接下来做什么”，不展示核对过程的术语。
- 不编造数字、成果、人物、时间、影响、完成状态或“需要支持”的事项。材料没有写到的内容，用“还没测到 / 还没定 / 需要确认”说清楚，而不是替用户补全。
- 先理解周期和受众，再决定取舍。用户明确要求的结构、语气和长度可以覆盖默认模板，但不能覆盖证据边界和隐私边界。
- 第一次使用尽量不提问：能从用户的话和材料看出的信息直接采用；确实缺少会改变结果的周期或读者时，只问一个最小问题，其他按常用默认处理。
- 默认输出 Markdown；用户需要转发时提供纯文本，需要展示时提供无外部依赖的单文件 HTML。

## 调用方式

这是一个 Agent Skill，不是所有工具都共用的函数或固定的 `/huibao` 机器人。安装到支持 Agent Skills 的宿主后，通常直接用自然语言触发：

```text
把我今天的记录写成给老板看的日报，先说结果。
```

如果宿主提供显式 Skill 提及，使用它自己的语法：Codex 可用 `$huibao`，也可以通过 `/skills` 选择；Claude Code 通常可用 `/huibao`。Cursor 等其他宿主的显式入口以各自文档为准，不要把某一种调用语法当成所有 runtime 通用的命令。

## Python 脚本什么时候运行

Python 是可选的确定性助手，不是用户第一次使用的门槛。用户只需提供材料和一句话请求；当宿主允许 Agent 执行本地脚本时，由 Agent 按需要代为运行。默认决策如下：

- 只有一段文字、要一份临时汇报：不运行 Python，直接在对话中完成。
- 用户给了文件夹、多个文件或明确的 Git 仓库：需要建立可回看的材料索引时，再运行 `collect_inputs.py`。
- 用户说“上周 / 本月 / 最近 7 天”或要保存归档：需要固定日期或文件契约时，再运行 `resolve_period.py`。
- 用户明确要记住语气、保存偏好或回滚档案：在有本地写入权限且用户已明确同意时，运行 `manage_profile.py`。
- 用户要求 HTML 或保存前检查：再运行 `render_report.py` 或 `validate_report.py`。

如果宿主没有 Python、没有脚本执行权限，或用户不希望写本地文件，继续用对话完成能完成的部分；有文件写权限时，可以直接维护 Markdown 形式的档案，没有写权限时要明确哪些索引、检查或档案没有被保存。不要要求用户为了得到第一份汇报先手动敲命令。

## 执行流程

1. 确定周期、日期边界、受众、报告类型和输出格式。相对日期按用户所在时区解释；不确定的“上周/月底”不要悄悄猜。确定后可运行 `python scripts/resolve_period.py --period weekly --reference-date YYYY-MM-DD --json` 固化边界；周/月/季进行中时，结束日是当前参考日，不冒充完整周期。用户说“我今天都干了什么”时，当前对话中已经出现的工作内容可以作为材料；若没有其他记录，只能总结当前对话能看到的部分，不声称覆盖用户整天。
2. 收集用户已经提供的粘贴内容、文件夹、笔记、聊天导出、旧汇报、代码仓库、Git 记录或 Agent 会话。没有材料时不要生成虚构的“完成事项”。
3. 必要时由 Agent 代为运行 `scripts/collect_inputs.py` 建立可审阅的 JSONL 输入索引。它不修改输入材料，只读取文字文件和用户明确指定的 Git 仓库；只有用户通过 `--output` 指定目的地时才写入 JSONL。它不自动读取 Codex/Claude 的私有 session store；会话请先导出、粘贴或提供可读文本。它不联网、不调用账号。
4. 建立证据底稿：提取事实、来源、日期、项目、敏感性和证据 ID；把跨项目内容分开，标出冲突和未知。详细字段与引用规则见 [references/evidence-ledger.md](references/evidence-ledger.md)。
5. 读取已有的 `huibao/profile.md`、相关历史样本和 `huibao/specs/` 规格；没有档案就使用克制的默认风格，不要求用户先填一份长问卷。需要建立或修改人格时读 [references/style-profile.md](references/style-profile.md)；可用 `python scripts/manage_profile.py init --root ./huibao` 初始化，用 `record-preference` 记录长期偏好，用 `record-correction` 记录长期纠正，用 `rollback` 从显式快照回退。第一次先解决眼前这份汇报；只有用户说“以后都这样写”“记住这个结构”或明确认可时，才把偏好、模板或样本沉淀下来。
6. 按受众渲染同一份材料：老板/导师看结果、影响、风险和请求；团队看上下文、变更和依赖；客户看交付、价值、范围和下一步；自己看过程、学习和未决项。完整取舍见 [references/report-spec.md](references/report-spec.md)。如果材料没有提供下一步而用户要求你补充，写成“建议下一步”或“可选动作”，不要写成已经定下来的计划。
7. 输出报告。保存到磁盘的 Markdown、纯文本和 HTML 建议带统一 metadata：`report_type`、`period_start`、`period_end`、`audience`、`evidence_status`；这些字段是给文件和工具看的，不进入默认正文。给人发送的版本默认是清洁正文，不显示证据 ID，也不把内部检查词写进标题；缺信息就用“还没测到 / 还没定 / 下一步”这类正常话说清楚。只有用户明确要复查时，才另外保留核对版。用户要求“一页”“只写三点”时优先压缩背景，不牺牲关键风险和证据。
8. 交付前检查日期、引用、事实/推断、隐私和格式。必要时运行 `scripts/validate_report.py`；严格归档可加 `--require-evidence --require-in-period`。需要 HTML 时运行 `python scripts/render_report.py --input report.md --output report.html`；这些脚本能检查确定性规则，不能代替语义审阅。
9. 默认先在对话中交付；只有用户要求保存或已有明确本地约定时，才写入 `huibao/reports/`。长期使用时，把“怎么说”放进 `profile.md`，把明确认可的脱敏样本放进 `style-samples/`，把常用结构放进 `specs/`，把需要留存的成稿放进 `reports/`，把纠正前的版本放进 `history/`。用户明确说“以后都这样写”或接受建议后，才更新 `huibao/profile.md`，并保留可回滚的纠正记录。旧报告只学习表达，不自动带入新周期的事实。

## 参考资料路由

- 每次生成报告：阅读 [evidence-ledger.md](references/evidence-ledger.md) 和 [report-spec.md](references/report-spec.md)。
- 输入来自多个文件、Git、聊天或截图说明：再阅读 [input-guide.md](references/input-guide.md)。
- 用户提供历史样本、要求模仿语气、纠正措辞或要求长期记住偏好：再阅读 [style-profile.md](references/style-profile.md)。

## 失败降级

- 只有零散笔记：生成“已确认信息 / 尚缺信息 / 下一步”短报，不把活动自动包装成成果。
- 没有 Git 或 Agent 会话：使用现有笔记、聊天和用户陈述，明确资料范围。
- 周期内没有材料：返回“本周期暂无可核对材料”，可附空白采集清单，不填充模板化进展。
- 运行环境没有 Git、Agent 会话或可读的会话导出：继续使用笔记、聊天和用户陈述，并在报告中写明资料覆盖范围；不要声称扫描过未提供的 session store。
- 来源互相矛盾：并列来源、描述差异和待确认问题；不要替用户选一个看起来更好的数字。
- 含密码、令牌、身份证号、客户隐私或内部机密：默认不回显具体值，先脱敏；若敏感信息会改变结论，只保留必要的抽象描述并提醒用户确认受众。

更多材料格式、隐私处理和命令示例见 [references/input-guide.md](references/input-guide.md)。