用途:基于已有材料生成可评审的技术设计文档,不凭空编造事实,覆盖当前执行目录中的全部文档与图,并给出处置结论(已采纳/背景参考/待确认)。
主要能力:盘点资料并建立来源清单,按 P0/P1/P2 优先级读取;建立事实依据(结论、证据文件、置信度、备注);按模板起草文档;优先复用已有图(.mmd/.mermaid/.puml/.plantuml/.drawio),仅图片时依据周边文档与文件名归纳,不确定项标记“待人工确认”;输出到用户指定路径,未指定时默认 ./tech-design.md;按质量清单自检。
使用方式:先运行 scripts/list_doc_and_diagram_sources.sh . 盘点资料;首次执行先读 references/tech-doc-template.md,出稿前必读 references/quality-checklist.md。快速命令示例:skills/eliteforge-tech-doc/scripts/list_doc_and_diagram_sources.sh .
产出结构:文档来源清单、背景与目标、术语与边界、核心场景流程(含伪代码)、时序图、状态图、模块扩展点设计(无扩展时写“暂不支持扩展。”)、风险与待确认项。
限制:禁止臆造组件、接口、流程、状态、时序关系;每个关键结论至少绑定 1 个来源文件路径;冲突信息须显式列出冲突点与取舍依据;不得忽略扫描结果中的任何文档/图文件,无法消费的文件须写明原因;涉及插件化、SPI、Hook 等可扩展设计时必须包含“模块扩展点设计”章节。默认中文输出,关键名词沿用原文。