SuperAPI AI 工具集

lld-writer

通用与其它

查看项目

更新于 10-16 04:56

技能介绍

用途:把 HLD/Contract 的决策细化为可实现的低层设计(LLD),确保不漏关键工程约束;也用于既有相关文档在授权范围内的有限增量更新。

主要能力:模块化组合模板,LLD = Core + Add-ons + Profile + Guardrails;按能力触发 API/Storage/Async/Infra/Observability 等 Add-on;正式设计产出 LLD 文档、LLD Manifest 和追溯映射表;内嵌 TRACEABILITY-METADATA(lld-profile-v1)做需求到设计的追溯;执行一致性自检(PRD 覆盖 100%、HLD 承接、Contract 一致、Guardrails 覆盖、复用检查)。

使用方式:先选工作模式——formal_design(完整新功能文档)或 bounded_change(有限增量)。正式流程分三阶段:Phase 0 收集 PRD/HLD/Contract/Guardrails/ADR 基线并做 Guardrails trigger check;Phase 1 选 Profile、识别触发模块、确认 Add-ons、生成 Manifest 初稿;Phase 2 以 lld-core-template 组装文档、填写追溯映射表;Phase 3 自检。写入文件后运行命令:python3 "$TESTANY_ENG_ROOT/scripts/trace_lint.py" --format json <LLD 路径>,blocking issue 必须修正。

适用场景:订单服务等后端模块 LLD(含 Storage/Async/Observability);前端模块 LLD(路由/状态/错误态,引用现有 API Contract)。

限制:LLD 只能细化,不得新增 HLD 未定义的边界或服务,不得重定义接口,错误码须与 Contract 一致;不得包含业务 Why(PRD)、系统级架构决策(HLD)或完整代码;技术现状不明时须先取证并提问,不得猜测;语言默认跟随用户输入,但 TRACEABILITY-METADATA 字段名、枚举值、ID 与 comment markers 保持英文。具体安装与依赖细节暂未提供。