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

设计或重构后端服务时用整洁架构、六边形架构与 DDD…

在从零设计微服务、重构单体、划分限界上下文或排查分层依赖环时，落地 Clean/Hexagonal/DDD 架构模式。

学术写作中如何验证引用真实性并防止伪造引用

在撰写学术论文需要添加引用时，通过权威来源主动核实每条文献的真实性与元数据准确性。

用 JUnit 5 单元测试 Jakarta Bean…

在编写 DTO/请求对象的 Bean Validation 单元测试、自定义 @Constraint 校验器测试或跨字段校验测试时，用纯 JUnit 5 + Hibernate Validator 快速验证约束违规。

变更完成后归档提案并把规格增量合并进活文档时用

当变更已部署、任务全部完成，需要把 change 的 spec delta（ADDED/MODIFIED/REMOVED）合并进 living spec 并归档变更文件夹时使用。

首次使用 QA 技能前建立项目质量上下文文件…

在项目根目录创建并填充 .agents/qa-project-context.md，记录技术栈、测试框架、CI/CD、环境、质量目标、风险区域、团队与约定，供所有 QA 技能读取。

用 MSBuild 二进制日志诊断构建失败（含 MCP…

当控制台输出无法解释 MSBuild 构建错误、需要排查多项目级联失败或追踪目标执行顺序时，从已有 .binlog 文件定位根因。

当 C#/.NET 测试因…

为需要控制时间、文件、环境、随机等环境依赖的 C#/.NET 行为引入最小且保持行为不变的生产接缝，并编写确定性测试同时验证行为与接缝。

实现错误处理、设计API或提升应用可靠性时…

在开发新功能、设计容错API或排查生产问题时，系统化地处理可恢复与不可恢复错误并避免常见陷阱。

当测试需要覆盖整个输入域而非手选样例时…

在代码具有代数形状（逆运算、不变量、oracle）时，用生成器搜索反例来替代逐例断言。

在代码审查中做极严格的可维护性审计：消除复杂分支…

对当前分支的改动进行深度代码质量审计，主动寻找能大幅简化结构、删除复杂度而非重排复杂度的重构机会。

在 Terraform Provider 中把资源从…

当需要将 Terraform provider 的 SDKv2 资源/数据源迁移到 Plugin Framework，或搭建 mux 双插件服务器、排查迁移后 plan diff 与 state 错误时使用。

给已写好的邮件加个性化时，如何映射合并标签…

在已有邮件文案和分群基础上，为每个合并标签绑定真实导出列并设置兜底值，定义按分群变化的条件内容块，审计空字段/死条件渲染并守住 PII 边界。

在项目缺少书面质量标准、或 AI…

当项目没有成文质量门槛、用户要求设定约束/质量门禁，或代理反复用跳过测试、加抑制注释等方式蒙混过关时，通过访谈+默认值+CONSTRAINTS.md 把质量标准固化成可执行检查。

MSBuild 复制到输出目录模式选择：避免 Always…

在 MSBuild/.NET 项目中为 Content/None/EmbeddedResource/Compile 项选择 CopyToOutputDirectory（及 CopyToPublishDirectory）模式，以消除 Always 的每次构建性能损耗，并在构建间重置被修改的输出文件。

用 Impact × Risk…

当你有一堆产品/业务假设需要决定先验证哪些时，用 Impact × Risk 矩阵分类并给出对应实验。