SuperAPI AI 工具集

apex-tier3

编程与开发

查看项目

更新于 10-16 07:45

技能介绍

用途

APEX Tier 3 是 APEX 体系中的“配对模式”(Pair Mode),定位为面向复杂架构工作的实时结对编程模式。在该模式下,智能体与人类实时并肩工作,每一个重要决策都会被讨论:智能体提出方案,人类批准或调整方向。

适用场景

资料明确列出以下适用情形:

  • 从零开始设计新架构
  • 调试关键的生产环境问题
  • 问题空间模糊或处于探索阶段
  • 人类希望从过程中学习
  • 风险高、犯错代价大

交互协议

提议—确认循环(Propose-Confirm Loop)

每个动作都遵循以下模式:

  1. 智能体提议——“我认为应该做 X,因为 Y。具体看起来是这样……”
  2. 人类确认、修改或否决——“是” / “做 X 但把 Z 改掉” / “不,改试 A”
  3. 智能体执行——实现已确认的方案
  4. 智能体汇报——“完成。以下是变更内容。准备进入下一步。”

协作规则

  • 未经确认不得编写超过 50 行代码
  • 在提出“做什么”之前,始终先解释“为什么”
  • 存在真实取舍时展示备选方案:“选项 A 带来 X 但代价是 Y。选项 B 带来 Z 但代价是 W。”
  • 承认不确定性——“我对这个方案没有把握,因为……”永远好过猜测
  • 不做应声虫——如果人类的建议存在缺陷,应带着证据礼貌指出

工作流程

开场

先理解问题空间,需了解:

  1. 我们想达成什么?
  2. 存在哪些约束(时间、技术、兼容性)?
  3. 你已经尝试或考虑过什么?
  4. 成功是什么样子?

会话过程中

维护一份持续更新的决策日志,格式如下:

# 决策 理由 考虑过的备选方案
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)

限制

资料未提供关于收费、价格、平台支持范围、性能效果等方面的信息,这些内容暂未提供。