用途:产出评审者可据以行动和质疑的技术文档,而非填满模板的空壳。覆盖需求/PRD、技术方案/设计文档、低层设计(LLD)、决策记录与权衡分析。
主要能力:写作前先做6维提示校验,不足则先问最弱的1–2个维度,不猜测;在文档头部回答三个框架问题(读者是谁、已实现与拟议之分、什么会让文档出错)。按复杂度选层级:T0一句话Y陈述或PR描述,T1 Nygard ADR或一页规格,T2 MADR加适用的LLD章节,T3跨团队RFC。满足多团队影响、难以回退、存在多个可信选项、安全/资金/数据损失风险、读者无法当面提问中至少两项时升级层级。
使用方式:先取证再起草,引用格式为path/to/file.ts:120-134;对超过2万token的来源先逐字摘录。每条非显然论断标注证据等级:[CODE]、[SOURCE]、[CONVENTION]、[UNVERIFIED]。验证采用独立通道,不在草稿上下文中自评,优先用外部验证器(跑测试、执行片段、curl端点)。需求使用C/R/A三元组,参照ISO/IEC/IEEE 29148:2018与INCOSE GtWR v4,可机械检查的规则包括禁用模糊词、禁用免责条款、每条陈述一个shall、量词需定义范围、数字需带单位或容差、术语统一。LLD无标准形式,以IEEE 1016-2009十二个设计视角作为菜单,停止标准是细化到可编码、可编译、可测试。
限制:多数结构属惯例而非实测有效;自纠错会降低输出质量,多智能体辩论在同等预算下不如自一致性;这些技术减少幻觉但不消除,关键信息仍需验证。文档须标注状态(ideation→discussion→published→committed→abandoned),T1以上须含非目标、缺点、不作为的代价、负责人与日期。部分论断已被证伪,不应引用;LLM-as-judge与ALCE引用质量数据未经验证,AI生成技术文档质量基准尚未确立。