开发技能 develop

开发技能是一套用于代码开发、分析与重构的通用原则与最佳实践指南。它强调代码整洁、尽早失败、简洁性等核心原则,并提供从规划、实施到代码质量控制的完整流程指导。关键词:代码开发,代码重构,代码质量,Git操作,编程规范,软件开发流程,代码维护。

架构设计 0 次安装 0 次浏览 更新于 2/28/2026

名称: 开发 描述: 探索、开发、编辑和重构代码的通用原则。用于代码库分析、实现任务和代码质量改进。

开发技能

核心原则

  • 代码整洁: 遵循可读、可维护的模式。
  • 尽早失败: 永远不要静默捕获意外异常;让它们向上冒泡。
  • 简洁性: 优先选择最简单的可行方案。

规划

对于非琐碎的变更:

  • 提出一个计划,包含至少3个澄清性问题(以及建议的答案)。
  • 在实施前等待明确批准
  • 对于复杂策略,使用 plan 技能。

实施与 Git

Git 安全

  • 权限优先: 在初始化仓库或切换分支前始终询问。
  • 原子提交: 将相关变更按逻辑分组。

代码质量

  • 关注 WHY: 记录意图,而非机制。
  • 边界情况: 考虑并测试错误场景。
  • 现有风格: 匹配现有模式和格式。

语言特定参考

当使用特定语言时,请参考以下资料:

  • Python: 参考 references/python.md

文件操作

  • 首选 edit_file: 用于针对性更改;避免重写整个文件。
  • 验证: 编辑后始终验证更改。
  • 工具: 使用 fdrg 进行探索;使用标准 shell 工具进行导航。