SuperAPI AI 工具集

pentaphase-orchestrator

智能体与模型

查看项目

更新于 10-15 09:42

技能介绍

Pentaphase Orchestrator 是一个编排型技能,用于运行完整的五阶段结构改造协议。该协议将某个“基底”从混乱的当前状态,经由五个带门禁的阶段,推进到受治理的目标状态。每个阶段都会产出一个具名产物,供下一阶段消费。

用途

该技能为任何用户指定的基底协调完整的五阶段旅程,包括文档系统、资产登记表、代码仓库、知识库、数据仓库、内容库、组织流程,以及任何需要重构的结构。它本身不执行阶段工作,而是编排五个阶段技能,通过 structural-integrity-auditor 代理在阶段之间强制执行门禁标准,并维护累积的产物流,使每个阶段都能从先前阶段获得所需上下文。

Phase 0:获取基底上下文

在调用任何阶段技能之前,需要向用户提出以下五个问题并逐字记录回答:

  1. 基底——我们要重构哪个系统?需具体说明:实体名称、大致规模、物理或逻辑位置,以及当前由谁负责。
  2. 驱动因素——是什么业务或运营职能迫使进行此次改造?(合规截止日期?扩展失败?新计划?关键人员离职?)
  3. 主要故障点——此次改造必须解决的当前最大单一故障是什么?
  4. 运营角色——谁每天与该系统交互?列出角色,而非具体人员。
  5. 时间范围——何时需要进入受治理的目标状态?

还需询问用户将改造项目锚定在何处。默认建议路径为:<current-cwd>/pentaphase-overhauls/<substrate-slug>/。随后创建该工作目录,并写入 substrate-context.md,其中包含逐字回答、slug、工作目录路径以及协议启动日期。所有五个阶段技能都将读取此文件。

阶段序列与门禁

通过显式调用各阶段技能来执行每个阶段。每个阶段产出产物后,调用 structural-integrity-auditor 代理验证门禁标准。未获得 PASS 或经用户批准的 PARTIAL 结论前,不得进入下一阶段。

阶段与技能对应关系:

  • 阶段 1:landscape-discovery-audit,产出 phase-1-landscape-report.md。门禁标准概要:资产已清点、当前流程已映射、摩擦已登记、价值指标已定义。
  • 阶段 2:taxonomy-modeling-design,产出 phase-2-taxonomy-model.md。门禁标准概要:实体类已命名、属性模式已声明、关系已映射、访问层级已定义。
  • 阶段 3:system-environment-configuration,产出 phase-3-environment-spec.md。门禁标准概要:选择标准已转化、机制已选定、实例化步骤、验证规则。
  • 阶段 4:systemic-ingestion-normalization,产出 phase-4-ingestion-report.md。门禁标准概要:去重结果、已应用的丰富化、批量摄取日志、完整性审计。
  • 阶段 5:governance-evolution-protocol,产出 phase-5-governance-charter.md。门禁标准概要:成文协议、入职计划、监控模式、迭代节奏。

工作目录布局

Phase 0 之后,目录中只有 substrate-context.md。每完成一个阶段,就添加对应产物:

<working-dir>/ ├── substrate-context.md ├── phase-1-landscape-report.md # 阶段 1 后 ├── phase-2-taxonomy-model.md # 阶段 2 后 ├── phase-3-environment-spec.md # 阶段 3 后 ├── phase-4-ingestion-report.md # 阶段 4 后 ├── phase-5-governance-charter.md # 阶段 5 后 └── audit-log.md # 累积的审计签署记录

语气与形式

匹配用户的基底词汇。如果用户使用领域特定术语(atoms、organs、registries、strata、lineages、modules、lots、tickets、units、pieces 等,即基底自身的语言),则需在所有产物中逐字保留这些术语。不要将领域语言扁平化为通用项目管理词汇。

每个产物必须声明:

  • 前置条件——它消费了哪些先前产物,并附文件路径。
  • 后置条件——它留下什么样的世界状态,为下一阶段做好准备。

协议暂停或分叉的情形

  • 基底太小,不适合完整协议——如果基底是单个配置文件或十行表格,应告知用户该协议过于繁重。可提议仅调用相关阶段技能(通常是阶段 2 和 3),或将方法论适配到更小范围。
  • 门禁两次失败——向用户明确暴露差距。不要用合成内容掩盖。询问是修复、升级范围,还是缩减基底范围。
  • 用户在协议中途更换基底——暂停并询问是分叉项目(新工作目录、新 substrate-context.md),还是以变更后的基底重新开始。
  • 阶段期间出现外部约束——将其记录在当前产物的“Open questions”部分并继续。不要静默放弃该约束。

收尾

当阶段 5 的产物通过门禁后,执行收尾步骤:

  1. 在 audit-log.md 中追加最终条目,声明协议完成。
  2. 在 <working-dir>/protocol-summary.md 生成一页摘要,列出五个产物及其一句话描述、基底名称和日期范围。
  3. 告知用户基底已处于受治理的目标状态,协议已关闭。governance-evolution-protocol 产物的迭代节奏将约束后续变更。

反模式

  • 不要跳过 Phase 0。没有 substrate-context.md,各阶段技能就没有共享框架。
  • 不要并行运行各阶段。每个阶段消费前一阶段的产物;并行会产生不一致的输出。
  • 不要自己撰写阶段产物。应委托给阶段技能。你的职责是衔接。
  • 不要在门禁失败且未经用户明确批准的情况下继续推进。审计结论不是装饰性的。