SuperAPI AI 工具集

my-harness-workflow

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:为 moai-adk-go 中基于 SPEC 的工作流提供领域知识,作为现有工作流技能的补充,说明项目专属的规范与模式。

主要能力:

  1. 工作流流水线:/moai plan "description" 经 manager-spec 生成含 EARS 需求的 SPEC 文档;/moai run SPEC-XXX 经 manager-develop 执行实现(TDD 或 DDD);/moai sync SPEC-XXX 经 manager-docs 产出文档并创建 PR。
  2. SPEC 文档结构:.moai/specs/<SPEC-ID>/ 下含 spec.md(EARS 需求与验收标准)、plan.md(含 M1、M2 等里程碑的实现计划)、scenarios.md(测试场景)、risks.md(风险评估与缓解)、progress.md(运行期自动生成的进度跟踪)。
  3. EARS 需求模式:Ubiquitous(The system shall…)、Event-Driven(When…, the system shall…)、Unwanted(If…, the system shall…)、State-Driven(While…, the system shall…)、Optional(Where… is enabled, the system shall…)。
  4. MX 标签:@MX:NOTE 记录上下文与意图;@MX:WARN 标记危险区(需配 @MX:REASON,如 goroutine、复杂度≥15、并发);@MX:ANCHOR 标记不变量契约(fan_in≥3 的函数);@MX:TODO 标记未完成工作。
  5. Plan-in-Main 原则:SPEC 计划 PR 合并到 main 而非特性分支,运行阶段使用 worktree 隔离。
  6. 命名与拆分:SPEC 命名格式 SPEC-V{major}R{minor}-{CATEGORY}-{NUMBER},类别含 WF、ORC、RT、SPC、HOOK、CI、CON、MX、CLI、TUI、BRAIN、STATUSLINE、HYBRID、MIG、GLM;里程碑按基础、核心逻辑、集成、边界情况、收尾分解;30+ 任务时按 wave 拆分,每 wave 一个 PR 并顺序执行。
  7. 验收标准格式:AC-{SPEC-SHORT}-{NUMBER},附 Verification 与 Priority(P0/P1/P2)。
  8. 状态生命周期:draft → in-progress → implemented → in-review → completed,记录于 spec.md frontmatter 的 status 字段。

使用方式:作为技能加载,配合 moai-workflow-spec、moai-foundation-core、moai-workflow-tdd、moai-workflow-ddd 等技能使用;规范细节参见 .claude/rules/moai/workflow/spec-workflow.md 与 .claude/skills/moai/references/mx-tag.md。

限制:资料未提供安装命令、收费方式、支持平台及实际效果说明。