APEX Methodology 是一个面向开发任务的完整工作流技能,适用于功能开发、缺陷修复、重构和热修复等场景。触发词包括 implement、create、build、fix、add feature、refactor、develop。
工作流程 技能按 Analyze(A)→ Plan(P)→ Execute(E)→ eLicit(L)→ eXamine(X)组织,包含以下阶段:00 初始化分支、00.5 头脑风暴(设计优先提问)、01 分析代码、02 功能规划、03 TDD 执行(RED→GREEN→REFACTOR)、03.5 专家自审、03.7 功能解决验证、04 sniper 校验、05 自审、06 修复问题、07 编写测试、08 运行测试、09 创建 PR。各阶段的具体步骤见 references 目录下的对应文件。
初始化与钩子约束 第一步必须初始化 APEX 跟踪:创建 .claude/apex/task.json(文档咨询状态)和 .claude/apex/docs/(已咨询文档摘要)。在此之前,PreToolUse 钩子会阻止 Write/Edit 操作,直到完成文档咨询。
硬性规则
- 文件大小:接近 FUSE_SOLID_MAX_LINES 时应立即按职责拆分;绝不可超过该上限(钩子会阻止);每个文件只承担一项职责,不自行设定上限。
- 接口位置:接口应放在 src/interfaces/、类型放在 src/types/、契约放在 Contracts/(PHP/Laravel);绝不可放在组件文件中。
- Agent 使用:01 分析阶段并行调用 explore-codebase 与 research-expert;04 校验阶段在任何修改后必须执行 sniper。
- 明确禁止:跳过 explore-codebase 或 research-expert;未经验证假设 API 语法;创建超过 FUSE_SOLID_MAX_LINES 的文件;把接口放在组件文件;修改后跳过 sniper;无测试合并;提交超过 400 行的大型 PR。
运行模式 --auto(默认,无提示)、--manual(逐步确认)、--skip-elicit(跳过自审阶段)。当前任务通过 $ARGUMENTS 传入。
按需加载的参考文件 references/init-tracking.md(初始化跟踪命令)、phases-explained.md(APEX 各阶段详解)、branching-strategy.md(分支创建与命名)、commit-conventions.md(提交信息规范)、quick-start-flows.md(标准功能/缺陷修复/热修复完整步骤)、flow-diagram.md(工作流 ASCII 流程图)、validation-requirements.md(PR 前代码质量清单)、pr-guidelines.md(PR 标题与描述)、language-detection.md(项目类型自动识别)。
适用场景与限制 适用于遵循该技能约束的项目开发流程,尤其强调文件职责拆分、接口隔离、TDD 和自动校验。使用前提是配置相应的 Claude 插件与钩子环境;关于收费、支持平台等信息暂未提供。