// tier: helix-primary · order 7

HelixSpecifier betalicense: TBD

GologrusSpecKit pillarSuperpowers pillarGSD pillarSpec memory store

Source

HelixSpecifier — three pillars → one flow Three pillars effort in → ceremony out (scaling dial) SpecKit specification Superpowers capability skills GSD get-stuff-done Fusion engine Go · adaptive ceremony Executed flow + quality score
// architecture

规模化自适应仪式感的规约驱动开发

HelixSpecifier 是一款 Go 引擎,将三种开发方法论——SpecKit 的规约驱动流程、Superpowers 的测试驱动纪律以及 GSD 的里程碑生命周期——融合为一个自适应工作流。它根据任务的工作量对其进行分类,并相应调整流程的复杂程度。

HelixSpecifier 是一款面向 AI 智能体的规约驱动开发融合引擎。它整合了 SpecKit、Superpowers 和 GSD,按工作量分类任务,通过辩论支持的规约阶段,强制执行最低测试代码比,并从每次完成的流程中持续学习。

HelixSpecifier 是一款用 Go 编写的规约驱动开发(SDD)融合引擎(模块 digital.vasic.helixspecifier),作为 HelixAgent AI 系统的组件构建。它将三种通常分属不同工具、不同思维模式的开发实践融为一体,形成一个自适应工作流:SpecKit 的七阶段 SDD 流程(Constitution、规约、澄清、规划、任务、分析、实现)、Superpowers 的测试驱动纪律及并行子智能体执行,以及 GSD 的里程碑生命周期管理。每个支柱各司其职,而引擎则将它们整合为一个连贯的流程,而非手工拼接的管道。

其核心理念是*自适应仪式感*:引擎根据任务的工作量对其进行分类,并相应调整流程的复杂程度,确保一行代码的修复无需经历与重大功能相同的繁复仪式,而重大功能也不会在缺乏严谨性的情况下草草通过。基于这一核心,引擎提供了十大核心功能:有界并发的并行任务执行、机器可读的"代码化 Constitution"自动强制执行强制规则、"奈奎斯特 TDD"跟踪并强制执行最低测试实现比、多轮多智能体辩论式规约细化、自适应技能熟练度学习、遗留代码的棕地分析、基于历史模式的预测性规约、跨项目知识迁移、运行时仪式调整以实现飞行中重新调优,以及带语义搜索的持久化规约记忆。

它以 Go 模块的形式提供——通过 go get 或本地替换指令调用——并隐藏在一个精心设计的小型引擎 API 背后:注册三大支柱及仪式感缩放器与规约记忆,对工作量进行分类,然后执行完整流程并返回带质量评分的结果。表面简洁,背后的编排却极为复杂。与 Helix 家族的其他成员一样,它在反虚假验证机制下开发,通过内置挑战运行器对真实代码(而非模拟)进行验证。

规约驱动开发、严格的测试驱动开发和里程碑管理通常是三种独立的实践,分别依赖三种不同的工具。HelixSpecifier 的构建初衷,是让 AI 智能体(HelixAgent)能够将这三者整合为一个连贯且自动缩放的工作流,而非手动拼接。

内容

它让流程与工作量自动匹配。团队通常会陷入两种极端:要么对所有事项都采用繁琐仪式(安全但缓慢,且在无声中滋生不满),要么完全摒弃仪式(看似快速,直到问题爆发)。HelixSpecifier 打破了这一取舍,根据每项任务的分级工作量调整仪式规模,并在运行时随工作进展动态微调。这种前所未有的能力,是一种能够为每项任务量身定制的流程——不仅如此,其规格决策还基于多轮多智能体辩论与立场评分,而非单一智能体的初步猜测。

  • 自适应仪式——流程等级由实时质量指标驱动,在运行时调整,而非预先固定。
  • 奈奎斯特测试驱动开发(Nyquist TDD)——引入测试与实现比例门槛(最低2倍),借鉴奈奎斯特采样定理的逻辑:要忠实捕捉行为,采样率必须远高于其频率,因此测试必须超越其覆盖的代码。
  • 辩论架构——多轮多智能体规格精炼机制,立场被提出、评分并收敛,以对抗性思维取代单一观点。
  • 预测性规格跨项目知识迁移——引擎挖掘累积流程数据,预测规格并将来之不易的经验从一个项目传递至下一个。
  • Constitution 即代码——将强制性项目规则机器可读化,由引擎执行,而非依赖审查者的警觉。

  • 融合三种互不兼容的方法论——SpecKit、Superpowers 和 GSD 均假设自身主导工作流。通过融合引擎解决,该引擎将三大支柱统一于共同接口之下,并通过单一共享流程生命周期驱动,使其整合为一个协同流程,而非三者冲突。
  • 确定特定任务实际所需的流程量——过高则拖慢进度,过低则风险任务未经检验便交付。通过工作量分级器解决,其评估任务规模,并驱动仪式缩放器在执行过程中动态调整流程等级。
  • 在无人工把关的情况下保障规格质量——以辩论支持的精炼机制取代一次性规格,智能体在多轮中评分竞争立场,并强制执行奈奎斯特 TDD 比例,确保实现无法超越测试覆盖。

  • Go——选用该技术以确保引擎以单一可导入二进制文件交付,无运行时依赖;其并发模型使有界并行任务调度与多智能体辩论轮次成为可行而非线程噩梦。
  • logrus——结构化日志贯穿引擎及三大支柱,确保流程决策(分级、仪式变更、辩论结果)事后可追溯。
  • SpecKit 支柱——七阶段规格驱动开发流程(Constitution → 规格制定 → 明确 → 规划 → 任务 → 分析 → 实现),为规格转化为代码提供严谨的主干框架。
  • Superpowers 支柱——测试驱动开发纪律,支持并行子智能体执行,确保测试先行的严谨性,并通过分支扩展保持实现的诚实与高效。
  • GSD 支柱——里程碑与生命周期管理,赋予流程"完成"感及阶段推进。
  • 规格记忆存储——持久化、语义可检索的历史规格索引,为预测性规格与跨项目知识迁移提供基础,避免每次从零开始。

内容

  • 状态:测试版。 作为 HelixAgent 模块组件中的 Go 部分使用。
  • 许可协议:待定。 通过 GitHub API 未检测到 LICENSE 文件——未验证/未声明。
  • 显示名称"HelixSpecifier"对应代码库 specifier

优先级别: Helix-主级。