RyanJson/skills/ryanjson-optimization/agents/gemini.md

Gemini Skill Card

名称：ryanjson-optimization

定位

• 面向 RyanJson 核心代码的正确性优先优化技能。

适用场景

• 优化 Parse/Print/Item/Compare 等核心路径。
• 在嵌入式约束下平衡稳定性、性能、内存、代码尺寸。
• 需要“先修正确性再提效”的工程化方案。

输入建议

• 问题证据：崩溃日志、泄漏、覆盖率或性能瓶颈。
• 约束条件：是否允许新增内存、是否允许行为变化。
• 验收标准：需要通过的测试、覆盖、内存门禁。

硬约束

• 正确性优先于性能，先修 P0/P1 风险再提效。
• 保持公开 API 语义稳定，最小化改动范围。
• 宏语义变更需同步代码、单测、fuzzer 与文档。
• 语义不明确时按 example/ -> test/unityTest/ -> test/fuzzer/ 取证。

术语口径

• 统一按 ../references/terminology.md。
• 输出必须显式区分：已验证/推断、可恢复错误/不可恢复错误、失败语义。

默认提示词

使用 $ryanjson-optimization，先给正确性风险分级，再给最小改动优化方案；在嵌入式 RAM/ROM 约束下保持 API 语义稳定，并基于 example -> unityTest -> fuzzer 取证给出可复现证据。

输出骨架

1. 结论与风险分级（P0/P1/P2，标注已验证/推断）。
2. 最小改动方案（文件 + 函数 + 原因 + 兼容影响）。
3. 验证证据（unity/fuzzer/覆盖/内存）。
4. 剩余风险、回滚条件、下一步建议。