# {{PRODUCT_NAME}} Docs Index

> 长青文档：**[`PRODUCT_INTRODUCTION.md`](./PRODUCT_INTRODUCTION.md)** — 项目介绍（简介 + 团队 roster + 产品设计规则 + Figma 索引），**产品设计任务起手必读**（见 `consumer-product-conventions` skill Rule 8）。

文档按用途分目录。新增文件请放到对应子目录，并按 `YYYY-MM-DD-{feature}-{type}.md` 命名。

---

## 🧭 起手先读索引（免全局搜索）

**定位需求先读 [`REQUEST-INDEX.md`](./REQUEST-INDEX.md)**：需求 ↔ 来源（Jira/Slack/Miro/…）↔ Figma 节点 ↔ design-record/handoff 的映射总表（按需求 `id` 归组）。给任一 Jira key / Figma 节点 ID / Slack 线索，一步反查到需求 + 相关文档，不必全局搜索。

**维护**：`specs/`（design-record）与 `handoffs/`（handoff）两类文档必须带 v2 frontmatter（模板见 [`specs/_feature-design-record.template.md`](./specs/_feature-design-record.template.md) / [`handoffs/_handoff.template.md`](./handoffs/_handoff.template.md)）；同一需求的多篇文档用**同一 `id` slug** 关联。改动任一 design-record / handoff 后跑 `node docs/scripts/build-request-index.mjs` 重生成（勿手改 `REQUEST-INDEX.md` / `request-index.json`）。**收尾默认含此步。**

---

## 📓 [retrospects/](./retrospects/) — 复盘

AI-用户协作过程复盘（内部分享格式）。每次任务收尾时产出，记录"做了什么 / 哪里卡住 / 学到什么"。

每篇复盘配对两份：`*.md`（长读版） + `*.slides.md`（Marp 幻灯片源，导出 PPTX / PDF / HTML 给同事 + 领导）。详见 [retrospects/README.md](./retrospects/README.md)。

---

## 🤝 [handoffs/](./handoffs/) — Session 交接 / 下次 Pickup

跨 session 的工作交接说明。当前 session 写给下次的 self。

---

## 🔍 [audits/](./audits/) — F1 走查 / Walkthrough

对 mockup / 代码的结构化走查记录（PRD 对齐、sibling visual contract、规则合规等）。

---

## 📐 [specs/](./specs/) — 设计 Spec / Figma Prompt

设计描述、规范文档、Figma 生成提示词等"输入型"文档。

---

## ✅ [decisions/](./decisions/) — 设计决策记录 (ADR)

固化的设计/产品决策，单文件单决策。

---

## 🛠️ [scripts/](./scripts/) — 文档工具脚本

`build-request-index.mjs`（scaffold 自带，零依赖 Node）：扫 `specs/` + `handoffs/` 的 frontmatter，生成上方「起手先读索引」的 `REQUEST-INDEX.md` + `request-index.json`。`--check` 只校验不写文件。`_` 前缀的模板文件不纳入索引。

---

## 命名约定

- **复盘文件**：`YYYY-MM-DD-{feature}-{N-round-retrospect|retrospect-internal-share}.md`（配套 `.slides.md`）
- **Handoff**：`YYYY-MM-DD-{feature}-{handoff|pickup|next-session-pickup}.md`
- **Walkthrough**：`YYYY-MM-DD-{feature}-{milestone}-walkthrough{-fix}.md`
- **Spec**：`YYYY-MM-DD-{feature}-spec.md` / `-figma-prompt.md`
- **Decision**：`YYYY-MM-DD-{decision-slug}.md`

---

> 本骨架由 `setup-tvu-consumer` skill 从 `tvu-design-system/templates/consumer-product/docs/` scaffold。
> 改进骨架请去真源 repo，不要单点改本文件后失同步。