SuperAPI AI 工具集

methodology-system

编程与开发

查看项目

更新于 10-16 11:01

技能介绍

Methodology System 是一个实验性技能,官方提示该功能正在积极开发中,可能在 v4.0 中有重大变更。它面向采用 Universal Development Standards 的项目,为开发者提供统一的开发方法学管理框架。

【用途】 在项目开发过程中管理和引导开发者遵循特定的开发方法学工作流,让 AI 能够感知当前所处的开发阶段并给出相应指导。

【两套独立体系】 技能包含两个相互独立的系统:

System A:SDD(AI 时代方法学) 流程为 /spec → Review → /derive-all → Implementation → Verification。适用于新项目、AI 辅助开发、绿地功能。

System B:双环 TDD(传统方法) 流程为 /bdd(外环)→ /tdd(内环)→ Demo。适用于遗留系统、手工开发、已有代码库。

可选输入:ATDD 工作坊,即干系人协作,其产出可输入上述任一系统。

【支持的方法学】

  • SDD(Spec-Driven Development):Proposal → Review → Forward Derivation → Implementation → Verification → Archive,以规格为权威来源的 AI 原生工作流。
  • 双环 TDD:BDD 外环(Discovery → Formulation → Automation)与 TDD 内环(Red → Green → Refactor)。
  • 可选输入 ATDD:验收测试驱动开发工作坊,可输入任一系统。
  • Custom:用户自定义方法学。

【主要能力】

  1. 阶段感知指导:AI 自动追踪当前阶段并提供符合上下文的指导。例如显示当前方法学为 TDD、当前阶段为 RED(1-5 分钟),并给出检查清单(测试描述行为、测试名称清晰、遵循 AAA 模式、运行时会失败)以及下一步动作。
  2. 检查点提醒:基于方法学触发器自动提醒,包括阶段转换时建议提交、变更超过阈值时发出累积警告、连续跳过检查后发出跳过警告。
  3. 方法学切换:随项目需要切换方法学,命令为 /methodology switch bdd。
  4. 自定义方法学支持:在 .standards/methodologies/ 中定义团队专属工作流,可配置 id、name 和 phases(含 id、name、checklist 等)。

【命令】

  • /methodology:显示当前方法学状态
  • /methodology switch <id>:切换到其他方法学
  • /methodology phase [phase]:显示或更改当前阶段
  • /methodology checklist:显示当前阶段检查清单
  • /methodology skip:跳过当前阶段(带警告)
  • /methodology list:列出可用方法学
  • /methodology create:创建自定义方法学

【配置】 方法学配置存储于 .standards/manifest.json,包含 active、available、config 等字段。配置项包括:active(当前激活的方法学 id)、checkpointsEnabled(true/false,是否启用检查点提醒)、reminderIntensity(suggest/warning/strict,检查点执行强度)、skipLimit(数字,连续跳过多少次后警告)。

【AI 行为】 检测时读取 .standards/manifest.json 中的 methodology.active,并从内置路径 methodologies/{id}.methodology.yaml 或自定义路径 .standards/methodologies/{id}.methodology.yaml 加载方法学定义。阶段追踪根据触发条件追踪当前阶段、在满足退出条件时更新阶段,并提供阶段专属指导和检查清单。

上下文关键词触发:

  • SDD:specification、spec first、proposal、derive tests、forward derivation
  • BDD(外环):given when then、gherkin、cucumber、scenario、discovery
  • TDD(内环):test first、red green refactor、failing test
  • ATDD:acceptance test、user story、product owner、workshop

【与其他标准集成】

  • 检查点标准:阶段完成时与 checkin-standards.md 集成,显示变更统计(文件数、增删行数)、建议的提交信息,并提供提交、继续工作、查看变更等选项。
  • 代码审查:根据激活的方法学追加审查检查项,如 TDD 检查测试命名规范与单一行为、BDD 检查声明式风格与可复用步骤、SDD 检查变更是否符合规格且无范围蔓延、ATDD 检查所有验收标准均有测试。

【相关技能】 TDD Assistant(详细 TDD 指导)、Spec-Driven Dev(SDD 工作流)、Code Review Assistant(审查集成)。

【包含文件】 integrated-flow.md(两套系统的完整工作流指南)、runtime.md(AI 行为与运行时指南)、create-methodology.md(自定义方法学创建向导)。

【版本历史】 2.0.0(2026-01-25):重构为两套独立系统架构。1.0.0(2026-01-12):初始方法学系统。

【限制】 该功能为实验特性,官方明确说明正在积极开发中,可能在 v4.0 中发生重大变更。其余关于性能、收费、价格、平台等内容暂未提供。