开发技能

按Conventional Commits格式生成简短的提交消息，说明代码变更意图，并为破坏兼容性的变更、迁移等情况补充正文背景。

• 为代码变更编写提交消息
• 统一提交消息格式
• 记录不兼容变更和迁移步骤

在修改代码前调查原因不明的故障、间歇性异常和性能下降，区分实测症状与推测，依据证据筛选原因假设，并报告原因及其依据。

• 调查原因不明的故障
• 查找间歇性异常的原因
• 定位性能下降的原因

将代码定位、一至两个文件的修改和差异审查分配给专门的辅助智能体，以简短的结构化格式接收结果，减少主智能体的上下文占用。

• 查找定义和调用位置
• 限定在一至两个文件内修改
• 审查代码差异中的缺陷

利用现有代码结构，在必要范围内实现新功能或外部集成。先明确可验证的完成条件和不包含的内容，再贯通相关层级，完成整套运行流程。

• 在明确范围内实现新功能
• 利用现有结构接入外部服务
• 明确完成条件与不包含的内容

按具体工作梳理代码中使用大语言模型的流程，先提出用途标签方案，获批后再添加标签，便于在 Caveman Cloud 中按流程分别查看费用。

• 按具体工作了解模型费用
• 盘点接口和定时任务的模型使用
• 单独统计评估流程的费用

审查代码差异，通常用一行写明行号、问题和具体修改建议，区分缺陷、风险、细微建议与问题，生成便于粘贴到PR的评论。

• 审查PR中的代码差异
• 缩短冗长的审查评论
• 为问题附上具体修改建议

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

调查并修复 Paperclip 中缓慢的 PostgreSQL 查询，在本地复现问题，比较修复前后的速度、结果和权限范围，并整理为通过测试、可供审查的拉取请求。

• 调查疑似由数据库引起的响应延迟
• 降低频繁执行的查询负载
• 比较修复前后的速度与结果

设计并验证Dot等外部机器人与Paperclip的双向工作连接，涵盖邀请、权限、结果保存、重启恢复及Cloud部署，并在真实账户和实际部署环境中确认运行情况。

• 与外部机器人双向协作
• 构建邀请及连接设置界面
• 验证重启和重复通知后的恢复

将Paperclip的Storybook界面示例与实际产品及功能清单对照，整理数据、分类和引用，保留示例标识与链接，并区分当前功能示例、原型和历史探索。

• 在界面变更后维护展示示例
• 更新模拟数据与API响应
• 分类原型和历史界面示例