SuperAPI AI 工具集

principal-engineering

编程与开发

查看项目

更新于 10-16 08:01

技能介绍

用途:这是一套指导非平凡工程工作的主技能,适用于实现、调试、重构、配置、运维,或排查系统行为异常等场景。核心主张是:先查明系统实际行为,而非凭记忆套用模式;每个决定都扎根于真实代码和数据,错误要显式暴露,同一事实只保留一处,未经验证不得宣称完成。

主要能力与用法:主技能本身给出总原则,深度由兄弟技能承接,按任务叠加加载——开始改动、调试或进入陌生代码时加载 grounding-before-coding;编写或改动错误路径、回退、默认值时加载 handling-failures;新增数据、配置、状态或任何副本时加载 keeping-one-source-of-truth;宣称“完成/修复/通过”时加载 verifying-before-done;删除、覆盖、重启或触碰密钥与线上系统时加载 operating-safely;判断修复规模或发现范围漂移时加载 scoping-changes;决定改动应付哪些测试时加载 testing-changes;编写或修复单元测试时加载 writing-unit-tests;跨越模块边界时加载 guarding-architecture;增删或评估依赖时加载 adding-dependencies。

硬规则:不得静默吞掉错误,每个捕获与失败路径都必须记录并重抛、返回调用方必须处理的类型化失败,或进入明确记录的降级模式,新增静默吞错视为评审阻断项;已应用的迁移不可修改,只能新增迁移;宣称已验证时必须指明检查了什么;密钥值不得读取、打印或落盘解密;破坏性操作先看清目标,重启或终止线上服务前先询问;证据优先于理论。风险分级决定严谨度:最高级别路径需不变量测试与独立验证,代码库规则或 CLAUDE.md 优先于本技能。非平凡改动前需在工作记录中写明 Grounded、Blast radius、Invariants、Verify 四项。

限制:不是风格指南,格式、命名与框架选择以仓库自身约定为准;不能替代项目说明,CLAUDE.md 与仓库规则优先;不提供产品决策,做什么由所有者决定;文档撰写属技术写作插件的职责。官方文本与安装方式暂未提供。