PowerPath 完整工程流转图

从自然语言 → concierge 15类路由 → council 多角色 → CLAUDE.md → AGENTS.md → Skills/协议/Memory → 文档契约层 → Hermes 借鉴机制 → 交付 + 规则固化 + 知识蒸馏

用户输入
Concierge 管家
CLAUDE.md 路由器
AGENTS.md 引导
BMAD 43+ Skills
Protocol 协议文件
Memory Bank
截图验证
规则飞轮
Council 多角色讨论
GATE / 停下来
研究分析
文档契约层
迭代健康
Hermes 借鉴机制
💬
用户用自然语言说任何话
"帮我改一下训练页空状态" / "有个 bug" / "加个功能" / "下一步"…
不需要知道 skill 名字，不需要了解系统结构
任意项目相关请求 → 触发 Concierge
SKILL
🧭
powerpath-concierge
意图分析 → 扫描项目状态 → 推荐最优 Skill 路径
.claude/skills/powerpath-concierge/SKILL.md
🆕新功能
🐛修Bug
🎨UI设计
📋规划排期
🔍Review
💡探索讨论 → Council
📖文档
🏗️架构
⚡快速任务
🔬研究分析
🧪测试生成
🔄迭代健康
📝需求维护
🧠知识蒸馏
✍️文档质量审查
📎 日常 Case — 你说一句话，Concierge 推荐完整路径
🆕 新功能 "加一个训练日历的周视图切换"
create-story → dev-story → ui-verify
自动检测：UI 任务 → 触发 Phase 4 截图 GATE
🐛 修 Bug "营养页取消的食物还出现在首页"
quick-dev
已知方向 → 快速路径，不需要 story 拆分
🎨 UI 设计 "Settings 页面感觉太素了，重新设计"
create-ux-design → dev-story → ui-verify
提醒：加载 DESIGN-SYSTEM.md + 全量上下文审查
📋 规划排期 "下个 Sprint 做什么？把任务排一下"
sprint-status → sprint-planning → create-epics
先看当前进度，再规划下一轮
🔍 Review "review 一下训练模块最近改的代码"
code-review → edge-case-hunter
标准 review + 边界用例猎手组合
💡 探索讨论 "离线优先和实时同步到底选哪个？"
council → create-architecture
先让 PM+架构师辩论 → 带着结论做架构
🔬 研究分析 "SwiftUI 和 UIKit 哪个更适合我们？"
technical-research
结构化对比输出，不是发散讨论
🧪 测试生成 "给拍照识别功能写 E2E 测试"
qa-generate-e2e-tests
读 Story + 域契约 → 自动生成测试用例
🔄 迭代健康 "感觉做跑偏了" / "Sprint 结束做个回顾"
correct-course 或 retrospective
纠偏有 checklist / 回顾有结构化模板
📝 需求维护 "这个需求变了，帮我更新 PRD"
edit-prd → validate-prd
先 patch 修改 → 再校验一致性
🧠 知识蒸馏 "今天 session 结束，沉淀一下经验"
distillator
飞轮主动触发口 → MEMORY.md 更新
✍️ 文档质量 "检查一下这个文档的结构和表达"
review-structure → review-prose
先审结构（砍冗余）→ 再审表达（改措辞）
Context Scan — 自动读取
.claude/memory-bank/state/current-state.md
_bmad-output/sprint-status.yaml
让推荐更精准：知道当前 Sprint 在做什么、已完成什么、有哪些 blockers
输出格式
A. 路径名 — 适用场景
  → skill-1 → skill-2 → skill-3
B. 快速路径 — 已知方向时
  → skill-1
💡 项目规则提醒（离线/PRD/i18n）
📋 project-context.md — 全局地图
同一张地图，不同角色看不同重点
📋 PM
域概览表 → 哪个域在动、优先级
🎨 设计
域概览表 + DESIGN-SYSTEM.md 链接
💻 前端
域概览表 + 对应域的接口契约链接
⚙️ 后端
域概览表 + 对应域的数据模型链接
🧪 QA
域概览表 + decision-log（变了什么→测什么）
一份文档 · 五个视角 · ≤200 行
用户确认选择路径
可选路径 — 触发条件：需要多角色讨论 / 重大决策 / 辩论权衡 / 不确定方向
SKILL · 独立上下文 subagent
🏛️
powerpath-council
替代 BMAD Party Mode（单 LLM 演多角色，上下文膨胀）。真正用 subagent 隔离每个角色，主对话只收精炼结论。
.claude/skills/powerpath-council/SKILL.md
Party Mode: 同一上下文演多角色 → 互相污染 + 膨胀 → Council: 每角色独立上下文，深度分析不干扰主对话
Phase 1 · 理解议题 提炼一句话核心问题
选 2-3 个有分歧的角色
告知用户 → 确认
📋JohnPM
🎨SallyUX
🏗️Winston架构
💻Amelia开发
🧪QuinnQA
每次选 2-3 人，选观点可能有分歧的组合
→
Phase 2 · 并行 Subagent 同时发起 2-3 个独立 Agent
每个 Agent 有自己的上下文
独立读项目文件 → 深度分析
角色 A: 读 projectbrief.md + current-state
角色 B: 读 techContext + decision-log
角色 C: 读 productContext + DESIGN-SYSTEM
→
Phase 3 · 综合呈现 各角色精炼观点
⚖️ 分歧点（价值所在）
✅ 共识
🎯 主持人建议
→
Phase 4 · 追问轮 只启动被追问的角色
给它上一轮观点 + 用户追问
不消耗其他角色上下文
🏛️ Council 结论 → 汇入主流程，用户带着明确决策继续执行 skill （结论可直接触发 BMAD skill 或交给 CLAUDE.md 路由）
结论明确 → 进入主流程
ROUTER
📍
CLAUDE.md — 总路由器
39行，纯导航索引，不包含任何具体规则内容
CLAUDE.md
项目知识 — 6个索引入口
协议索引 — 4个协议文件
BMAD — 工作流补充 → AGENTS.md
⚡ 3条硬性规则（必须时刻遵守）
①
离线优先
训练数据必须 Realm 先写，禁止只依赖 API
→ docs/project-context.md §1
②
UI 改动必须视觉验证
5-Phase SOP，Phase 4 不可跳过
→ .claude/protocols/ui-visual-verification.md
③
PRD 偏离必须 STOP
代码不匹配 PRD feature → 停下给选项，不自动处理
→ .claude/protocols/prd-code-sync.md
确定任务类型 → Session Boot 加载最小必要上下文
SESSION BOOT
⚙️
AGENTS.md — 运行时规则
43行，按任务类型选择性加载文件，避免上下文膨胀
AGENTS.md
任务类型 ✅ 加载 ⏭ 跳过
文案/i18n productContext projectbrief, decision-log
UI 组件 productContext, techContext decision-log
UI 审查 ALL + plans/design/ + DESIGN-SYSTEM 无，必须全量
Feature 实现 projectbrief, techContext, current-state —
Bug fix techContext, current-state projectbrief（除非涉及PRD）
后端 techContext productContext
研究分析 techContext, decision-log productContext
测试生成 techContext, current-state, projectbrief —
需求维护 projectbrief, decision-log, current-state techContext
知识蒸馏 MEMORY.md, sessions/*.md, decision-log projectbrief, productContext
冲突优先级 (Fallback)
P0
projectbrief.md
北极星，不可自动覆盖
P1
decision-log.md
已批准的偏离有豁免
P2
current-state.md
代码物理现实
P3
sessions/*.md
临时日志，可被覆盖
Heartbeat 巡检
Code-PRD 对齐 /
i18n 8个locale差异<5 /
.tsx 无硬编码 hex /
MEMORY.md <500行 /
无超30天技术债务
路径分发 → 三条并行执行轨道
EXECUTION LAYER — 三条并行轨道
43+ SKILLS
⚡
BMAD Skills
BMAD-METHOD v6.2.2
.claude/_bmad/
📋
规划类 create-prd / create-architecture
create-epics / sprint-planning
🔨
实施类 quick-dev / dev-story
check-implementation-readiness
🔍
审查类 code-review / adversarial-review
edge-case-hunter
🧠
思考类 brainstorming / powerpath-council
advanced-elicitation
👤
角色对话 PM John / Arch Winston
Dev Amelia / UX Sally / QA Quinn
🔬
研究类 market-research / technical-research
domain-research / agent-analyst (Mary)
🧪
测试类 qa-generate-e2e-tests
check-implementation-readiness
🔄
迭代健康类 sprint-status / retrospective
correct-course / agent-sm (Bob)
📝
需求维护类 validate-prd / edit-prd
product-brief / create-story
🧠
知识管理类 distillator / generate-project-context
index-docs / shard-doc
✍️
文档质量类 editorial-review-structure (结构)
editorial-review-prose (可读性)
PROTOCOLS
📜
Protocol Files
按需加载的详细规则
.claude/protocols/
ui-visual-verification.md UI 组件开发时读取，5-Phase SOP
Ph0 Manifest预检
Ph1 读资料
Ph2 设计方案
Ph3 写代码
Ph4 ⛔GATE
Ph5 报告
ui-review.md UI 审查/审计时读取，3 Steps
St0 全量上下文
St1 页面→Section→组件
St2 设计系统对照
St3 冲突透明化
prd-code-sync.md 功能实现/需求变更时读取
正向 PRD→Code
逆向 偏离→STOP
UI变更护栏
memory-management.md Session 结束/蒸馏/规则进化时读取
知识库结构
蒸馏规则
进化飞轮
知识回流
requirement-change.md 需求/接口变更时的 3 步协议
decision-log 追加
域契约更新
系统快照刷新
⛔ 不改实现文档
📸 截图验证系统（UI 路径专属）
Manifest
预检
→
verify.sh
grep检查
→
模拟器
检查
→
Deep Link
导航
→
⛔
截图
→
✅ Ph5
报告
↺ 回
Ph2
npm run screenshot:verify
npm run screenshot:all
npm run screenshot:audit (每日09:00)
MEMORY
🧠
Memory Bank
跨 Session 认知保留
.claude/memory-bank/
READ — Session 开始时
[MEMORY.md] LESSON 上次踩过的坑，强制在执行前读取
[MEMORY.md] DECISION 重大决策 + 理由（如三区背景系统）
[MEMORY.md] PATTERN 代码模式 + 用户偏好
[MEMORY.md] BLOCKER 未解决阻塞（定期清理过期项）
WRITE — 执行过程中
session log sessions/YYYY-MM-DD.md
格式: [HH:MM] [TAG] description
DISTILL — Session 结束时
蒸馏规则 日志 >100行 → 提炼为 MEMORY.md
500行硬上限
BACKFLOW — Bug/发现时
知识回流 通用约束 → 追加到 core 文件
[Backflow DATE] rule content
执行完成 → 规则学习 → 固化回体系
FLYWHEEL
🔄
规则进化飞轮
每次失败经验和优化模式，通过固定阶梯提升为永久规则，反降级保护
📝 Session Log sessions/YYYY-MM-DD.md
[LESSON] 记录失败尝试
→
出现 ≥2次
🟡 RULE-CANDIDATE MEMORY.md 标注
[RULE-CANDIDATE]
→
出现 ≥3次 或用户确认
✅ 永久规则 写入对应 core 文件
反降级保护
→
Backflow
📂 Core 文件 techContext / productContext
AGENTS.md / project-context
↑ 规则固化后 → 回到 CLAUDE.md，下次 Session 起效。这是系统自我学习的闭环。 ↑
文档契约层 + 需求变更协议
DOCUMENT CONTRACT LAYER — 以谁为准？维护什么？
MAINTAIN
📋
7 份活文档（必须维护）
需求变了只改这 7 个文件，其他全部冻结
① CLAUDE.md — 入口索引 30 行导航，自己不存实质内容
② project-context.md — 全局地图 ≤200 行，每个 AI 角色的 GPS：域概览表 + 最后变更日期
③ current-state.md — 此刻在哪 迭代状态 + 系统架构快照（一屏）
④ decision-log.md — 为什么走到这 只增不改 · 决定 + 原因 + 拒绝方案
⑤ DESIGN-SYSTEM.md — UI 唯一契约 颜色 token / 间距 / 组件规则
⑥ docs/database/* — 数据域契约 按域拆分 5-6 个文件：实体 + 关系 + 接口形状
⑦ MEMORY.md — AI 长期记忆 500 行上限，蒸馏后的教训/决策/模式
FREEZE
🧊
冻结档案（不再更新）
文件头加 ⚠️ 历史快照标注，AI 读到不当成现行规则
backend-docs/by-time/* — 历史实现记录 写的时候是对的，但不再更新
implementation/* — 功能实现记录 点状快照，不需要与当前代码同步
design-reviews/DR-001~030 — 设计评审 已蒸馏进 DESIGN-SYSTEM.md
backend-docs/by-function/* — 重复索引 与 by-time 完全重复，可废弃
PROTOCOL
🔀
需求变更 3 步协议
后端逻辑变了 / 接口变了 / 需求改了 → 只做这 3 步
Step 1 decision-log 追加
变了什么 · 为什么 · 影响域
→
Step 2 域契约更新
database/*.md 接口定义
→
Step 3 系统快照刷新
current-state 域状态表
→
⛔ 不做 不改前端文档
不改后端文档
不改实现记录
真相优先级：数据域契约 > decision-log > 代码本身 > 其他一切文档
借鉴 Hermes Agent — 6 项自进化机制
HERMES-INSPIRED — 借鉴 github.com/nousresearch/hermes-agent
① 最高优先
🧬 Skill 自进化 — 流程也能自动固化
Hermes 完成复杂任务后，自动提取可复用的程序性模式，写成 skill 文件。每次复用时自我改进，每 15 个任务做整体评估。
📎 PowerPath 应用示例 "你已经第 3 次手动走 edit-prd → validate-prd → 更新域契约 这条路径了"
→ 飞轮检测 ≥3 次相同流程
→ 自动生成 requirement-change-pipeline skill 文件
→ 下次说"需求变了" → Concierge 直接推荐这个新 skill
现状差距：飞轮只捕获规则（做/不做），不捕获流程（怎么做）。需要加并行路径：成功流程 → PROCEDURE-CANDIDATE → 自动 skill
来源: Hermes procedural memory + agentskills.io standard
② 高优先
👤 用户画像 — AI 越用越懂你
Hermes 用 SOUL.md（AI人格）+ USER.md（用户画像）+ Honcho 辩证法建模，持续加深对用户工作模式和决策偏好的理解。
📎 PowerPath 应用示例 distillator 蒸馏时同步提炼用户模式
memory-bank 加 user-profile.md：
· "Morgan 偏好先看全局视觉再看细节"
· "说'改一下'通常意味着 2-3 方案对比"
· "Review 关注设计一致性 > 代码性能"
现状差距：有 productContext（品牌声音），没有 userProfile（用户工作模式）。AI 每次都从零推断你的偏好
来源: Hermes SOUL.md + USER.md + Honcho dialectic modeling
③ Token 节省最大
⚡ 脚本管道 — 固定步骤零 Context 成本
Hermes 用 Python RPC 脚本调用工具链，把多步骤管道压缩成单次推理，不占上下文窗口。LLM 只参与需要判断的步骤。
📎 PowerPath 应用示例 — UI 5-Phase 管道化
现在：Phase 0~5 全在对话里执行，每步消耗 context
改进：npm run ui-pipeline 脚本化 Phase 0~3
Ph0 Manifest Ph1 grep Ph2 模拟器 Ph3 截图 ← 脚本自动执行
Ph4 LLM 判断 Ph5 写报告 ← 仅这两步需要 LLM
预估节省 60-70% UI 验证 token
来源: Hermes execute_code RPC + zero-context-cost pipelines
④ 韧性提升
🛡️ 三级故障升级 — 不是只有 STOP
Hermes 不是失败就停下，而是结构化升级：Retry → Replan → Decompose。加上 checkpoint 机制和 stuck detection。
📎 PowerPath 应用 — failure-escalation.md
L1 Retry 同一 skill 重试 1 次
L2 Replan 触发 correct-course → 换路径
L3 Decompose 触发 council → 分解子任务
L4 STOP 穷尽自动手段后才等用户
现状差距：只有 PRD偏离→STOP，没有渐进式升级链。Agent 要么盲目重试，要么直接停下
来源: Hermes Issue #344 Multi-Agent Architecture + checkpoint
⑤ 长 Session 救星
🗜️ 实时 Context 压缩 — Session 内 mini-distill
Hermes 长对话超阈值时自动压缩中间轮——总结已完成工作，清除详细输出，只保留结论。冻结 system prompt 做 prefix caching。
📎 PowerPath 应用 — AGENTS.md 新规则
Context 消耗 > 60% 窗口时自动触发：
① 总结 已完成工作 → 3-5 行精炼结论
② 清除 已完成任务的详细 tool output
③ 保留 当前任务完整上下文 + 关键决策
④ 冻结 system prompt snapshot 做 cache
现状差距：MEMORY.md 500行是 session 间压缩，没有 session 内实时压缩。长 session 后半段质量显著下降
来源: Hermes context compressor + Anthropic prompt caching
⑥ 工作流进化
📊 每 N 任务自检 — 工作流本身也要 Review
Hermes 每 15 个任务自动评估整体表现——哪些 skill 成功率高、哪些需要改进、哪些该废弃。
📎 PowerPath 应用 — heartbeat 扩展维度
每 10 个 session 自动触发 workflow health check：
· Concierge 推荐了但用户没选的 skill？（推荐不准）
· 出现 correct-course 的 session 占比？（方向判断差）
· 平均 session token 消耗趋势？（context 管理退化）
· 哪条 skill 链路最常用？（自进化候选）
现状差距：heartbeat 只查代码/文档一致性，不查工作流效率。retrospective 是手动触发
来源: Hermes periodic skill evaluation (every 15 tasks)
🔗
借鉴来源
NousResearch/hermes-agent — 自进化 Skills · Honcho 用户建模 · RPC 零 context 管道 · 三级故障升级 · Context Compressor · 周期性自检
Architecture docs · Issue #344 (Multi-Agent Architecture) · v0.5.0-v0.7.0 release notes
附截图证据 → 最终交付
✅
交付完成
UI 任务：截图证据  |  Feature：current-state 更新  |  Bug：session log
接口变更：域契约 + decision-log + 系统快照 3 步更新  |  Session 结束：distillator 蒸馏 → MEMORY.md
.claude/screenshots/ · Phase 5 报告 · 规则进化 · 域契约同步 · 知识蒸馏