china-exec-report

Readme

# china-exec-report

> **Turn messy Excel / interview notes / web clippings / Markdown into a decision-ready Chinese business report — not a plain summary.**
> 把杂乱的 Excel / 访谈纪要 / 网页摘录 / Markdown，转成适合中国管理层阅读的"决策型商业报告"——不是普通总结。

A standalone, vendor-neutral **Agent Skill** (open Agent Skills format) that runs in [Codex](https://github.com/openai/codex), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.com), and [Gemini CLI](https://github.com/google-gemini/gemini-cli). It converts raw operating materials into traceable, actionable, presentation-ready Chinese reports tailored for executives.

一个独立的、厂商中立的 **Agent Skill**（开放 Agent Skills 格式），可在 Codex、Claude Code、Cursor、Gemini CLI 中运行。它把原始经营材料转成可追溯、可执行、可直接汇报的中文报告。

- 目标用户 / Target users：运营负责人、产品负责人、创业团队、咨询顾问。
- 核心卖点 / Core value：输入杂乱材料，输出**可追溯、可决策、可直接汇报**的中文报告，并按受众生成 CEO 一页版、部门负责人版、详细分析版。

---

## Demo / 演示

![china-exec-report demo](docs/demo.svg)

> **Note / 说明**：上图为动画占位 SVG。发布前请替换为真实的 30 秒终端录屏 GIF（展示从输入杂乱材料到输出决策型报告的完整流程）。
> The image above is an animated placeholder SVG. Before publishing, replace it with a real 30-second screen-recording GIF showing the full flow from messy inputs to a decision-ready report.

---

## Install / 安装

Each skill is installed **separately** into the host agent's skills directory — this is not a bundle. Clone the repo and copy **only this skill folder**.

每个 Skill **独立安装**到目标 Agent 的 skills 目录——不是打包安装。克隆仓库后只复制本 Skill 文件夹。

```bash
# 1. Clone the repo / 克隆仓库
git clone https://github.com/whaojie797-design/china-exec-report.git
```

### Claude Code

```bash
mkdir -p ~/.claude/skills
cp -r china-exec-report ~/.claude/skills/
```

### Cursor

```bash
mkdir -p ~/.cursor/skills
cp -r china-exec-report ~/.cursor/skills/
```

### Codex / OpenAI-style

```bash
mkdir -p ~/.codex/skills
cp -r china-exec-report ~/.codex/skills/
```

> After copying, restart the host agent so the skill is loaded. The skill activates automatically when you mention triggers like 经营复盘 / 周报 / 竞品分析 / 管理层汇报.
> 复制后重启宿主 Agent 以加载 Skill。当你提到经营复盘 / 周报 / 竞品分析 / 管理层汇报等触发词时会自动激活。

---

## Before / After 前后对比

### Before（普通总结式输出）

```
本月公司经营情况整体向好，GMV有所提升，自营渠道表现不错，
分销渠道略有下滑。建议加强渠道管理，提升用户体验，持续优化运营。
```

问题：无口径、无来源、无可执行动作、充满空话。

### After（本 Skill 输出的决策型报告·CEO 一页版节选）

```
【经营月报】XX公司 2026年6月 经营复盘
汇报对象：CEO | 数据时间范围：2026-06-01 至 2026-06-30 | 口径：毛利率（履约口径）

一、核心结论
1. 6月增长由自营渠道拉动，分销渠道量价齐跌，需7月前止损。依据：F1、F3、F5。

二、关键异动
| 指标（口径） | 本期 | 上期 | 环比 | 判定 |
| 分销GMV（净额，扣退款） | 860万 | 977万 | -12% | ⚠️异动 |
| 分销客单价 | 320元 | 348元 | -8% | ⚠️异动 |

三、建议动作
- 挽回分销商B合作：由渠道总监[姓名]负责，7月10日前完成谈判。
  预期影响：若挽回，恢复约8%分销量（约60万元/月GMV）。
- A品调价A/B测试：由定价运营[姓名]负责，7月15日前出结论。
  预期影响：确认调价对动销的真实弹性，指导后续定价。

四、风险
- 分销商集中度风险：头部3家占分销55%。严重度：高。缓释：Q3内新增2家备选分销商。
```

差异：结论先行、口径清晰、来源可追溯、建议含负责人/期限/预期影响、风险有缓释。

---

## What it does / 它做什么

1. **材料盘点**：识别材料类型、时间范围、数据缺口、关键口径。
2. **事实与推论分层**：先输出事实表，再输出推论，禁止混淆；每条结论标注证据来源与置信度。
3. **决策六段式**：核心结论 → 指标异动 → 原因假设 → 待验证事项 → 建议动作 → 风险。
4. **按受众裁剪**：CEO 一页版、部门负责人版、详细分析版。
5. **中国商业表达规范**：结论先行、避免空泛 AI 话术、建议必须含负责人/期限/预期影响、不编造数据。

详见 `SKILL.md` 与 `references/`、`assets/`。

---

## Privacy / 隐私说明

- **完全本地运行**：本 Skill 仅依赖宿主 Agent 的模型能力与本地文件，不调用任何第三方 API，不需要任何密钥。
- **无遥测**：不收集任何使用数据，不上传任何文件。
- **Fully local**：This skill relies only on the host agent's model and local files. No third-party APIs, no API keys, no telemetry.

---

## License

MIT — see [LICENSE](LICENSE). `Copyright (c) 2026 whaojie797-design`.