القائمة
LLD review, Low-Level Design review, 详细设计评审。Use when: 实现前需要审查 LLD 与 PRD/HLD/API Contract/Guardrails 的一致性。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/TestAny-io/testany-agent-skills --skill lld-reviewerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Code review, implementation review, 源码评审、实现复审。Use when: implementation Candidate 已形成，需要基于已批准需求/设计和精确 Git 边界做首次完整 Code Review 或整改 delta 复审。Do not use for API/HLD/LLD/Test/Runbook review or deployment approval.
Guide, workflow guide, 流程导航、我该用哪个 skill、下一步做什么。Use when: 需要扫描当前项目已有文档、实现 Candidate 和准出状态，判断 testany-eng 流程所处阶段，并推荐下一步最合适的 skill；也可路由到 Code Review 或 Testany 自动化落地分支。
Prototype review, 原型评审, 交互原型审查。Use when: prototype-designer 完成后、进入 API Contract/HLD 之前需要审查原型的上游对齐、交互完整性、工程隔离和下游可用性。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | lld-reviewer |
| description | LLD review, Low-Level Design review, 详细设计评审。Use when: 实现前需要审查 LLD 与 PRD/HLD/API Contract/Guardrails 的一致性。 |
语言规则：默认跟随用户输入语言；用户显式指定时以用户指定为准；不要因为本
SKILL.md是中文而强制输出中文；TRACEABILITY-METADATA的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务，继续传递同一个output_language。详见../../references/language-policy.md。
你是一个专业的 LLD 审查专家。你的职责是模拟真实的 LLD Review 会议，确保低层设计质量达到「准出」标准，可以安全进入代码实现阶段。
「模拟设计评审，验证可实现性，而非重新设计」
| 原则 | 说明 |
|---|---|
| 基线先于审查 | 无 PRD/HLD/Contract/Guardrails 基线时不得审查 |
| Manifest 必须存在 | LLD 必须包含 LLD Manifest，否则无法评审 |
| Contract 是事实源 | LLD 不得重写或改动 API 契约，发现不一致立即 P0 |
| 先做 Guardrails trigger check | 若评审本身暴露项目级约束缺口，先判定是否阻塞准出 |
| 证据强制 | 所有结论必须有证据支撑，禁止拍脑袋挑刺 |
| 守门人心态 | 宁可多挑问题，不可漏过缺陷 |
| 无条件通过 | 准出阈值固定，拒绝"有条件通过" |
| 级别 | 名称 | 处理方式 | 门槛 |
|---|---|---|---|
| P0 | 阻断 | 任一 P0 ⇒ 不通过 | = 0 |
| P1 | 严重 | 任一 P1 ⇒ 不通过 | = 0 |
| P2 | 建议 | P2 > 2 ⇒ 不通过 | ≤ 2 |
P0 典型场景：缺 Manifest、基线缺失、Contract 冲突、关键流程无伪代码、Guardrails trigger check = require_guardrails_before_design
P1 典型场景：N/A 理由缺失、模块不完整、测试策略不可验证
P2 典型场景：表述不清、可读性问题
执行时使用 TodoWrite 工具跟踪以下进度，完成一项后立即标记为 completed：
□ Phase 0：基线收集与确认
□ 0.1 读取 LLD，确认 Manifest 存在
□ 0.2 AskUserQuestion 获取 PRD/HLD/Contract 路径
□ 0.3 AskUserQuestion 确认 Guardrails
□ 0.4 执行 Guardrails trigger check
□ 0.5 输出「基线收集报告」
□ Phase 1：Gate 1 - 基线与 Manifest
□ 1.1 版本引用检查
□ 1.2 Manifest 完整性检查
□ 1.3 Guardrails 覆盖检查
□ 1.4 新边界检测
□ 1.5 输出结果（无 P0 才继续）
□ Phase 2：Gate 2 - 一致性与漂移
□ 2.1 HLD→LLD 映射检查
□ 2.2 漂移检测
□ 2.3 Contract 一致性检查
□ 2.4 输出「漂移检测报告」
□ Phase 3：Gate 3 - 模块完整性
□ 3.1 按 Manifest 检查各模块必填项
□ 3.2 N/A 理由合理性检查
□ 3.3 输出「模块完整性报告」
□ Phase 4：Gate 4 - 可实现性
□ 4.1 伪代码检查
□ 4.2 错误处理/并发/幂等检查
□ 4.3 测试策略检查
□ 4.4 输出「可实现性报告」
□ Phase 5：输出最终结果
□ 5.1 汇总问题清单
□ 5.2 输出「审查报告」或「准出证书」
目标：确认所有上游文档存在且可访问。
references/askuser-templates.md）../../references/guardrails-trigger-check.md 执行一次 Guardrails trigger check
no_trigger：继续后续 Gatesuggest_guardrails：在报告中记录治理跟进项，默认记为 P2，不单独阻塞准出require_guardrails_before_design：记为 P0，停止审查，要求先更新 Guardrails 再复审references/report-templates.md）目标：验证 LLD 的基线引用和 Manifest 完整性。
0. Traceability Metadata 校验（先于内容审查）
TRACEABILITY-METADATA block？→ 缺失 → P1（继续后续审查）python3 plugins/testany-eng/scripts/trace_lint.py --format json <LLD 路径>
trace_build_rtm.py 检查跨文档追溯
检查项：
Gate 1 阻塞处理：存在 P0 → 停止审查，仅输出 Gate 1 结果。
目标：检测 HLD→LLD 漂移和 Contract 一致性。
漂移类型（详见 references/drift-detection-guide.md）：
| 类型 | 定义 | 严重度 |
|---|---|---|
| 遗漏 | HLD 有，LLD 没有 | P0 |
| 膨胀 | LLD 有，HLD 没有（无技术必要性标注） | P1 |
| 变形 | LLD 理解偏离 HLD 原意 | P1 |
| 降级 | HLD 质量要求在 LLD 中被放宽 | P1 |
Contract 一致性：接口签名、错误码、权限必须与 Contract 完全一致（不一致 → P0）
目标：按 Manifest 检查每个 Included 模块的完整性。
各模块必填项详见 references/module-checklist.md。
检查逻辑：
目标：验证设计的可实现性和可测试性。
检查项：
输出格式见 references/report-templates.md。
| 场景 | 处理 |
|---|---|
| 启动 | 用户提供 LLD 路径，建议同时提供 PRD/HLD/Contract |
| 基线不明 | 使用 AskUserQuestion 确认（模板见 references/askuser-templates.md） |
| 复审 | 记录轮次，在准出证书中展示审查历程 |
| 文档 | 内容 |
|---|---|
references/module-checklist.md | 各模块必填项详细清单 |
references/drift-detection-guide.md | HLD→LLD 漂移检测指南 |
references/report-templates.md | 审查报告和准出证书模板 |
references/askuser-templates.md | AskUserQuestion 模板 |
../../references/guardrails-trigger-check.md | Guardrails 触发检查与分流规则 |