2.4 KiB
2.4 KiB
规范-文档索引与可发现性
位置:
docs/开发规范/规范-文档索引与可发现性.md版本: v1.0 日期: 2026-07-08 关联: AGENTS.md、docs/index.md
1. 总索引维护
docs/index.md 为文档总入口，必须保持最新。每个 agent 新增/修改文档后，必须同步更新索引。
1.1 索引格式
## 设计文档（GDD）
| 编号 | 文档 | 状态 | 最后更新 |
|------|------|------|----------|
| GDD-00 | [决策总索引](设计文档/GDD-00-决策总索引.md) | ✅ v2.6 | 2026-07-06 |
| GDD-01 | [种族系统设计](设计文档/GDD-01-种族系统设计.md) | ✅ v2.14 | 2026-07-06 |
1.2 索引更新规则
- 新增文档 → 在对应分类末尾追加一行
- 修改文档 → 更新「状态」和「最后更新」列
- 废弃文档 → 状态改为
❌ 已废弃，保留链接（避免死链）
2. 文档间导航
2.1 快速导航（每份文档头部）
> 📎 快速导航:
> [上一篇: GDD-01 种族系统] | [下一篇: GDD-03 战斗系统] | [索引: 决策总索引]
2.2 相关文档链接
每份文档头部「关联文档」栏必须列出所有引用或被引用的文档：
> **关联文档**: GDD-02（底层核心机制）、GDD-23（能量体系）、PRD-05（战斗系统需求）
3. 关键词索引
docs/开发规范/关键词索引.md（可自动生成）维护关键词到文档的映射：
| 关键词 | 相关文档 |
|--------|----------|
| 能量体系 | GDD-02 ✅158, GDD-23, PRD-01 §2, PRD-05 §2.8 |
| 天启机制 | GDD-08 ✅122, GDD-08 ✅160, PRD-02 §2.2, PRD-10 §2.5 |
| 死亡惩罚 | GDD-02 ✅25, PRD-06 §2.8 |
| 拍卖系统 | GDD-14, PRD-06 §2.3 |
4. 决策速查
在 GDD-00 中增加按主题分类的决策索引：
## 按主题索引
### 能量体系
| 决策 | 主题 |
|------|------|
| ✅158 | 能量双轨模型 |
| ✅159 | 四档恢复梯度 |
| ✅112 | 能量循环替代体力 |
### 战斗系统
| 决策 | 主题 |
|------|------|
| ✅1 | ATB 即时制 |
| ✅165 | 降维护佑 PVP 系数 |
5. 文档状态标记
| 标记 | 含义 |
|---|---|
| ✅ | 已确认定稿 |
| 🔄 | 审阅中/待更新 |
| ❓ | 有待确认事项 |
| ❌ | 已废弃/被取代 |
6. 版本记录
- v1.0（2026-07-08）: 初始版本，覆盖索引维护、文档导航、关键词索引、决策速查
