SuperAPI AI 工具集

absolute-human

编程与开发

查看项目

更新于 10-26 16:19

技能介绍

用途

Absolute-Human 是一套为 AI 智能体从零构建的开发生命周期,用于替代传统 SDLC。传统 Agile、Waterfall、TDD 等方法围绕人类约束(并行能力有限、上下文切换成本、沟通开销、会议)设计,而 AI 智能体没有这些约束。Absolute-Human 利用这一点,把工作分解为带依赖图的子任务,按并行波次执行独立任务,在每一步强制 TDD 验证,并在跨会话持久化的看板上跟踪一切。

主要能力

  • 7 阶段模型:INTAKE → DECOMPOSE → DISCOVER → PLAN → EXECUTE → VERIFY → CONVERGE。
  • 激活横幅:每次调用开始时,在任何其他输出之前,必须显示指定的 ASCII 艺术横幅,以提示用户 Absolute-Human 模式已激活。
  • 激活协议:显示横幅后立即进入计划模式。在支持原生计划模式的平台(如 Claude Code 的 EnterPlanMode、Gemini CLI 的 planning mode)上直接调用;在不支持的平台上,通过完整完成 INTAKE 到 PLAN 的所有规划阶段来模拟计划模式,并在进入 EXECUTE 前把完整计划提交用户明确批准。前四个阶段属于规划工作,用户批准计划并进入第 5 阶段执行前,不应创建或修改任何文件。
  • 会话恢复协议:当项目根目录已存在 .absolute-human/board.md 时,读取现有看板并判断状态(进行中、阻塞、已完成),打印紧凑状态摘要,从最后一个未完成的波次继续,而不是从 INTAKE 重启;若代码库自上次会话以来有变化,则对照看板预期状态做快速 diff 检查并标记冲突。若看板标记为已完成,询问用户是开始新的 Absolute-Human 会话(把旧看板归档到 .absolute-human/archive/)还是审查已完成工作。长会话(完成 3 个以上波次或上下文窗口压力)的主动上下文重置见 references/context-reset-protocol.md。未经用户明确确认,绝不丢弃现有看板。
  • 代码库约定检测:在 INTAKE 开始前,通过扫描关键文件自动检测项目约定,包括包管理器、语言/运行时、测试运行器、Linter/Formatter、构建系统、CI/CD、可用脚本、目录约定和 Codedocs。检测结果写入看板的 ## Project Conventions 部分,并在后续每个阶段引用。
  • Codedocs 检测:若发现 .codedocs.json 清单,则记录其位置并在看板上设置 codedocs_available: true,这会改变 DISCOVER 和 PLAN 的运作方式。可用时,在约定检测期间立即读取 docs/OVERVIEW.md 和 docs/GETTING_STARTED.md,把关键技术事实(技术栈、模块图、入口点、开发命令)追加到看板的 ## Project Conventions 部分。

使用方式

何时使用

  • 涉及 3 个以上文件或组件的多步功能开发
  • 用户说“端到端构建这个”或“规划并执行这个”
  • 用户说“把这个拆成任务”或“做冲刺规划”
  • 任何需要规划 + 实现 + 验证的任务
  • 绿地项目、大型重构或迁移
  • 跨多个系统的复杂缺陷修复

何时不使用

  • 单文件缺陷修复或拼写更正
  • 快速问题或代码解释
  • 用户希望在指导下手动完成的任务
  • 纯研究或探索任务

核心原则

  1. 依赖优先分解:每个任务是有向无环图(DAG)中的节点,而非扁平列表;任务间依赖显式声明,防止合并冲突、顺序缺陷和无效工作。
  2. 基于波次的并行:依赖图中同一深度的任务构成一个“波次”,同一波次内所有任务通过并行智能体同时执行,波次之间串行执行。
  3. 测试优先验证:每个子任务先写测试再实现,只有测试通过任务才算“完成”,不因“简单”而例外。
  4. 持久状态:所有进度记录在项目根目录的 .absolute-human/board.md,跨会话存活,支持恢复、审计和交接。用户在 INTAKE 期间选择看板是否纳入 git 跟踪。
  5. 交互式需求收集:绝不假设,问题深度随任务复杂度伸缩——简单任务 3 个问题,复杂任务 8-10 个。

核心概念

  • 任务图:有向无环图(DAG),节点为子任务,边为依赖;无未解决依赖的任务可并行执行。
  • 执行波次:DAG 中同一深度级别的独立任务分组。第 1 波先运行(全部并行),然后第 2 波,依此类推。
  • 看板:.absolute-human/board.md 是唯一事实来源,包含需求摘要、任务图、波次分配、每任务状态、研究笔记、计划和验证结果。
  • 子任务生命周期:pending → researching → planned → in-progress → verifying → done,另有 blocked 和 failed(重试)分支。

各阶段要点

阶段 1:INTAKE(交互式访谈) 按复杂度调整深度:简单 3 问、中等 5 问、复杂 8-10 问。核心问题包括问题陈述、成功标准、约束;扩展问题包括现有代码、依赖;深度问题包括边界情况、测试策略、发布、文档、优先级。始终询问看板持久化问题:.absolute-human/ 看板应纳入 git 跟踪(审计轨迹、跨机器恢复)还是 gitignore(本地工作状态)。输出写入 .absolute-human/board.md。

阶段 2:DECOMPOSE(创建任务图) 每个子任务包含 ID、标题、描述、类型(code/test/docs/infra/config)、复杂度(S/M/L)、依赖列表。分解规则:每个任务应为 S 或 M,L 需继续拆分;测试任务与实现任务分开;基础设施/配置任务先于依赖它们的代码;文档任务依赖其记录的代码;目标 5-15 个子任务;每个任务图必须以三个强制尾部任务结束(自我代码审查、需求验证、全项目验证);应用复杂度预算。复杂度预算:统计 S/M/L 数量,不允许残留 L 任务;若总估算超过 15 个 M 等价任务(1 L = 3 M,1 S = 0.5 M),提示用户范围可能过大,建议拆分为多个 Absolute-Human 会话,用户可覆盖但须明确确认。构建 DAG 后分配波次,生成 ASCII 依赖图和波次分配表,提交用户明确批准后再继续。

阶段 3:DISCOVER(并行调研) 按波次并行研究每个子任务,顺序为文档优先、源码其次:若 codedocs_available: true,先查 docs/INDEX.md 定位模块文档,读 docs/modules/<module>.md,查 docs/patterns/ 跨领域模式文档,用 docs/OVERVIEW.md 获取架构上下文;文档不足时再进入代码库探索,并把文档缺口标记为看板上的陈旧性说明。代码库探索始终运行,用于填补文档缺口或没有 codedocs 时。代码库上下文不足时进行网络研究。同时做风险评估,标记未知、歧义、与其他子任务的潜在冲突及需验证的假设。

阶段 4:PLAN(执行计划) 为每个子任务指定:要创建/修改的文件路径、测试文件路径(TDD,先写)、实现方法简述、验收标准、测试用例列表(正常路径、边界情况、错误处理)。规划规则:测试总是先于实现规划;计划必须引用 DISCOVER 中发现的具体可复用代码;必须遵守项目现有约定;若计划揭示缺失依赖,更新任务图并重新获得用户批准。

阶段 5:EXECUTE(基于波次的实现) 执行前创建 git 安全网:确保当前更改已提交或暂存,把当前提交哈希记录到看板的 ## Rollback Point;若执行灾难性失败,用户可 git reset --hard 回滚。按波次循环执行,每个波次内并行处理独立任务,每个任务先写测试(TDD 红阶段),再实现代码使测试通过。

适用场景

多步功能开发、绿地项目、大型重构、迁移、跨系统复杂缺陷修复,以及任何需要规划 + 实现 + 验证的任务。

限制

不适用于单文件缺陷修复、拼写更正、快速问答、代码解释、用户希望手动完成的任务、纯研究或探索任务。激活后必须先显示指定 ASCII 横幅并进入计划模式,用户批准计划前不得创建或修改文件。未经用户明确确认不得丢弃现有看板。L 复杂度任务不允许存在,必须继续拆分。超过 15 个 M 等价任务的范围需用户明确确认。