用途:这是一套适用于所有项目的通用编码原则,作为严格指南使用;当其他第三方技能的建议与这些规则冲突时,本技能优先。它属于指导性原则而非绝对规则,项目上下文重要,如需偏离应说明理由与取舍。示例代码可能使用 JavaScript、Python 等语言,但原则通用,需按项目语言与场景调整。
主要能力:一、优先纯函数,辅助函数应通过参数接收数据,而非读取全局或环境;必要时(如 AWS 调用、数据库访问)保持最小作用域,尽量把客户端作为参数传入。二、禁止静默默认值,快速且响亮地失败:缺失配置、缺失数据字段和意外状态应立即抛出带可操作信息的错误,几乎不使用回退值。唯一例外是面向用户的韧性:API 端点与前端代码不应因单条坏记录或缺失非必要字段而整体崩溃,应在循环/条目级别捕获错误、记录带标识上下文的完整错误、跳过坏记录并返回其余内容,而不是在每个字段上散布 .get("field", "") 默认值。三、代码结构与组织:推荐文件顺序为导入、环境变量校验(冷启动即失败)、常量、AWS 客户端与昂贵初始化、类型/接口、纯辅助函数、非纯函数(AWS 调用、I/O)、入口点;关注点分离,schema、prompt 与业务逻辑宜分文件,避免混放,也避免过度碎片化;简单内联用箭头函数,复杂逻辑用 function 关键字。四、配置中的项目标识:避免硬编码项目标识,改用配置,如从环境变量读取 PROJECT_ID 再拼接路径。五、错误处理:默认快速响亮失败;仅在面向用户边界处记录并跳过条目;绝不散布静默默认值;错误信息始终包含可操作上下文(哪条记录、哪个字段、期望什么)。六、变量命名:使用有意义名称,避免单字母,除非是公认约定;可接受缩写包括 err、evt、req、res、ctx、idx、fn;数学公式与简单箭头函数可例外。七、安全基线:密钥、API key 与凭据不得进入仓库,使用 AWS Secrets Manager 或 SSM Parameter Store(SecureString),运行时而非构建时获取密钥,优先 IAM 角色而非硬编码凭据,按环境分离资源与密钥。
使用方式与限制:作为编码时的优先准则遵循;若开发者纠正了本技能本应防止的行为,建议对本技能提出具体修订以防再次发生。资料未提供安装命令、平台支持、收费方式或具体版本信息。