名称: 开发 描述: 探索、开发、编辑和重构代码的通用原则。用于代码库分析、实现任务和代码质量改进。
开发技能
核心原则
- 代码整洁: 遵循可读、可维护的模式。
- 尽早失败: 永远不要静默捕获意外异常;让它们向上冒泡。
- 简洁性: 优先选择最简单的可行方案。
规划
对于非琐碎的变更:
- 提出一个计划,包含至少3个澄清性问题(以及建议的答案)。
- 在实施前等待明确批准。
- 对于复杂策略,使用
plan技能。
实施与 Git
Git 安全
- 权限优先: 在初始化仓库或切换分支前始终询问。
- 原子提交: 将相关变更按逻辑分组。
代码质量
- 关注 WHY: 记录意图,而非机制。
- 边界情况: 考虑并测试错误场景。
- 现有风格: 匹配现有模式和格式。
语言特定参考
当使用特定语言时,请参考以下资料:
- Python: 参考
references/python.md。
文件操作
- 首选
edit_file: 用于针对性更改;避免重写整个文件。 - 验证: 编辑后始终验证更改。
- 工具: 使用
fd和rg进行探索;使用标准 shell 工具进行导航。