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

公众号/自媒体文章全流程：选题→正文→封面→风格

写公众号文章时按选题定调→正文结构→风格统一→封面配图推进，别只写正文忽略标题和封面。

开发任务五步法：需求→设计→实现→审查→修复

接到开发任务时按五阶段推进，每阶段有明确交付物，避免上来就写代码导致返工。

长任务/构建：先验证依赖与环境，再跑主流程

跑打包、构建、部署这类长任务前，先确认依赖、凭据、磁盘空间、目标环境可用，避免跑到一半失败浪费时间。

接口返回新字段≠功能完成：前后端数据要对齐

后端接口加了新字段不代表功能做完了。凡是要给用户看的数据，必须同步确认前端真的展示出来，且口径和后端一致。

生产环境操作：先评估影响，备好回退再动手

在生产环境改配置、重启服务、清数据前，先评估影响面、备好回退方案。临时止血手段要清楚副作用。

排查问题先收证据再动手：日志/状态/复现路径

遇到任何线上报错或异常，别急着改配置重启。先把证据收集全（报错原文、相关状态、能否复现），再定位根因，避免越修越乱。

写 skill/工具的 description：写清「何时触…

给 agent 写技能/工具时，description 是唯一的触发机制。写得太保守（只描述功能不写触发场景），agent 会「该用时不用」。

AI 生成前端/页面：避开 5 个一眼假的「模板套路」

AI 生成的网页设计容易撞几个固定套路，一眼被看出是 AI 做的。要做有辨识度的设计就得刻意避开这些默认选项。

MCP/工具报错消息要「可操作」，别只丢错误码

写 MCP server 或给 agent 用的工具时，报错消息如果只回 'error 500' 或一个堆栈，agent 没法自救。好的错误消息要告诉调用方「怎么修」。

Playwright 测动态网页：先等…

用 Playwright 自动化测试/抓取动态网页（React/Vue 等 JS 渲染）时，页面加载完成 ≠ DOM 就绪。没等 JS 执行完就去读元素，会拿到空 DOM 或找不到选择器。

多方合同利润点统一基数分配法

多方合同结构中，各方利润点必须以统一基数计算，再用总盘校验确保各方利润之和等于可分配空间。

整理商务费用并生成报销、差旅和月度汇总报告时使用…

当你需要把收据、交易或费用描述整理成可报销、可报税或可做预算跟踪的费用报告时使用。

写 PR 正文时用：用 Summary、Evidence…

在创建或编辑 Pull Request 正文时，按模板组织变更摘要、前后证据和合并风险。

构建基础设施模块后验证接线：从入口到执行路径确认没有死代码

新增或重构基础设施组件（模块、脚本、hook、路由）后，用于确认它们确实被入口调用并能端到端执行，避免死代码和虚假完成感。

在浏览器中开发 WebGL2 着色器与 GPU 特效时…

适用于用 WebGL2 实现自定义着色器、后处理、粒子或实时数据可视化，并需要处理 GPU 安全、资源管理、性能预算和降级的场景。