# Siyu Report

> |

- **Type:** Skill
- **Install:** `agentstack add skill-maojiebc-majia-siyu-team-siyu-report`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [maojiebc](https://agentstack.voostack.com/s/maojiebc)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [maojiebc](https://github.com/maojiebc)
- **Source:** https://github.com/maojiebc/majia-siyu-team/tree/main/plugins/siyu-core/skills/siyu-report

## Install

```sh
agentstack add skill-maojiebc-majia-siyu-team-siyu-report
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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`。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [maojiebc](https://github.com/maojiebc)
- **Source:** [maojiebc/majia-siyu-team](https://github.com/maojiebc/majia-siyu-team)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-maojiebc-majia-siyu-team-siyu-report
- Seller: https://agentstack.voostack.com/s/maojiebc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
