APEX 是一套面向专业开发的结构化方法论技能,名称由五个阶段的首字母构成:Analyze(分析)、Plan(规划)、Execute(执行)、eLicit(自省)、eXamine(检验)。其目标是让开发任务按照系统化流程推进,减少模型幻觉、错误与缺陷。
用途与定位 该技能用于指导一次完整的开发任务,包括新功能实现、缺陷修复和代码重构。用户通过参数指定要实现的功能或任务,例如添加用户资料编辑、修复认证缺陷、重构支付模块。
主要能力与流程 第一阶段 ANALYZE:使用 explore-codebase 探索系统相关部分,目标是确定需要修改的位置、理解既有模式与约定、梳理依赖与影响范围、定位相关测试,产出受影响组件的探索摘要。
第二阶段 PLAN:使用 research-expert 对照最佳实践验证方案,设计符合项目模式的解法,识别边界情况与错误处理,规划测试策略,评估影响与复杂度,产出分步实现计划,格式包含实现步骤、边界情况与测试策略。
第三阶段 EXECUTE:按计划逐步实施,保持既有代码风格与模式,为复杂逻辑添加行内文档,同步创建或更新测试。质量标准包括遵循 SOLID 原则、DRY/KISS/YAGNI、单文件不超过 100 行、类型与接口分离、按 OWASP Top 10 进行安全校验。
第三点五阶段 eLICIT(自省):由专家代理在最终校验前进行自检与自我纠正。支持三种模式:--auto 按代码类型自动选择技术(默认)、--manual 呈现 5 项技术由用户选择、--skip-elicit 直接跳到检验阶段。流程为初始化、分析、选择、应用、纠正、报告,技术库覆盖安全、性能、架构、测试、文档、UX/无障碍、数据、并发、集成、可观测性、代码质量、可维护性共 12 类 75 项。系统还提供自动检测矩阵,例如认证/安全类代码选 SEC-01 至 SEC-03,API 端点选 INT-01、DOC-01、TEST-01,数据库选 PERF-01、DATA-02、CONC-06,UI 组件选 UX-01、TEST-01、ARCH-04,业务逻辑选 ARCH-01、TEST-01、CQ-01。
第四阶段 eXAMINE:进行严格验证,包括零容忍运行 linter(如 bun run lint、eslint、prettier --check、tsc --noEmit)、运行单元与集成测试、构建验证、安全审计(npm audit fix、snyk test)、用 research-expert 确认方案未使用废弃 API、执行人工测试计划、最后用 sniper 确保零 linter 错误,产出经过测试与验证、可部署的代码。
使用方式 以斜杠命令加参数调用,参数指定要实现的功能或任务,例如 /apex 添加用户资料编辑、/apex 修复认证缺陷、/apex 重构支付模块。自省阶段可通过 --auto、--manual、--skip-elicit 控制行为。完整文档路径为 ~/.codex/docs/core/apex.md,技能文件位于 skills/elicitation/SKILL.md。
适用场景 适合需要系统化流程的代码开发任务,尤其是涉及安全、API、数据库、UI 组件和业务逻辑的改动,以及希望减少缺陷和提升可维护性的重构与修复工作。
限制与说明 资料未提供具体的安装步骤、支持平台、收费方式与价格信息。文中的效果指标(生产缺陷减少 90%、调试时间减少 70%、开发速度提升 300%、可维护性提升 200%、代码信心 98%)为资料自身宣称,未提供独立验证依据。各阶段依赖 explore-codebase、research-expert、sniper 等工具或代理,其具体实现与可用性资料中未详细说明。