RyanJson/skills/ryanjson-optimization/references/geminiCompat.md

Gemini 兼容说明（优化类任务）

范围

• 本页只定义 Gemini 在优化任务中的输入/输出结构。
• 优化流程与门禁口径以 coreWorkflow.md、regressionGates.md 为准。

推荐输入模板

• 背景：当前失败日志或性能瓶颈。
• 目标：先修正确性/再做性能 或 先性能/再验证。
• 约束：不新增额外内存、不改 API、测试文件归档规则。
• 验收：需要通过的测试与覆盖率证据。

推荐输出结构

1. 风险分级（P0/P1/P2）。
2. 最小改动方案（文件 + 函数 + 预期行为）。
3. 验证步骤（命令 + 预期）。
4. 残余风险与下一步。

字段组织可直接复用 optimizationTemplate.md。

禁止输出模式

• 只给“建议”不给落地步骤。
• 忽略失败路径与释放语义。
• 不区分“已验证”与“推断”。

跨模型对齐真值

• API 与头文件注释优先于模型记忆。
• 覆盖率必须看分支双向触达。
• assert 只能用于不可恢复内部破坏场景。

术语字典（统一）

• 本文术语统一以 terminology.md 为准。