SuperAPI AI 工具集

coding-rules

编程与开发

查看项目

更新于 10-16 05:52

技能介绍

用途:这是一套适用于所有代码相关工作的行为准则,在代码实现、修改、重构和评审时使用。规则明确以谨慎优先于速度,琐碎任务可自行判断。

主要能力:一是在动手前思考,明确陈述前提,不确定就提问,存在多种解释时列出而非默选,有更简单方案时提出甚至反驳。二是优先简单,只写解决问题的最小代码,不写臆测功能、一次性抽象、未被要求的灵活性或不可能场景的错误处理。三是外科手术式改动,只触碰必要位置,不擅自“改善”周边代码或重构未损坏的部分,仅清理自己改动产生的孤用导入、变量、函数,发现旧死代码只报告不删除。四是目标驱动执行,把任务转为可验证目标并循环验证。五是可读性要求,按语义分组用空行分隔,函数、方法、构造器、独立事件处理器、测试用例之间必须空一行;TypeScript/JavaScript 中分支和循环体即使一行也保留花括号,多个变量声明不合并。六是注释写明目的与理由,函数注释首句直接说明做什么,再写原因、约束与实现手段。七是命名体现“做什么、对什么做”,避免 call、handle、run 等含糊名称,并同步更新调用方、测试和文档中的旧名。八是完成前以人类视角通读改动后的函数与测试。

使用方式与限制:需配合具体仓库自身指令执行,本技能提供通用规则。README 中仅给出少量示例代码,未提供安装命令、平台、定价或价格信息,暂未提供。