W
Orchestrations Flow
三个 Orchestration 的详细流程图 — 节点、分支、条件路由、Role (Agent) 委托、错误处理一览
入口 / 启动
处理节点
决策 / 确认
Role (Agent) 委托
Skill 委托
并行任务
知识库
错误 / 重试
完成 / 输出
wyze-smart-lock
knowledge-base-generator
wyze-plugin-creation
wyze-smart-lock
Private
多款智能门锁 iOS 开发 Orchestration — 任务识别 → 知识库分层 → 代码生成 → 审查 → PR
启动
触发 & 加载 project-config
关键词命中(lock / palmer / lever / bolt / palm)
必读 context/project-config.md
加载 context/project-info.md + 执行启动命令
强制规则:仅读 project-config.md,其余 6 个文件按节点按需加载,禁止预加载全部
Git 委托
wyze-git
全部 Git 操作委托给公有 wyze-git
传入 GIT_PROJECT_PATH
知识库 — 7 个 Context 文件(按节点按需加载)
context/ 知识体系
📁 context/
project-config.md ★
project-info.md
coding-standards.md
products.md
checklist-template.md
knowledge-writing-standards.md
refactor-writing-standards.md
📁 knowledge/{锁型}/
lever-lock/
lock-bolt/
palm-lock/
每个锁型含 figma/ + 模块知识文件
节点 A
识别任务来源 + 锁型 + 模块
来源:知识库更新 / 优化重构 / Figma 查阅 / Figma 导出 / 自定义
锁型:Lever Lock / Lock Bolt v2 / Palm Lock / ask_user
模块:setup / home / settings / password / iot / other / ask_user
Figma 查阅/导出
节点 FIG
Figma 设计稿
查阅:products.md → API 精确拉取
导出:委托 wyze-figma-kb
Figma 守则:优先读本地 KB → 缺失才调 API → 必须带 nodeId,禁止无 nodeId 调用
Skill 委托
wyze-figma-kb
Lever → Knowledge/palmer-lock/lever-lock/figma/
Bolt → Knowledge/palmer-lock/lock-bolt/figma/
Palm → Knowledge/palmer-lock/palm-lock/figma/
知识库更新
节点 KU
代码反向更新知识库
变更类型映射(门锁专属)
注入 kb-updater context
CHANGED_FILES + KB_FILES
KB_STANDARDS + REFACTOR_STANDARDS
CHANGE_MAPPING + EXTRA_FOCUS
Role
kb-updater
执行知识库文件更新
优化 / 重构
节点 RF
优化 / 重构分析
加载 project-info + coding-standards
加载 knowledge/refactor-writing-standards
分析:职责/分支/重复/复用
默认先输出分析,不改代码
用户选择
沉淀到知识库?
Y → 按 refactor-writing-standards 写入 KB
N → 仅保留分析结果
自定义任务(开发)
节点 B
分层加载知识库
B1a: 核心层(任何任务必读)
B1b: 代码层(需生成代码时)
B1c: Setup 专属层(仅 setup-mounting)
Refactor: 重构层(优化/排查时,可选)
B2: 锁型专属文件(三选一)
B3: Step 文件(仅 Lever setup,先 RAG 搜索)
B4: Jira 查询 + Confluence 查询
B4 委托
wyze-jira + confluence-lookup
Jira: atlassian-jira_search/get
Confluence: nodes/confluence-lookup.md
用户确认
分析输出 → 开始开发?
输出当前判断 / 关键点 / 风险
等待「开始做」「实现一下」
节点 C — C2
Subagent 模式?[y/N]
N(默认)→ 当前线程直接生成代码
Y → dispatch implementer subagent
代码生成主线
节点 C
代码生成
C1: 加载 project-info + coding-standards
C1: RAG 搜索同类已有实现
C1: 逐字列出核查清单
C2=N: 当前线程直接生成代码
C2=Y: dispatch implementer subagent
Role(C2=Y 时)
implementer
CODING_STANDARDS + PROJECT_INFO
KNOWLEDGE_FILES + TASK + TARGET_FILES
GIT_PROJECT_PATH
ERROR_KNOWLEDGE(如有 error-knowledge.md)
EXTRA_VARS: {LOCK_TYPE, MODULE}
节点 D(强制)
代码审查
无论是否 subagent,代码完成后必须执行
Role
reviewer
MODE = spec
KNOWLEDGE_FILES(节点 B 全部)
CHECKLIST = checklist-template.md
MAX_ROUNDS = 3
GIT_PROJECT_PATH
节点 D3
有新增文件?
Y → 执行 Pod Install(nodes/pod-install.md)
N → 跳过,直接进入 E
节点 E
代码已通过审查,提交 PR?
Y → 委托 finishing-a-development-branch
Skill 委托
finishing-a-development-branch
PR 收尾全流程
输出
任务结束报告
任务 / 锁型 / 模块
知识库加载:N 个文件
implementer: rounds / files
reviewer: mode=spec, rounds/MAX, 修正 N 处
kb-updater: 触发/未触发
高消耗环节 + 原因分析
knowledge-base-generator
Public
为 iOS / Android 项目生成与维护知识库 — 四个入口、九个节点、三点基础信息永久核心
启动前检查(必做)
4 步前置验证
1. 确认 KB 存放路径(AI 建议 + 用户确认)
2. 读 .kb-state.yaml(续做?status != done 时提示)
3. 三点完整性扫描(缺失 → kb-fallback.md 路径)
4. 多人协作检查(updated_at vs git commit)
.kb-state.yaml
流程状态持久化文件
YAML 是一种人类可读的配置格式。此文件保存在项目根目录,记录当前流程进度,使 AI 可以跨会话断点续做 — 关闭对话后重新进入,AI 读取此文件自动恢复到上次中断的位置。
项目分析
触发词
分析 {路径} 建立知识库
kb-project-scan
扫描项目
检测平台 / 语言 / 框架
输出扫描摘要
kb-project-confirm
开发者确认扫描结果
可修正平台/语言/范围
kb-init-framework
初始化 KB 框架(4 阶段)
Phase 1: identity.md → refine-loop
Phase 2: project-structure.md → refine-loop
Phase 3: sdk-dependencies.md → refine-loop
Phase 4: 可选文档(01~05 目录)
每份文件生成后立即进入 refine-loop,确认后才进入下一 Phase
↻ 每份文档循环
kb-refine-loop
打磨循环
AI 生成 → 开发者反馈 → 调整 → 确认
每份文档都进入此循环
init-framework Phase 1-3 各触发一次
PR 声明
触发词
从 PR 建立知识库
kb-pr-declare
显式声明平台/语言
开发者手动指定
不依赖扫描
↓ 合流
kb-init-framework(同左 4 阶段)
→ kb-refine-loop
更新维护
触发词
更新知识库
kb-update-analyze
分析代码变化
检查三点同步需求
识别需更新的文档
kb-optimize-suggest
提出优化建议
删除 / 合并 / 拆分 / 新增
优化先于增删
kb-execute-update
执行更新
执行优化 + 更新内容
有新增文档?
新文档 → refine-loop
Y → 新文档进入 kb-refine-loop
N → 仅更新已有文档,完成
轻量增量
触发词
补一份 {文档名}
kb-incremental-add
单文档新增
不走完整 update
避免小事大办
模块一致性检查
project-structure 有此模块?
无 → 提示:继续 or 切完整更新
→ kb-refine-loop
所有路径最终产出
产出 — 生成的知识库结构
知识库目录(被 Plugin Creation 等下游消费)
00-PROJECT-FOUNDATION/ ★ 必须
identity.md + project-structure.md + sdk-dependencies.md
01-ARCHITECTURE/ (可选)
02-MODULES/ (可选)
03-CONVENTIONS/ (可选)
04-INTEGRATION/ (可选)
05-MAINTENANCE/ (可选)
CHANGELOG.md ★ 必须
下游消费者
wyze-plugin-creation
wyze-smart-lock
其他 Orchestration
状态
.kb-state.yaml
kb_path / status / current_entry
last_node / last_doc / last_round
pending_docs / updated_at
错误与回退
context/kb-fallback.md
扫描失败 / 信息不足 / 三点缺失 / 状态冲突 / 决策僵局 → 各有对应处理路径
wyze-plugin-creation
Public
知识驱动开发 — 知识库是代码生成的唯一依据,每个 Batch 的 implementer 和 reviewer 都从知识库获取规范与模板
启动前检查
3 步前置验证
1. 确认在 ~/wyze-plugin-skills/ 内
2. 读 .wpc-state.yaml(断点恢复)
3. SKILL_ROOT 路径检测(~/.claude → ~/.copilot)
.wpc-state.yaml
流程状态持久化文件
YAML 是一种人类可读的配置格式。此文件保存在项目根目录,记录 8 个阶段的完整进度,使 AI 可以跨会话断点续做 — 关闭对话后重新进入,AI 读取此文件自动恢复到上次中断的阶段。
平台选择
iOS / Android
决定 KNOWLEDGE_BASE
PROMPTS / SKILL_TEMPLATE 路径
知识库三级检测
三级完整性检查
L1: 目录存在且非空(排除 .gitkeep/README)
L2: 必选文件齐全(knowledge/ + adapter/ + ui/ + prompts/ + skill-template/)
L3: 抽检内容质量(占位符定义、代码模板)
✅ 完整(三级全通过)
就绪
直接进入阶段一
{platform} 知识库已就绪
⚠️ 部分缺失(L1 通过 L2/3 未通过)
补全?
N 个缺失项,启动补全?[Y/n]
Y → GENERATE-ANDROID.md 补全后继续
N → 中断整个流程
❌ 空(L1 未通过)
生成?
知识库未创建,交互式生成?[Y/n]
Y → 进入 Phase 0 生成
N → 中断,提示切换已就绪平台
STAGE 1 — 参数收集
Step 1
任务来源
Q1: Jira Key?(可选)
Q1 路由
有 Jira Key?
有 → 委托 wyze-jira 拉取 ticket,预填参数
无 → 手动填写
Skill 委托
wyze-jira
拉取 ticket 自动预填
Step 2
项目基本信息
Q2: org(默认 wyze)
Q3: project_code
Q4: 工程存放目录(默认 ~/)
Step 3
产品列表
Q5: nickname / deviceModel /
appid / PID / MID / defaultName
Step 4
宿主集成意向
Q6: 集成到 wyze-app-ios?[Y/n]
Y(默认)→ 后台并行 host-prep
N → 阶段六跳过宿主
并行:host-prep(Q6=Y 时,阶段一末尾启动)
宿主前置准备(后台,不阻塞代码生成)
1. clone/fetch wyze-app-ios
2. 切 feature/{project_code}-plugin 分支
3. 注释 Podfile 中所有 PluginInstall()
4. WZDeviceChannelManager 追加 deviceModel
完成 → host_prep.status=done
失败 → status=failed(不阻断代码生成)
⇅ 并行
STAGE 2 — 命名推导 + 生成计划
阶段二
01-naming.md → 推导命名 → 展示计划
用户「确认开始?」后进入阶段三
STAGE 3 — Git 建仓 + 落地计划
阶段三
gh repo create → clone → develop
写入 docs/create-plan.md(断点恢复依据)
每 Batch 完成更新 checkbox [x]
STAGE 4 — 代码生成(subagent-driven)
Step 0(必选)
选择核查策略
1. fast(默认)— 4 并行 + 1 unified-reviewer
2. safe — 4 并行 + 每批 spec-reviewer + cross-batch
3. serial — 逐批串行 + 每批 review + cross-batch
知识驱动核心 — 代码生成的唯一依据
KNOWLEDGE_BASE & PROMPTS 结构
📁 knowledge/wyze-plugin-common-ios/
01-naming
02-project-structure
03-podspec
04-plist
05-assets
📂 adapter/
(12 files)
01-entry
02-module
03-config
04-router
05-handler
06-service
07~12…
📂 ui/
(8 files)
01-base-vc
02-views
03-cells
04-home
05-settings
06-setup
07-reset
08-demo
📂 skill-template/
📁 prompts/ios/
batch-a-implementer.md
batch-b-implementer.md
batch-c1-implementer.md
batch-c2-implementer.md
spec-reviewer.md
unified-reviewer.md
cross-batch-reviewer.md
host-integrator.md
host-prep.md
Batch A
implementer
Config / Resource
podspec + pch + plist
+ xcassets + strings
知识库输入
01-naming + 03-podspec
04-plist + 05-assets
Prompt
batch-a-implementer.md
Batch B
implementer
Adapter 层
15 个 Swift/ObjC 文件
业务适配器
知识库输入
01-naming + adapter/01~12
(全部 12 个适配器知识文件)
Prompt
batch-b-implementer.md
Batch C1
implementer
UI Base 层
13 个文件
Base VC + Views + Cells
注入 Batch B 类名
知识库输入
01-naming + ui/01~03
(base-vc + views + cells)
Prompt
batch-c1-implementer.md
Batch C2
implementer
UI 业务页面
13 个文件
Home/Settings/Setup/...
注入 B + C1 类名
知识库输入
01-naming + ui/04~08
(home + settings + setup + reset + demo)
Prompt
batch-c2-implementer.md
Mode 1: fast
unified-reviewer
统一核查(1 次)
4 Batch 全部完成后
单批规范 + 跨批一致性 + 目录结构
MAX_ROUNDS = 2
Mode 2: safe
spec-reviewer × 4
每批异步 Review
每 Batch 完成即 dispatch
A=2轮 / B=2 / C1=1 / C2=2
cross-batch-reviewer
跨批一致性核查
符号引用 + 目录结构
+ 架构合规 + 命名规范
知识库输入
02-project-structure + README.md
Mode 3: serial
spec-reviewer × 4(串行)
逐批 Review
A→review→B→review→C1→review→C2→review
后批注入前批已修正文件
cross-batch-reviewer
跨批一致性核查
同 safe 模式
知识库输入
02-project-structure + README.md
错误恢复策略(阶段四)
失败自动处理
Implementer 超时/崩溃 → 重试 1 次(缩减注入);仍失败 → 标记 ❌
Implementer 输出为空 → 视同崩溃,重试
Reviewer 达轮数上限 → 标记 ⚠️,阶段五人工核验标注
Reviewer 自身失败 → 跳过该次核查,阶段五标注
任何 Batch ❌ → 阶段五人工核验自动变为必选
STAGE 5 — 人工全量核验
阶段五
需要人工核验?[y/N]
有 Batch ❌ 时 → 自动变为 [Y](必选)
Y → 逐批列清单 + 知识库对照
N → 直接进入阶段六
STAGE 6 — 宿主集成 + 编译验证
读 host_prep 状态
三种状态路由
done → 注入 host_prep_done=true,跳过 Step 2/3a/4
failed → host_prep_done=false,走完整流程,告知用户失败原因
in_progress → 等待最多 60s;超时 → 按 failed 处理
用户配置
Q1-Q3 宿主参数
Q1: 基于 develop / release 分支
Q2: Pod :path(默认)/ :git 引用
Q3: pod install 清理(direct / lock / full)
Role
host-integrator
插件 pod install → 宿主 Podfile →
deviceModel 注册 → pod install →
编译验证
编译验证选择
编译由谁执行?
用户自己跑(默认)→ 跳过 xcodebuild,编译标 ⏸️
AI 直接跑 → xcodebuild 验证,插件错误自动修复(最多 3 轮)
STAGE 7 — 项目专属 Orchestrations
7.0 门禁
SKILL_STAGE_DECISION
continue(仅 AI 编译且 BUILD SUCCEEDED)→ 7.1
skip → 自动跳过阶段七,进入阶段八
7.1
生成 Orchestrations?[Y/n]
Y → 进入 7.2 委托
n → 跳过阶段七
7.2 Skill 委托
wyze-orchestration-creator
入口:oc-batch-init
传入:batch_input(type/platform/meta/nodes/context_files)
执行:oc-batch-init → oc-scaffold → oc-validate → oc-finalize
处理:占位符替换 + 撞名检测 + 校验
7.3
替换正确?[Y/n/修改说明]
Y → 进入阶段八
n → 删除已生成目录,跳过阶段七
修改说明 → 收集修改点,重新触发 oc-batch-init
STAGE 8 — 同步 & 输出摘要
8.1 条件同步
阶段七完成?
完成 → 执行 wyze-sync 同步两端
跳过/中止 → 无需同步
8.2
工程创建完成摘要
Git 仓库 + 本地路径 + 分支
代码生成 N 个文件 + 各 Batch 修正明细
宿主集成状态(编译 ✅/⏸️)
Orchestrations 状态(已生成/已跳过)
下一步:open .xcworkspace
贯穿全程
.wpc-state.yaml
每阶段自动更新 → 跨 session 续做
status / last_phase / collected /
batch_progress / host_prep / review_mode