Skip to content

Architecture

Jump to bottom
MageByte edited this page Jul 22, 2026 · 1 revision

架构设计

项目由 TypeScript 验证核心、CLI runtime、9 个可组合 skills、模板和跨平台适配层构成。它是零运行时依赖的插件：发布包内包含运行所需的 skills、脚本、文档和模板。

flowchart LR
  U[User / AI Agent] --> WS[workflow-start]
  WS --> S[Skills state routing]
  S --> A[Planning artifacts]
  A --> P[TypeScript parser & validator]
  P --> C[execution-contract]
  C --> E[Execution plan & review gates]
  E --> R[Runtime CLI / platform adapters]
Loading

验证核心

src/ 的严格 TypeScript 模块编译为 dist/：

  • schema/：Requirement、Scenario、delta 和 spec 的类型定义。
  • parsing/：用正则解析 requirement blocks 与 proposal 的变更信息。
  • validation/：验证器和阈值常量；公开 API 统一从 src/index.ts 导出。

验证规则包括：Requirement 必须含 SHALL 或 MUST 且至少一个 Scenario；delta spec 的 ADDED/MODIFIED 必须有正文与场景；proposal 的 Why 至少 50 个字符，What Changes 不能为空。

CLI runtime

scripts/spec-superflow.mjs 是 ssf / spec-superflow 的入口。scripts/lib/ 提供 validate、doctor、state、workflow、execution、checkpoint 和 handoff 等子命令。CLI 把工件验证与状态/证据 guard 带到每个支持的平台。

平台适配

技能内容保持单一来源；平台差异限定在 plugin manifest、hooks、rules、安装器和本地技能目录。phase-guard 规则提供持续约束，SessionStart hook 在原生支持且已验证的平台补充启动上下文。

Clone this wiki locally