القائمة
用于对本仓库 PR、commit、diff 或代码变更做 AI Code Review；当用户要求 review PR、review commit、review diff、代码审查、CR 规范检查、AI CR 或检查变更是否符合 QuantAgent 模块边界时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ai-code-review |
| description | 用于对本仓库 PR、commit、diff 或代码变更做 AI Code Review；当用户要求 review PR、review commit、review diff、代码审查、CR 规范检查、AI CR 或检查变更是否符合 QuantAgent 模块边界时使用。 |
| license | Proprietary |
| compatibility | {"agent":"*"} |
| metadata | {"language":"zh-CN","scope":"ai-code-review","repo":"BqLee-AI/QuantAgent"} |
这个 skill 用来主动审查 QuantAgent 的代码变更。它不是通用语言 checklist，也不是替代维护者判断的自动结论。
目标是让 review 基于本仓库真源、当前 diff 和模块 reference，找出真实 bug、架构边界破坏、安全风险、契约漂移、测试缺口和需要维护者讨论的设计问题。
AGENTS.mdAGENTS.md.agents/skills/references/engineering-quality-gate.mdapps/web/** 时，先读 .agents/skills/references/web-architecture-gate.md；复杂 feature、route、shared 能力或文件拆分还要读 .agents/skills/references/web-file-responsibility-and-feature-structure.md；再读本 skill 的 Web review referenceapps/api/** 时，先读 .agents/skills/references/api-architecture-gate.mdpackages/core/**、packages/plugin-sdk/** 或 plugins/** 时，先读 .agents/skills/references/core-and-plugin-architecture-gate.mdapps/web/**：读 references/web/overview.mdapps/api/**：读 references/api/overview.mdpackages/core/**：读 references/core/overview.mdapps/api/** 与 packages/core/**，必须同时加载 API 与 core overview；再按 overview 的场景索引选择细则，不用当前实现替代目标边界。references/shared/review-output.md不要一次性加载所有模块细则。先用 changed files、imports、调用形态和 diff 内容选择相关 reference。
::code-comment{...}。must-fix：真实 bug、安全问题、契约破坏、仓库红线、关键测试缺口、会导致运行或审计失败的问题。should-fix：范围内、成本低、证据充分的质量问题。needs-discussion：会改变范围、设计、package 边界、OpenSpec、长期规则或验收口径的问题。defer：有价值但超出当前 PR，应进入后续 issue / change。not-applicable：通用建议不适用于当前仓库、当前版本、当前非目标或被现有设计明确排除。不要因为发现“可以更好”就输出 finding。Code Review 优先报告会影响正确性、边界、安全、契约、可维护性或验证可信度的问题。
默认输出普通 Markdown，不输出 JSON、XML、findings object 或其他结构化 review schema。
每条 finding 必须包含：
must-fix / should-fix / needs-discussion / defer / not-applicableAGENTS.md、路径级 AGENTS.md、design、OpenSpec、issue、reference 或现有代码模式如果没有 finding，明确说“未发现必须修改的问题”，并说明仍未覆盖的范围或未运行的验证。
只有当反馈需要直接贴到 changed line 时，才发出 ::code-comment{...} inline comment 指令。没有可行动行级意见时，不要发任何 inline comment 指令。
references/shared/review-output.md.agents/skills/references/web-architecture-gate.md.agents/skills/references/web-file-responsibility-and-feature-structure.mdreferences/web/overview.mdreferences/api/overview.md.agents/skills/references/api-architecture-gate.mdreferences/core/overview.md.agents/skills/references/core-and-plugin-architecture-gate.md未来新增模块时，只在对应 overview 里加入导航，不把细则塞回 SKILL.md。
gh-pr-comments。AGENTS.md、docs/design/、OpenSpec 或后续 issue。当 evidence_research_analyst 检索公开来源并压缩半导体事件证据时使用。
当半导体 MainAgent 需要分析已路由事件对 AI GPU、HBM、晶圆代工、设备、存储、供应链和风险的影响时使用。
按 QuantAgent OpenSpec change 实施任务。用户要求开始实现、继续实现、推进 tasks、或基于已审核 OpenSpec 写代码时使用；实现前会检查中文 artifacts、工程质量 gate 和 strict validate 状态。
归档已完成的 QuantAgent OpenSpec change，并在归档前检查 artifacts、tasks、delta spec 同步和中文/英文语法边界。用户要求 finalize、archive、归档 change 或同步 stable spec 时使用。
OpenSpec 探索模式，用于在创建或实施 change 前后澄清需求、调查代码、比较方案和沉淀决策；如需写入 OpenSpec artifacts，默认生成中文正文并保留英文校验语法。
为 QuantAgent 创建新的 OpenSpec change，并一次性生成可评审、可校验、可实施的 proposal、design、specs 和 tasks。用户要求提 proposal、创建 change、生成 OpenSpec、规划行为/架构/契约变更时使用。