用途:在编写或修改代码时,按仓库自身规则执行实现,强调可维护性、契约、错误处理与重构。
主要能力与要求:
- 语言与仓库规则:使用仓库已有的格式化器、linter、类型系统、命名约定和代表性代码模式;仅在适用时查阅语言参考(如 TypeScript 对应 references/typescript.md)。仓库契约与已接受的设计决策优先于通用风格偏好。
- 最小改动:优先通过现有机制实现已确认结果;不相关清理与可选加固应留在改动之外;改动责任范围内若证据表明已无消费者,则移除无用代码;仅当当前调用方共享职责且存在变更压力时才引入抽象。
- 函数与接口:每个函数或模块保持单一一致职责;遵循语言惯用的参数与数据形状约定;在合适边界暴露外部依赖与副作用;除非已批准范围变更,否则保留公共与共享契约;偏好简单控制流,复杂度掩盖行为或错误处理时进行重构。
- 错误处理:跨边界保留可操作的错误上下文;仅在接收层需要不同契约时转换错误;避免在每一层重复记录同一错误;日志与消息中不得包含密钥、凭据及不必要的个人数据;仅当当前需求定义降级结果时才添加回退行为。
- 注释与文档:解释非显而易见的意图、约束或权衡;注释保持长期有效,移除过时或注释掉的代码;若消费者否则会依据过时信息行动,则更新文档。
- 重构:确认可观察行为与聚焦验证;做最小的一致结构变更;运行受影响的验证;仅当仍存在另一个当前问题时继续。
- 性能与资源:优化前先测量已证实的瓶颈;使用与语言及仓库相适的资源生命周期和数据结构模式;仅当当前需求或实测问题支持时才添加缓存、并发、批处理或监控。
完成检查:实现遵循代表性仓库模式或记录必要偏差;新增结构有当前消费者与用途;错误保持可观察且无重复日志或静默回退;适用的仓库检查通过。
使用方式:编写或修改代码时启用该技能。具体安装命令、平台支持及配置方式暂未提供。
限制:资料未提供收费、价格、平台及效果信息。