Addy Osmani

为生产功能设计日志、指标、跨服务追踪和告警，记录请求标识与处理起点，并验证实际输出和通知，帮助了解运行状态及故障原因。

• 完善生产功能的监控信息
• 关联不同服务的日志
• 审查告警与响应操作手册

将模糊想法整理为明确目标、工作范围和验收条件的规格文档，梳理多个功能的划分与依赖，并经人工审批逐步进入规划、任务拆分和实现。

• 在实现前明确想法
• 编写包含验收条件的需求文档
• 将大型需求拆分为独立功能

在生产发布前检查质量、安全、性能、无障碍和基础设施，准备监控与回滚方案，并根据发布后的检查结果、运行指标和可靠性目标逐步扩大开放范围。

• 检查首次生产发布的准备情况
• 规划重大功能的分阶段发布
• 整理监控项目与发布后检查步骤

通过逐一提问澄清模糊需求，同时展示智能体对用户意图的推测，梳理受众、目的、成功标准、限制和不包含的内容，最终形成经用户明确确认的意图说明。

• 澄清模糊需求背后的目的
• 梳理受众和成功标准
• 确定难以兼顾的需求的优先级

在保持行为不变的前提下，整理深层条件分支、长函数、重复逻辑和含糊命名。先检查现有规范与测试，再以可读性为标准逐步修改。

• 改善已正常运行功能的代码可读性
• 处理代码审查指出的复杂逻辑
• 整理深层条件分支和长函数

将混杂的代码改动按目的拆成提交，协助管理分支和准备拉取请求，并根据兼容性变化整理版本号、标签和变更日志，同时检查提交内容。

• 将混杂改动拆成独立提交
• 准备供审查的分支和拉取请求
• 用 git worktree 分离并行工作

根据开发任务选择合适的技能及使用顺序，梳理从需求明确、规格编写到实现、测试和发布的流程，同时提供说明前提、解决疑问、控制范围及验证结果的共通规则。

• 开发开始时选择所需技能
• 梳理新功能的工作流程
• 选择缺陷修复与审查步骤

从判断旧API或功能是否应停用，到分阶段迁移至替代方案、确认使用情况并删除旧实现，梳理完整流程。生产数据库的列变更也按新旧代码可共存的步骤推进。

• 从旧API迁移至替代API
• 制定不再需要的功能的停用计划
• 分阶段修改生产数据库列名

在合并前从正确性、可读性、架构、安全和性能五个维度审查代码变更，检查测试是否恰当，区分必须修复的问题与可选建议，并提出具体改进方法。

• 合并前审查拉取请求
• 检查人工智能编写的代码
• 评估重构是否带来改善

按复现、定位和最小化的顺序排查测试失败、构建错误及异常行为，修复根本原因，并添加回归测试以防止同类问题再次发生。

• 排查代码修改后的测试失败
• 调查构建错误的原因
• 排查停止工作的功能

将规格说明或需求拆分为带有完成标准和验证方法的小型实现任务，梳理依赖关系、执行顺序及检查节点，并保存为计划文档和任务清单。

• 把大型功能拆分为实现任务
• 按依赖关系安排执行顺序
• 明确完成标准和验证方法

检查项目所用框架和库的版本，依据对应的官方文档实现代码，为设计决策提供来源链接，并标明已弃用的 API、未验证的方法及与现有代码的冲突。

• 依据所用版本的官方文档核对实现
• 创建附有来源的代码模板
• 检查代码是否使用已弃用的 API

在实现前定义 API 和模块之间的输入输出，统一命名、错误格式与输入校验，并考虑现有调用方的兼容性及重试造成的重复处理。

• 设计新的 REST API
• 定义界面与服务器的数据规范
• 在保持兼容的前提下扩展 API

为新功能和缺陷修复先编写失败测试，再以最少代码实现通过并整理代码。反复验证预期行为及对现有功能的影响，遵循项目已有测试工具与约定。

• 先写测试再实现功能
• 复现并修复已报告的缺陷
• 修改代码时验证现有行为

通过测量定位页面显示、交互、API和数据库的性能瓶颈，对比修改前后的数据验证效果。撤销没有明确收益的修改，并添加性能检查与监控，防止再次变慢。

• 调查页面加载和交互迟缓的原因
• 减少API延迟与重复查询
• 检查修改后的性能下降

遵循现有设计体系，实现适用于手机到大屏幕的界面。整理组件结构与状态管理，支持键盘操作和屏幕阅读器，并完善加载中、无数据及错误状态的显示。

• 创建新页面或界面组件
• 调整手机和电脑上的显示
• 改善键盘及屏幕阅读器支持

记录软件设计决策的理由及比较过的方案，整理README、API文档和变更日志，帮助后来加入的成员与AI智能体理解实现背景。

• 记录设计决策和未采用方案
• 记录公开API的变更
• 完善README的启动步骤

检查Web应用的输入处理、身份验证和外部集成，梳理漏洞应对措施，并涵盖依赖包、个人信息及LLM输出的处理方式。

• 检查登录流程和访问权限
• 检查文件上传与外部API集成
• 发布前审计依赖包

将跨多个文件的功能开发和改造拆成可验证的小步骤，反复进行实现、测试、验证与提交，让系统在每个阶段都保持可运行状态。

• 实现跨多个文件的功能
• 开始计划中的下一项任务
• 通过功能开关隐藏未完成功能后集成

按任务整理提供给AI智能体的规则、规范和相关代码，选择所需文件与实现示例，汇总长对话，并记录决定、验证结果和待办问题以交接到新会话。

• 整理AI辅助开发的规则
• 选择任务所需文件
• 整理长对话中的信息

在真实浏览器中验证页面显示与操作，检查错误、网络通信和加载速度，并比较修复前后的截图、确认无障碍支持。

• 排查布局与样式问题
• 检查浏览器错误与API通信
• 比较修复前后的页面

将项目质量标准及其数值、理由和检查方法写入文档，并从差异中检查跳过测试、抑制警告或降低门槛的改动，维持智能体开发质量。

• 制定智能体开发的质量标准
• 选择覆盖率与性能目标
• 发现跳过测试或抑制警告

将设计或实现中的重要决策交给不继承工作过程的独立审查者验证，找出隐藏前提和失败条件，再据此修正问题或重新评估决策。

• 验证设计方案的前提
• 检查陌生代码中的决策
• 审查认证与敏感处理逻辑

自动执行代码变更后的测试、类型检查和构建，建立发布前的质量检查流程。涵盖GitHub Actions配置、分阶段发布和回滚步骤，也介绍失败排查与运行提速。

• 为新项目引入CI
• 自动执行测试和质量检查
• 设计分阶段发布与回滚流程