# Chinese Workflow Templates

Use this reference when the deliverable is Chinese-first and the recipient expects a ready-to-send package instead of abstract guidance.

## 1. Recommended Chinese package flow

A common and effective order is:

1. `index.html` as the total entry page
2. one main formal report page
3. one or more supporting note pages for methods / protocol / sensitivity analysis
4. `README.md` for reading order and file manifest
5. `analysis_code/` and `analysis_data/` for reproducibility support

Recommended page roles:
- `index.html`: 总览页 / 入口页
- `01_<topic>_formal_report.html`: 主报告页
- `02_<topic>_note.html`: 补充说明页
- `03_<topic>_protocol_note.html`: 方法或 protocol 说明页
- `04_<topic>_sensitivity_note.html`: 敏感性分析说明页

## 2. Chinese README template

```markdown
# <项目或主题名称>正式报告包

- 需求方：<name>
- 分析提供方：<name>

## 建议阅读顺序

1. 先打开 `index.html`：这是总览页，用于快速理解本包的结构、边界与主要结果。
2. 再看 `<main-report>.html`：这是本次结果的主报告页。
3. 如需查看方法边界、protocol 写法或敏感性分析，继续查看其余 note 页面。
4. 如需复核材料来源与可复现性，查看 `analysis_code/` 与 `analysis_data/`。

## 包内主要页面

- `index.html`
- `<main-report>.html`
- `<method-note>.html`
- `<sensitivity-note>.html`

## 代码与数据

- `analysis_code/`：本次报告包直接对应的主要分析代码。
- `analysis_data/`：本次报告包直接对应的主要分析输入数据或受限数据说明。

## 当前必须坚持的结论边界

- 正式主结果仍是：<main-result>
- 补充分析用于说明：<robustness-purpose>
- 以下内容不能升级表述为：<forbidden-claim-1>、<forbidden-claim-2>
- 本包支持的是：<supported-claim>
- 本包不支持的是：<unsupported-claim>

## 主要清单

- `<table-1>.csv`
- `<table-2>.csv`
- `analysis_code/`
- `analysis_data/`
- `assets/`
```

## 3. Chinese index / hero wording template

Use this when editing the hero section of `index.html` or the main HTML page.

```html
<section class="hero">
  <div class="badge">正式报告 · <date></div>
  <h1><项目或主题名称>正式报告包</h1>
  <p class="subtitle">本页先概览正式主结果，再整理补充分析、方法说明与材料清单，便于正式查看、结果复核与独立结果留档。</p>
  <div class="meta-row">
    <span class="meta-pill">需求方：<name></span>
    <span class="meta-pill">分析提供方：<name></span>
    <span class="meta-pill">正式主结果：<main-result></span>
    <span class="meta-pill">补充分析不等于 <forbidden-claim></span>
  </div>
</section>
```

Useful subtitle patterns:
- “本页先概览正式主结果，再整理补充分析、方法说明与材料清单。”
- “本页用于正式结果说明，不改变正式主结果锚点。”
- “本页适合正式查看或结果复核。”
- “本页同时保留独立结果留档所需的核心信息。”

## 4. Chinese main report opening template

```markdown
# <项目或主题名称>正式报告

> 本页用于正式结果说明。先给出正式主结果，再补充方法边界、稳健性证据与当前材料清单。

## 项目角色

- 需求方：`<name>`
- 分析提供方：`<name>`

## 本页摘要

- 正式主结果：`<main-result>`
- 补充分析层：`<supporting-layer>`
- 当前边界：`<boundary-note>`

## 如何阅读本页

1. 先看正式主结果是什么。
2. 再看补充分析解释了什么。
3. 最后看当前不能过度宣称的点。
```

Useful sentence patterns:
- “正式主结果仍是……”
- “补充分析用于说明稳健性 / 边界，不改变正式主结果锚点。”
- “该结果属于内部验证 / 补充验证，不应写成 external validation。”
- “当前材料支持的是更完整的解释链，不支持更强的泛化或因果宣称。”

## 4A. Chinese formal section / card label replacements

When a Chinese formal package needs section titles, homepage cards, or CTA labels, prefer neutral archival / review wording instead of chat or forwarding wording.

Avoid:
- 本次会话报告
- 可直接发送摘要
- 直接转发
- 内部沟通

Prefer:
- 分析小结
- 分析小结（正式记录）
- 结果概览
- 正式查看
- 结果复核
- 独立结果留档

## 5. Chinese method / protocol note template

```markdown
# <topic>说明

> 本页补充说明当前方法写法、protocol 边界或 split 口径，便于与主报告配套阅读。

## 本页用途

- 说明当前采用的写法是什么
- 说明哪些描述可以写，哪些描述不能写
- 说明本页与主报告之间的关系

## 当前可写边界

- 可以写：<allowed-1>
- 可以写：<allowed-2>
- 不能写：<forbidden-1>
- 不能写：<forbidden-2>

## 当前材料来源

- `<file-1>`
- `<file-2>`
- `<mapping-file>`
```

## 6. Chinese sensitivity analysis note template

```markdown
# <topic>：敏感性分析说明

> 本页用于补充主报告之外的敏感性分析结果，帮助理解结果是否稳定，但不改变正式主结果锚点。

## 本页定位

- 属于：补充分析 / 敏感性分析
- 作用：帮助理解结果边界与稳定性
- 不应升级表述为：external validation / final confirmation

## 结果解读

- 本结果提示：<observation>
- 本结果支持：<supported-interpretation>
- 本结果不支持：<unsupported-interpretation>
```

## 7. Chinese `analysis_code/README.md` template

```markdown
# analysis code

本目录纳入本次报告包直接对应的主要分析代码：

- `<entrypoint>`：总入口
- `<config>`：分析参数配置
- `<stage-script-1>`：主流程或阶段分析脚本
- `<stage-script-2>`：补充分析或验证脚本
- `<figure-script>`：图件生成与版式修复

## 说明

- 本目录只保留与当前报告包直接相关的代码。
- 若某些脚本依赖本地环境路径，请在打包前先去除或替换为安全占位符。
```

## 8. Chinese `analysis_data/README.md` template

```markdown
# analysis data

本目录纳入本次报告包直接对应的主要分析输入数据：

- `<data-1>`：<description>
- `<data-2>`：<description>
- `<grouping-file>`：<description>
- `<mapping-file>`：<description>

## 说明

- 本目录用于说明当前报告页、表格与图件所依赖的数据来源。
- 若原始数据受限，请在本页写明受限原因，并提供可公开的替代清单或 manifest。
```

## 9. Chinese package wording checklist

Before shipping, scan these high-risk phrases:
- 对外正式交接页
- 外部正式交接包
- handoff
- teacher package
- 老师您好
- 内部对接
- 本次会话报告
- 可直接发送摘要
- 直接转发
- 内部沟通
- blocked items
- 基于 OCR 脱敏整理
- 素材清洗后
- 本页不复用原始截图 / 昵称 / 日期 / 短链
- 以下模板基于 OCR 提炼后的公开经验整理
- 已移除作者名、日期、原始链接与平台痕迹

Preferred replacements:
- 分析小结
- 分析小结（正式记录）
- 结果概览
- 正式查看
- 结果复核
- 独立结果留档
- 正式报告页
- 正式报告包
- 总览页
- 结果说明
- 方法说明
- 材料清单

## 10. Chinese audit command example

```bash
python3 ~/.codex/skills/formal-delivery-package/scripts/audit_formal_package.py <package_dir> \
  --required index.html \
  --required README.md \
  --required analysis_code/README.md \
  --required analysis_data/README.md \
  --required-text 'README.md::需求方' \
  --required-text 'README.md::分析提供方' \
  --forbidden '对外正式交接页' \
  --forbidden '外部正式交接包' \
  --forbidden '本次会话报告' \
  --forbidden '可直接发送摘要' \
  --forbidden '直接转发' \
  --forbidden '内部沟通' \
  --forbidden 'teacher package' \
  --forbidden 'OCR 脱敏整理' \
  --forbidden '素材清洗后' \
  --forbidden '已移除作者名'
```
