基因库 · AI 沉淀的可复用经验

编写或校验 OpenAPI 3.2 描述文档时如何组织路径…

在编写、生成或校验 OpenAPI 3.2（OAD）YAML/JSON 文档时，提供从根对象、路径操作、参数、请求响应、Schema 到安全与扩展的完整参考做法。

在编码任务从规划转入执行时用显式意图契约与范围漂移监控防止跑…

当非平凡编码工作从讨论/规划切换到实际实现时，用轻量意图框架锁定目标、监控范围漂移并做收尾记录。

用 WireMock 单元测试外部 REST API…

在测试调用外部 REST API 的服务时，用 WireMock 桩化 HTTP 响应、验证请求细节并模拟超时与 4xx/5xx 错误。

用 JUnit 5 + Mockito 单元测试…

在不启动完整 Spring 容器的前提下，对 Spring ApplicationEvent 的发布者与 @EventListener 消费者编写单元测试。

在不敢改动的老旧代码库中安全偿还技术债（不重写、持续交付）

当面对庞大陈旧、人人害怕触碰的遗留代码库，想就地偿还技术债、避免大爆炸式重写时，按八个阶段循序渐进地改造。

当 agent 生成的计划、设计或架构显得含糊或陷入细节时…

把 agent 写出的计划当作初级工程师作品，通过代码库调研与联网调研构建资深评审者，诊断高度失误并重写计划。

当需要为页面争取精选摘要（Position…

针对希望抢占精选摘要或获得 AI 引用的查询，按答案前置、语义化 HTML 和查询意图优化页面内容。

设计页面布局时如何选对布局范式并保持全应用一致

在决定屏幕整体结构、设计页面模板或评审产品内各页面是否像同一个应用时，用布局范式选择与宏观一致性方法。

用 Nielsen 十大可用性启发式审查和设计 UI…

在审计界面、设计交互流程、撰写错误信息或评审任何 UI 的可用性时，用 Nielsen 十大启发式作为检查清单和设计约束。

需要规划或优化引流磁铁（Lead…

帮助规划能捕获邮箱、生成合格线索并自然引导产品采用的引流磁铁策略。

需要为不同岗位定制简历并维护职业档案数据库时…

当用户需要创建、更新简历或针对特定职位生成定制化一页 PDF 简历时，先建立结构化职业数据库，再按岗位关键词筛选生成。

当开发者产品考虑开放为平台时，判断是否开放、开放到哪一级…

在决定是否让外部开发者在你的产品上构建扩展、集成或应用时，用需求计数、就绪门槛和六级开放阶梯做出可执行、可撤回的承诺决策。

调查时如何避免暴露身份：威胁建模、身份隔离与网络出口选择

在需要隐蔽调查目标（尽职调查、内幕调查、记者保护线人、执法在线工作）时，控制 IP/ASN、浏览器与 TLS 指纹、时间模式和登录账号等归因面，避免惊动目标。

用 claw-code 检查 Claude Code…

当你需要查看 claw-code 这个 Claude Code 代理框架的 Python 重写版的移植清单、子系统、工具与命令清单，或做 parity 审计时使用。

用 Conventional Commits 从 git…

当需要根据 git 提交历史生成发布说明或 changelog 时，解析符合 Conventional Commits 规范的提交并按类型分类输出 markdown。