用途
APEX Tier 3 是 APEX 体系中的“配对模式”(Pair Mode),定位为面向复杂架构工作的实时结对编程模式。在该模式下,智能体与人类实时并肩工作,每一个重要决策都会被讨论:智能体提出方案,人类批准或调整方向。
适用场景
资料明确列出以下适用情形:
- 从零开始设计新架构
- 调试关键的生产环境问题
- 问题空间模糊或处于探索阶段
- 人类希望从过程中学习
- 风险高、犯错代价大
交互协议
提议—确认循环(Propose-Confirm Loop)
每个动作都遵循以下模式:
- 智能体提议——“我认为应该做 X,因为 Y。具体看起来是这样……”
- 人类确认、修改或否决——“是” / “做 X 但把 Z 改掉” / “不,改试 A”
- 智能体执行——实现已确认的方案
- 智能体汇报——“完成。以下是变更内容。准备进入下一步。”
协作规则
- 未经确认不得编写超过 50 行代码
- 在提出“做什么”之前,始终先解释“为什么”
- 存在真实取舍时展示备选方案:“选项 A 带来 X 但代价是 Y。选项 B 带来 Z 但代价是 W。”
- 承认不确定性——“我对这个方案没有把握,因为……”永远好过猜测
- 不做应声虫——如果人类的建议存在缺陷,应带着证据礼貌指出
工作流程
开场
先理解问题空间,需了解:
- 我们想达成什么?
- 存在哪些约束(时间、技术、兼容性)?
- 你已经尝试或考虑过什么?
- 成功是什么样子?
会话过程中
维护一份持续更新的决策日志,格式如下:
| # | 决策 | 理由 | 考虑过的备选方案 |
|---|---|---|---|
| 1 | 使用 Prisma 而非 Drizzle | 团队熟悉度 | Drizzle(更快)、原生 SQL(更灵活) |
| 2 | 使用 REST 而非 GraphQL | 当前范围下更简单 | GraphQL(查询更灵活) |
每完成一个重要工作块后运行校验:
Linux/Mac:
bash "${CLAUDE_SKILL_DIR}/scripts/validate.sh" <target-dir>
Windows:
powershell -File "${CLAUDE_SKILL_DIR}/scripts/validate.ps1" <target-dir>
收尾
会话结束时:
- 汇总所有已做出的决策
- 列出任何开放问题或 TODO
- 识别应加入 AGENTS.md 的经验
- 以引用决策日志的描述性提交信息提交工作
输出
产出可运行的代码以及完整的决策日志。会话中发现的任何重复出现的模式或偏好,都是通过 apex-learn 更新 AGENTS.md 的候选内容。
示例决策日志:
## Decision Log — Event System Architecture
| # | Decision | Rationale | Alternatives Considered |
|---|----------|-----------|------------------------|
| 1 | Use EventEmitter over message queue | Simpler for current scale, can migrate later | RabbitMQ, Redis pub/sub |
| 2 | Typed events with Zod schemas | Runtime validation + TypeScript inference | io-ts, manual types |
| 3 | Async handlers by default | Non-blocking, better throughput | Sync handlers |
| 4 | Dead letter queue for failures | Debugging + replay capability | Log and drop |
## Open Questions
- [ ] Should we add event versioning now or later?
- [ ] Rate limiting for high-frequency events?
## Learnings for AGENTS.md
- Always use typed events (add to Architecture Rules)
- Prefer async handlers unless order matters (add to Preferences)
限制
资料未提供关于收费、价格、平台支持范围、性能效果等方面的信息,这些内容暂未提供。