用途:在需要工程判断时提供决策框架,例如做架构或设计决策、评估不同方案的权衡、判断代码质量、决定何时重构、决定独立推进还是提问,以及在速度、质量与可维护性之间取舍。不适用于机械性任务、已有明确结论的决策或按明确指令执行的工作。
主要能力:给出核心工程判断原则,包括用户偏好优先于默认建议,项目规则与既有模式覆盖技能建议;从最简单可行方案起步,优先成熟库而非自研,渐进增强而非重写;先读后写,理解既有模式再修改;保持小而聚焦的改动(每次提交一个想法,约20-100行,1-5个文件);具备安全意识,校验外部输入、使用参数化查询、正确处理认证、不在代码或日志中泄露密钥;知道何时停止,交付可用代码而非过度打磨。
类型安全:核心原则是让非法状态不可表示,在编译期而非运行期阻止无效数据;层级为正确、清晰、精确;关键模式包括结果类型、可辨识联合、品牌类型,以及在边界处解析而非内部反复校验。
决策框架:先理解问题、约束、代码库现状与项目模式,再权衡速度与健壮性、简单与灵活、一致性与优化、实现时间与维护时间;识别“足够好”并交付;对非显而易见的决策记录原因、权衡与假设。
提问与升级:任务清晰、遵循既有模式、改动小且局部、需求明确、无安全或数据完整性风险时可独立推进;需求模糊、多种方案权衡不清、影响架构、涉及安全合规、领域或技术不熟时应提问;发现安全漏洞、数据损坏风险、公共 API 破坏性变更、性能退化时应立即升级。
代码质量与重构:错误路径需显式处理,命名遵循函数用动词、变量用名词、布尔值用问句;函数保持单一职责,通常10-30行、最多50行,参数理想3个、最多5个;注释解释原因而非内容。重构时机包括新增功能暴露结构问题、代码重复3次以上、函数超过50行、命名不清、测试难写;不应在代码稳定不再改动、交付时间紧迫、无测试覆盖、偏离主任务或仅凭偏好时重构。
测试与优化:测试公共接口、边界与错误路径、关键业务逻辑、集成点与安全边界;避免测试琐碎访问器、框架行为与脆弱实现耦合测试。优化前先测量、设定目标、定位瓶颈,再针对瓶颈优化并记录权衡,不凭直觉优化。
限制:资料未提供具体安装命令、收费方式、平台支持或运行环境要求;该技能为工程判断与规范指导,不替代具体技术实现技能。