用途:该技能是仓库工程哲学的安装版,供智能体在任何编程相关工作开始前加载,包括写代码、修 bug、调试、规划架构、设计 API 等;应在架构、实现、调试、测试、代码审查、安全、性能、CI/CD、发布、项目初始化等更具体技能之前使用。原则按规模判断,小改动无需重仪式,但仍继承显式、边界校验、可信检查、清晰架构和简单可读代码等默认做法。
主要能力:一是“成功的坑”,通过静态分析、linter、按结构分离关注点的架构和强制调用者处理错误的错误处理,让正确做法成为阻力最小的路径。二是显式优于猜测,类型在运行前已知,错误是值而非异常,外部边界数据立即解码收窄,弱类型第三方库用类型化包装。三是快速失败、尽早失败,在入口校验前置条件,禁止 any、强制转换和无说明的抑制。四是错误处理即控制流,预期失败用 Result/Either,编程错误用异常,第三方错误立即转换为 Result,边界层捕获剩余错误并给出用户友好信息。五是测试哲学,以可信度而非覆盖率为目标,集成/e2e 测试为主安全网,纯逻辑做单元测试,优先真实 HTTP、真实文件系统和真实数据库而非过度 mock。六是架构按职责分离,依赖分层为表现层到领域层再到工具层,UI 作为插件,核心可复用、适配器薄,状态分层管理,优先组合而非继承。七是工具一职一器并严格配置,如 ruff、eslint、basedpyright、tsc、pytest、vitest,配合 pre-commit 与 CI 门禁。八是接口标准与框架采用而非重造,选择成熟框架并保持应用代码轻薄。九是项目初始化早期投入,从小型脚本到完整项目都先配置安全网。
使用方式:在开始任何编程工作前加载本技能,按任务规模应用各条原则。
限制:文中未提供安装命令、收费信息或具体价格。