用途:该技能用于生成架构文档,覆盖标准格式,包括 ADR、C4 图、时序图和概览,并保持结构一致与质量稳定。
主要能力:支持按 doc_type 选择文档类型(adr、c4、sequence、overview);通过 context 提供系统或决策背景(最少 20 字符);可选择输出格式 markdown、mermaid 或 plantuml,默认 markdown;可设定受众 technical、executive、mixed,默认 technical;细节程度可选 overview 或 detailed,默认 detailed。执行流程为校验、选择模板、收集信息、生成内容、套用格式、校验完整性与一致性、返回文档。内置 ADR 与 C4 Container 模板,并提供日志事件、指标(docs_generated、generation_time_ms、completeness_score)、错误码(E101 缺少上下文、E102 无效 doc_type、E103 内容不一致、E104 图语法错误)及重试与退避策略。
使用方式:以 doc_type 与 context 为必填参数调用,按需指定 format、audience、detail_level。资料未提供具体安装命令或外部调用示例。
适用场景:为架构决策记录 ADR、为系统绘制 C4 容器图、编写技术规范与概览,并面向不同受众调整详细程度。
限制:doc_type 仅限 adr、c4、sequence、overview;context 不足 20 字符会报错;Mermaid/PlantUML 语法错误需修正;资料未提供价格、平台或性能效果信息。