数据在三层之间如何流动
三层数据流总览
需求（自然语言）
↓
OpenSpec →规范文档
↓
Superpowers → 工作流状态
↓
Harness → 验证结果
↓
交付物（代码 + 文档）
第一层：OpenSpec 数据流
输入
| 数据 | 来源 | 格式 |
|---|
| 用户需求 | 用户输入 | 自然语言 |
| 项目上下文 | 环境 | 项目结构、已有规范 |
处理
自然语言需求→ brainstorming skill → 结构化规范
输出
| 产物 | 内容 | 用途 |
|---|
| proposal.md | 意图、范围、边界 | Superpowers brainstorming 输入 |
| specs/ | 详细需求规范 | Superpowers tdd 输入 |
| design.md | 技术方案 | Superpowers implement 输入 |
| tasks.md | 任务清单 | Superpowers plan 输入 |
第二层：Superpowers 数据流
输入
| 数据 | 来源 | 格式 |
|---|
| OpenSpec 规范 | OpenSpec 输出 | Markdown 文件 |
| 项目代码 | 环境 | TypeScript |
| Harness 约束 | Harness | CLAUDE.md |
处理
OpenSpec 规范 → Skill 工作流 → 代码变更
各 Skill 的输入输出
| Skill | 输入 | 输出 |
|---|
| brainstorming | proposal.md | 需求澄清问题 |
| plan | tasks.md | 任务执行计划 |
| tdd | specs/ | 测试文件 + 实现代码 |
| implement | design.md | 功能代码 |
| review | tasks.md + 代码 | 审查报告 |
第三层：Harness 数据流
输入
| 数据 | 来源 | 格式 |
|---|
| OpenSpec 规范 | OpenSpec | specs/ |
| 代码变更 | Superpowers | TypeScript |
| 约束定义 | Harness 配置 | CLAUDE.md |
处理
代码变更 →约束检查 → 验证结果
约束检查点
| 检查点 | 触发时机 | 检查内容 |
|---|
| CLAUDE.md | 代码生成后 | 代码风格、架构约束 |
| 测试套件 | 代码生成后 | 行为边界 |
| Pre-commit Hook | git commit 前 | 自动化检查 |
| CI/CD | git push 后 | 完整验证 |
完整映射表
Superpowers 14 Skills与 Harness Engineering 的完整映射
| Superpowers Skill | Harness 约束 | 约束文件位置 |
|---|
| brainstorming | Context Engineering | CLAUDE.md 项目概述 |
| plan | Architectural Constraints | CLAUDE.md 目录结构 |
| tdd | 测试边界设计 | tests/ 目录 + CLAUDE.md质量要求 |
| implement | 代码规范约束 | CLAUDE.md 代码规范 |
| review | Hooks + 权限检查 | .husky/pre-commit |
| debug | 监控 + 日志系统 | CLAUDE.md 错误处理规范 |
| refactor | Entropy Management | CLAUDE.md 架构约束 |
| subagent | Sub-Agent System | .claude/agents/ |
| skill | Skills & Plugins | .claude/skills/ |
| git-worktree | 版本控制规范 | .gitignore + CLAUDE.md |
| finish-branch | 交付规范 | CLAUDE.md 质量要求 |
| parallel-agents | 并发控制 | .claude/config.yaml |
| receive-review | 反馈规范 | CLAUDE.md 代码审查 |
| verify | 验证规范 | 测试套件 + Hooks |
扩展阅读
