Cross-Dept Handoff · v1.0
跨部门规范交付索引 v1.0
每个部门的"必读 / 选读 / 不需关心"速查表
跨部门规范交付索引 v1.0
本文档定位
谁需要读哪些规范，一张表说清楚。 适用场景：新员工入职 / 跨部门协作 / 外包合作 / 规范培训。 本页不重复规范细节，只做导航 + 最小必读集。
🎯 快速导航 · 按角色
-
Web 前端工程师
CSS / Tailwind / 组件库开发 → 见下方 §1
-
UI / UX 设计师
视觉设计 / 品牌物料 / 印刷 → 见下方 §2
-
硬件 / 芯片工程师
PCB / IC / 电路 / 结构 → 见下方 §3
-
测试工程师
测试规范 / 自动化 / 质量报告 → 见下方 §4
-
产品经理
PRD / 路线图 / 竞品分析 → 见下方 §5
-
商务 / 交付
销售材料 / 客户文档 / 技术支持 → 见下方 §6
1. Web 前端
1.1 必读（First-Day Reading · 上班第一天必读）
| # | 文档 | 用途 | 预计阅读 |
|---|---|---|---|
| 1 | brand-color-system.md ⭐⭐⭐ | 3+1 色彩系统完整色板、CSS 变量、Tailwind 配置 | 30 分钟 |
| 2 | md-writing-spec.md §11 | 13 个产品名的唯一拼写（前端文案用） | 5 分钟 |
| 3 | AlgoDepartment/06_docs/XIYIN-DESIGN-SPEC.md v1.3（权威上游） |
更深层的视觉规范（字体、间距、动效） | 60 分钟 |
1.2 选读（按需阅读）
| # | 文档 | 何时需要 |
|---|---|---|
| 4 | doc-numbering.md | 如果你要给前端项目起名/归档 |
| 5 | md-writing-spec.md §18.3 色例图例 | 如果你要实现"色彩图例"UI 组件 |
| 6 | AlgoDepartment/06_docs/曦音-UI设计规范.md |
如果你做 XiStudio IDE 产品前端 |
1.3 不需关心
- ❌ Markdown 写作规范大部分内容（§1-§10，§13-§17）
- ❌ 文档编号的 D0/D1/D2/D3 层级（对前端开发无影响）
- ❌ Mermaid 图写法细节（模板由后端生成，前端只需渲染）
1.4 交付 Artifacts
Web 部门要从本规范体系直接复用的资源：
📦 给 Web 的 Artifacts
├── CSS 变量定义 → brand-color-system.md §6 可直接复制
├── Tailwind 配置 → brand-color-system.md §7 可直接合并到 tailwind.config.js
├── 渐变定义 → brand-color-system.md §2 (gradient-trinity / hero / brand-name)
└── 字体栈 → brand-color-system.md §6 末尾（JetBrains Mono / Inter / Noto Sans SC）
2. UI / UX 设计师
2.1 必读
| # | 文档 | 用途 |
|---|---|---|
| 1 | AlgoDepartment/06_docs/XIYIN-DESIGN-SPEC.md v1.3 ⭐⭐⭐ |
权威视觉规范（1220 行）· 字体、色彩、间距、排版、印刷 |
| 2 | brand-color-system.md ⭐⭐ | 3+1 色彩系统 · 含印刷 CMYK 对齐指引 §9.3 |
| 3 | AlgoDepartment/06_docs/曦音-UI设计规范.md ⭐⭐ |
XIYIN Studio IDE 产品 UI 规范（给 IDE 设计师） |
| 4 | md-writing-spec.md §11 | 产品命名拼写 |
2.2 选读
| # | 文档 | 何时需要 |
|---|---|---|
| 5 | md-writing-spec.md §9 Mermaid L0-L5 | 画系统架构图时做参考 |
| 6 | doc-numbering.md | 归档设计文档时 |
2.3 交付 Artifacts
📦 给设计的 Artifacts
├── Figma/Sketch 色板 → 基于 brand-color-system.md §2 导入（设计师自行预配置色板库）
├── InDesign CMYK 色板 → XIYIN-DESIGN-SPEC.md v1.3 印刷章节
├── PPT/Word 主题 → 已有 Office 模板（路径待补）
└── 字体授权清单 → JetBrains Mono(SIL OFL) / Inter(SIL OFL) / Noto Sans SC(SIL OFL)
3. 硬件 / 芯片工程师
3.1 必读
| # | 文档 | 用途 |
|---|---|---|
| 1 | md-writing-spec.md ⭐⭐⭐ | MD 写作规范（硬件规格书、EVT/DVT 报告都是 MD 源） |
| 2 | md-writing-spec.md §11 | 产品命名（XiDSP-D2 / XiAmp Pro-12 型号写法） |
| 3 | doc-numbering.md | 硬件文档的编号规则（D1-B-SPEC / D2-P2/P3 等） |
| 4 | checklist.md | PR 自查清单 |
3.2 选读
| # | 文档 | 何时需要 |
|---|---|---|
| 5 | md-writing-spec.md §9 Mermaid | 画 PCB 层级 / 信号链架构图 |
| 6 | D1-divisions/B-rd/hw-dev-spec.md |
硬件中心内部规范（待建） |
| 7 | D1-divisions/B-rd/ic-dev-spec.md |
芯片开发流程（待建） |
3.3 不需关心
- ❌ 色彩系统细节（brand-color-system.md 整份）
- ❌ Tailwind 配置、CSS 变量
- ❌ 客户文档专区内容（external/）
4. 测试工程师
4.1 必读
| # | 文档 | 用途 |
|---|---|---|
| 1 | md-writing-spec.md ⭐⭐⭐ | 测试报告、测试规范都是 MD 源 |
| 2 | checklist.md ⭐⭐ | 自己提交测试文档 PR 时自查 |
| 3 | doc-numbering.md | 测试文档命名（D2-P7-TECH / D2-Px-RPT 等） |
4.2 选读
| # | 文档 | 何时需要 |
|---|---|---|
| 4 | md-writing-spec.md §9 Mermaid | 画测试流程 / 状态机 |
| 5 | D1-divisions/B-rd/test-spec.md |
测试规范与质量标准（待建） |
4.3 不需关心
- ❌ 色彩系统（除非你同时做测试工具 UI）
- ❌ 商业模式、融资相关
5. 产品经理
5.1 必读
| # | 文档 | 用途 |
|---|---|---|
| 1 | md-writing-spec.md ⭐⭐⭐ | PRD / 产品概述都用 MD 源 |
| 2 | md-writing-spec.md §11 | 产品命名拼写（对外材料必须正确） |
| 3 | D0-company/00-vision/product-matrix.md ⭐⭐⭐ |
Xisound 产品矩阵 V1.1（顶层架构 + 商业模式） |
| 4 | doc-numbering.md | PRD 文档编号（D2-Px-PRD-001-xxx v1.0.md） |
| 5 | D1-divisions/A-product/prd-template.md |
PRD 模板（待建） |
5.2 选读
| # | 文档 | 何时需要 |
|---|---|---|
| 6 | brand-color-system.md §3 Mermaid L0-L5 | 画产品层级图时引用 |
| 7 | md-writing-spec.md §9.2.1 六层矩阵模板 | 画产品全景图 |
5.3 交付 Artifacts
- PRD 模板（待 D1-A 补齐）
- 竞品分析模板（待 D1-A 补齐）
- OKR 季度复盘模板（待 D3 补齐）
6. 商务 / 交付
6.1 必读（销售 / 客户成功）
| # | 文档 | 用途 |
|---|---|---|
| 1 | D0-company/00-vision/product-matrix.md ⭐⭐⭐ |
向客户讲清楚 Xisound 做什么、怎么赚钱 |
| 2 | md-writing-spec.md §11 | 产品命名（销售口径统一） |
| 3 | external/ 整个客户文档专区 |
客户会看到哪些内容 |
| 4 | D1-divisions/C-sales/ |
销售 SOP / 话术 / 报价手册（待建） |
6.2 对技术支持的额外要求
| # | 文档 | 用途 |
|---|---|---|
| 5 | md-writing-spec.md | 编写客户手册 / FAQ |
| 6 | brand-color-system.md §6 | 客户演示 PPT 色板 |
7. 外包 / 合作伙伴
7.1 只需阅读 3 份
| # | 文档 | 原因 |
|---|---|---|
| 1 | brand-color-system.md | 物料必须遵守品牌色系 |
| 2 | md-writing-spec.md §11 | 产品名不能拼错 |
| 3 | external/index.md |
理解客户文档定位 |
7.2 保密约束
- ⛔ 禁止访问
D0-02制度与文化、D0-03融资与法务 - ⛔ 禁止访问
D1-B-rd/ic-dev-spec.md等芯片 IP 文档 - ⛔ 禁止访问
D2-products/P2-xidsp/芯片相关内部资料
8. 一览矩阵 · 各角色必读对照
| 角色 | md-writing-spec | brand-color-system | doc-numbering | checklist | XIYIN-DESIGN-SPEC | product-matrix |
|---|---|---|---|---|---|---|
| Web 前端 | 选读 §11 | ⭐⭐⭐ | 选读 | 选读 | ⭐ | 选读 |
| UI 设计 | 选读 §11 | ⭐⭐ | 选读 | ⭐⭐⭐ | 选读 | |
| 硬件 / 芯片 | ⭐⭐⭐ | ❌ | ⭐⭐ | ⭐⭐ | 选读 | |
| 测试 | ⭐⭐⭐ | ❌ | ⭐⭐ | ⭐⭐ | ||
| 产品经理 | ⭐⭐⭐ | 选读 §3 | ⭐⭐ | ⭐ | ⭐⭐⭐ | |
| 商务 / 交付 | 选读 §11 | 选读 §6 | ⭐⭐⭐ | |||
| 外包 | 选读 §11 | ⭐⭐ |
⭐⭐⭐ = 必读 / ⭐⭐ = 强烈建议 / ⭐ = 选读 / 选读 = 按需 / ❌ = 不需要
9. 新员工 7 天阅读路径（推荐）
| 第 N 天 | 阅读项目 | 产出 |
|---|---|---|
| Day 1 | 本文件（跨部门索引）+ md-writing-spec.md §1-§7 | 理解 MD 写作契约 |
| Day 2 | md-writing-spec.md §8-§17 + 附录 | 掌握代码块、Mermaid、产品命名 |
| Day 3 | D0-company/00-vision/product-matrix.md |
理解公司产品矩阵与商业模式 |
| Day 4 | 本岗位专属必读（按 §1-§6 索引） | 领到可落地的交付 artifacts |
| Day 5 | checklist.md + 提交一个 dummy PR（修正文） | 完成首次 PR 自查实战 |
| Day 6 | doc-numbering.md + 给一份旧文档重命名 | 掌握编号规则 |
| Day 7 | 复习 + 反馈本规范体系的改进建议到 D0-05-standards PR |
融入规范迭代循环 |
10. 反馈与迭代
如果您在阅读规范时遇到：
- 🐛 错误 / 过期信息 → 提 Issue 或 PR 到
06_docs/site-build/ - 💡 改进建议 → 在本页文末评论区（待集成 Giscus）或发邮件至 docs@xisound.com
- ❓ 疑问澄清 → 联系相应规范的作者（见各文档 frontmatter
author字段）
本规范每季度 review 一次，采纳的反馈会计入版本历史。
附录 · 相关文档索引
跨中心通用规范（D0-05）
- md-writing-spec.md —— MD 写作规范（作者版）
- brand-color-system.md —— 3+1 色彩系统（Web/设计版）
- doc-numbering.md —— 文档编号与命名
- checklist.md —— PR 自查清单
- todo-list.md —— 未完成文档清单
权威上游规范（仓库根目录）
AlgoDepartment/06_docs/XIYIN-DESIGN-SPEC.mdv1.3（1220 行视觉规范）AlgoDepartment/06_docs/曦音-UI设计规范.md（XiStudio IDE 产品 UI）AlgoDepartment/06_docs/Xisound-羲音 产品矩阵 V1.1.md（商业模式 · 顶层架构）AlgoDepartment/06_docs/Xisound-羲音 初创公司文档体系架构规划 V1.0.md（本规范体系的源头规划）
release-to-other-depts.md · v1.0 · 2026-05-05 · Xisound AlgoDepartment