# Siyu Report

> 合并同一客户的多份本地存档，生成经过合规扫描的可交付 markdown 私域咨询报告。 触发方式：/siyu-report、/出报告、「打包」「整理一份」「给老板或客户看」；支持 --client 和 --since。

- Skill: `maojiebc/siyu-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add maojiebc/siyu-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/maojiebc/siyu-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: maojiebc (https://skillmd.com/u/maojiebc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/maojiebc/siyu-report

---


# siyu-report：客户咨询报告

只从 `~/.siyu/clients/{客户}/` 的存档合并报告，不从当前对话凭空发挥。报告属于跨对话客户档案；`.siyu-team/` 仍只是一轮总协调安排的运行中状态。

## 用户措辞

对用户说「客户」「存档」「对话」，不说 slug、snapshot、session。报告本身保持克制、可追溯，不加感叹号或鼓励语。

## 触发方式

| 命令 | 行为 |
|---|---|
| `/siyu-report` | 合并当前客户全部存档 |
| `/siyu-report --client <客户>` | 指定客户 |
| `/siyu-report --since YYYY-MM-DD` | 只取指定日期之后的存档 |

## 工作流程

### 1. 确认数据

- 0 份：说明先用 `/siyu-save` 累积结论。
- 1 份：说明单份可以直接阅读；用户仍要报告时继续。
- 至少 2 份：直接合并。

路径必须限定在 `~/.siyu/clients/`，禁止路径穿越。按文件名前缀从早到晚读取，不依赖 mtime。

### 2. 解析并追溯

读取每份档案的 frontmatter 和六段正文。格式不完整时使用现有字段并在附录标注缺失，不猜造。合并规则：

- 主诉按时间展示演进，只总结关注点变化，不推测原因。
- 结论语义去重；后续修正旧结论时两条都保留，旧条目标「已被后续修正」。
- 否决方向原样保留理由。
- 未解决问题取进行中档案的待验证假设，以及从未被后续处理的方向。
- 下一步优先使用最新档案，其次是反复出现但未完成的建议。

### 3. 写入新报告

```text
~/.siyu/reports/{客户}/{YYYYMMDD-HHMMSS}-{客户}-私域咨询报告.md
```

永不覆盖已有报告。固定结构：

```markdown
# {客户} 私域咨询报告

**生成时间**：{本地时间}
**累积存档**：{N} 份（{最早日期}—{最新日期}）
**主要使用的能力**：{source_skill 去重}

## 一、客户主诉的演进
## 二、已确认的结论
## 三、已否决的方向
## 四、当前未解决的问题
## 五、推荐下一步
## 六、合规记录
## 七、附录：存档索引

由私域专家团生成。
```

每条结论标注来源标题和日期；附录列日期、标题、中文状态、来源能力和原文件路径。

### 4. 交付前合规扫描

先写到报告路径，再运行：

```bash
PYTHONPATH=src python3 -m siyu_team.eval.cli score "{报告路径}" --threshold 0
```

- 命中 `COMPLIANCE_RED`：不得交付。定位命中句，基于原存档做合规改写；不能安全改写时停止并让用户确认。
- 未命中：在「合规记录」写扫描时间与结果，再完成交付。
- 不得删除或绕过 `COMPLIANCE_RED` 硬卡。

### 5. 回执

> 报告已生成：{路径}。合并 {N} 份存档（{起始日期}—{结束日期}），合规扫描通过。

只给路径、数量、跨度和扫描结果，不复述报告正文。

## 边界

- 存档冲突：全部保留并标注修正关系。
- 敏感信息：生成前提醒报告会原样合并本地档案；需要脱敏时先征得用户确认。
- 只输出 markdown，不主动转 PDF 或 HTML。
- 一律中文，遵循《中文文案排版指北》。

---

## 不知道下一步用哪个 skill？

输入 `/siyu`。

这是私域工具箱的导航入口。它会读取刚才的具体结论，选择当前最值得处理的一个方向，
并直接路由到对应 skill。迷路了就回 `/siyu`。