Eliteforge Tech Doc

强制约束

• 禁止臆造组件、接口、流程、状态、时序关系。
• 每个关键结论至少绑定 1 个来源文件路径。
• 发现冲突信息时，必须显式列出冲突点与取舍依据。
• 不得忽略扫描结果中的任何文档/图文件；无法消费的文件必须写明原因。
• 输出文档必须包含“来源清单”和“待确认项”。
• 涉及插件化、SPI、Hook等可扩展设计时，必须包含“模块扩展点设计”章节，内部接口设计不属于可扩展范围。

图与流程提炼规则

1. 对流程类内容，优先输出“场景化结构”：触发条件、输入、步骤、输出、异常分支。
2. 对调用链内容，优先使用 mermaid sequenceDiagram 表达关键参与者与调用方向。
3. 对状态流转内容，优先使用 mermaid stateDiagram-v2 表达状态与迁移条件。
4. 对伪代码，保留领域动作名，不替换为空泛描述。
5. 对无法确认的图含义，保留原文件路径并标注“待人工确认”，不要猜测细节。

产出文档最低结构

按模板输出，至少包含以下章节：

1. 文档来源清单
2. 背景与目标
3. 术语与边界
4. 核心场景流程（含伪代码）
5. 时序图
6. 状态图
7. 模块扩展点设计（无扩展时写“暂不支持扩展。”，但不能省略标题）
8. 风险与待确认项

便于从业务动作追溯到系统实现。

输出风格

• 默认中文输出，关键名词沿用原文（如模块名、接口名、类名）。
• 段落短句化，避免泛化空话。
• 图和伪代码只保留对评审决策有价值的内容，避免冗长重复。

参考资料读取策略

• 首次执行先读 references/tech-doc-template.md。
• 出稿前必读 references/quality-checklist.md 做最终检查。

快速命令

# 1) 盘点当前目录文档和图
skills/eliteforge-tech-doc/scripts/list_doc_and_diagram_sources.sh .

# 2) 生成技术设计文档（文件名可改）
# 输出示例：./tech-design-summary.md

示例触发语句

• “请扫描当前目录所有文档和图，产出技术设计文档。”
• “根据仓库里的 markdown 和时序图，整理一份方案设计稿。”
• “把现有设计资料汇总成可评审的 tech design，并标出缺失信息。”

参考文件

• 技术设计文档模板
• 质量自检清单