Claude-Code-Workflow/orchestrator-param-check-report.md

编排器命令参数透传检查报告

生成时间: 2025-11-20

检查范围

检查所有通过 SlashCommand 工具调用其他 slash commands 的编排器命令，验证参数是否正确透传。

检查结果总结

✅ 所有编排器命令参数透传正确

已检查 11 个编排器命令，未发现参数透传错误。

---

详细检查清单

1. /memory:skill-memory (4-Phase Orchestrator)

文件: .claude/commands/memory/skill-memory.md

调用的命令:

• Phase 2: /memory:docs [targetPath] --tool [tool] --mode [mode] [--cli-execute]
• Phase 3: /workflow:execute

参数透传验证:

• ✅ [targetPath] - Phase 1 获取 → Phase 2 透传
• ✅ --tool - 用户参数 → Phase 2 透传
• ✅ --mode - 用户参数 → Phase 2 透传
• ✅ --cli-execute - 用户参数 → Phase 2 透传

状态: ✅ 正确

---

2. /workflow:plan (5-Phase Orchestrator)

文件: .claude/commands/workflow/plan.md

调用的命令:

• Phase 1: /workflow:session:start --auto "[structured-task-description]"
• Phase 2: /workflow:tools:context-gather --session [sessionId] "[structured-task-description]"
• Phase 3: /workflow:tools:conflict-resolution --session [sessionId] --context [contextPath] (conditional)
• Phase 4: /workflow:tools:task-generate-agent --session [sessionId] [--cli-execute]

参数透传验证:

• ✅ [structured-task-description] - 用户输入 → Phase 1, 2
• ✅ [sessionId] - Phase 1 输出 → Phase 2, 3, 4
• ✅ [contextPath] - Phase 2 输出 → Phase 3
• ✅ --cli-execute - 用户参数 → Phase 4

状态: ✅ 正确

---

3. /workflow:test-gen (5-Phase Orchestrator)

文件: .claude/commands/workflow/test-gen.md

调用的命令:

• Phase 1: /workflow:session:start --new "Test validation for [sourceSessionId]"
• Phase 2: /workflow:tools:test-context-gather --session [testSessionId]
• Phase 3: /workflow:tools:test-concept-enhanced --session [testSessionId] --context [testContextPath]
• Phase 4: /workflow:tools:test-task-generate [--use-codex] [--cli-execute] --session [testSessionId]

参数透传验证:

• ✅ [sourceSessionId] - 用户输入 → Phase 1
• ✅ [testSessionId] - Phase 1 输出 → Phase 2, 3, 4
• ✅ [testContextPath] - Phase 2 输出 → Phase 3
• ✅ --use-codex - 用户参数 → Phase 4
• ✅ --cli-execute - 用户参数 → Phase 4

状态: ✅ 正确

---

4. /workflow:test-fix-gen (5-Phase Orchestrator)

文件: .claude/commands/workflow/test-fix-gen.md

调用的命令:

• Phase 1: /workflow:session:start --new "..."
• Phase 2 (Session Mode): /workflow:tools:test-context-gather --session [testSessionId]
• Phase 2 (Prompt Mode): /workflow:tools:context-gather --session [testSessionId] "[task_description]"
• Phase 3: /workflow:tools:test-concept-enhanced --session [testSessionId] --context [contextPath]
• Phase 4: /workflow:tools:test-task-generate [--use-codex] [--cli-execute] --session [testSessionId]

参数透传验证:

• ✅ [testSessionId] - Phase 1 输出 → Phase 2, 3, 4
• ✅ [task_description] - 用户输入 → Phase 2 (Prompt Mode)
• ✅ [contextPath] - Phase 2 输出 → Phase 3
• ✅ --use-codex - 用户参数 → Phase 4
• ✅ --cli-execute - 用户参数 → Phase 4

状态: ✅ 正确

---

5. /workflow:ui-design:codify-style (4-Phase Orchestrator)

文件: .claude/commands/workflow/ui-design/codify-style.md

调用的命令:

• Phase 1: /workflow:ui-design:import-from-code --design-id [temp_id] --source [source]
• Phase 2: /workflow:ui-design:reference-page-generator --design-run [design_run_path] --package-name [package_name] --output-dir [output_dir]

参数透传验证:

• ✅ [temp_id] - Phase 0 生成 → Phase 1
• ✅ [source] - 用户参数 → Phase 1
• ✅ [design_run_path] - Phase 1 输出 → Phase 2
• ✅ [package_name] - 用户参数 → Phase 2
• ✅ [output_dir] - 用户参数 → Phase 2

状态: ✅ 正确

---

6. /workflow:ui-design:explore-auto (10-Phase Orchestrator)

文件: .claude/commands/workflow/ui-design/explore-auto.md

调用的命令:

• Phase 6: /workflow:ui-design:import-from-code --design-id [design_id] --source [code_base_path] (conditional)
• Phase 7: /workflow:ui-design:style-extract --design-id [design_id] [--images "..."] [--prompt "..."] --variants [style_variants] --interactive
• Phase 8: /workflow:ui-design:animation-extract --design-id [design_id] [--images "..."] [--prompt "..."] --interactive (conditional)
• Phase 9: /workflow:ui-design:layout-extract --design-id [design_id] [--images "..."] [--prompt "..."] --targets [targets_string] --variants [layout_variants] --device-type [device_type] --interactive
• Phase 10: /workflow:ui-design:generate --design-id [design_id] [--session ...]

参数透传验证:

• ✅ [design_id] - Phase 4 生成 → Phase 6, 7, 8, 9, 10
• ✅ [code_base_path] - Phase 1 检测 → Phase 6
• ✅ [images_input] - 用户参数 → Phase 7, 8, 9
• ✅ [prompt_text] - 用户参数 → Phase 7, 8, 9
• ✅ [style_variants] - Phase 2 解析 → Phase 7
• ✅ [layout_variants] - Phase 2 解析 → Phase 9
• ✅ [targets_string] - Phase 5 确认 → Phase 9
• ✅ [device_type] - Phase 3 推断 → Phase 9
• ✅ [session_id] - 用户参数 → Phase 10 (optional)

状态: ✅ 正确

---

7. /workflow:ui-design:imitate-auto (5-Phase Orchestrator)

文件: .claude/commands/workflow/ui-design/imitate-auto.md

调用的命令:

• Phase 0.5: /workflow:ui-design:import-from-code --design-id [design_id] --source [code_base_path] (conditional)
• Phase 2: /workflow:ui-design:style-extract --design-id [design_id] [--images "..."] [--prompt "..."] --variants 1 --refine --interactive
• Phase 2.3: /workflow:ui-design:animation-extract --design-id [design_id] [--images "..."] [--prompt "..."] --refine --interactive
• Phase 2.5: /workflow:ui-design:layout-extract --design-id [design_id] [--images "..."] [--prompt "..."] --targets "home" --variants 1 --refine --interactive
• Phase 3: /workflow:ui-design:generate --design-id [design_id]
• Phase 4: /workflow:ui-design:update --session [session_id] (conditional)

参数透传验证:

• ✅ [design_id] - Phase 0 生成 → 所有阶段
• ✅ [code_base_path] - Phase 0 检测 → Phase 0.5
• ✅ [images_input] - 用户参数 → Phase 2, 2.3, 2.5
• ✅ [prompt_text] - 用户参数 → Phase 2, 2.3, 2.5
• ✅ [session_id] - 用户参数 → Phase 4 (optional)

状态: ✅ 正确

---

8. /workflow:tdd-plan (6-Phase Orchestrator)

文件: .claude/commands/workflow/tdd-plan.md

调用的命令:

• Phase 1: /workflow:session:start --auto "TDD: [structured-description]"
• Phase 2: /workflow:tools:context-gather --session [sessionId] "TDD: [structured-description]"
• Phase 3: /workflow:tools:test-context-gather --session [sessionId]
• Phase 4: /workflow:tools:conflict-resolution --session [sessionId] --context [contextPath] (conditional)
• Phase 5 (Agent Mode): /workflow:tools:task-generate-tdd --session [sessionId]
• Phase 5 (CLI Mode): /workflow:tools:task-generate-tdd --session [sessionId] --cli-execute

参数透传验证:

• ✅ [structured-description] - 用户输入处理 → Phase 1, 2
• ✅ [sessionId] - Phase 1 输出 → Phase 2, 3, 4, 5
• ✅ [contextPath] - Phase 2 输出 → Phase 4
• ✅ --cli-execute - 用户参数 → Phase 5

状态: ✅ 正确

---

9. /memory:workflow-skill-memory (Agent-Based Orchestrator)

文件: .claude/commands/memory/workflow-skill-memory.md

调用的命令:

• 主要使用 Task 工具调用 universal-executor agents
• Integration 部分: 被 /workflow:session:complete 调用
  • SlashCommand(command="/memory:workflow-skill-memory session {session_id}")

参数透传验证:

• ✅ {session_id} - 正确透传给 workflow-skill-memory

状态: ✅ 正确

---

10. /workflow:lite-plan (5-Phase Orchestrator)

文件: .claude/commands/workflow/lite-plan.md

调用的命令:

• Phase 5: /workflow:lite-execute --in-memory

参数透传验证:

• ✅ --in-memory - 固定参数，通过 executionContext 内存变量传递完整上下文

状态: ✅ 正确

---

11. /workflow:session:start (Initialization Orchestrator)

文件: .claude/commands/workflow/session/start.md

调用的命令:

• Step 0 (首次初始化): /workflow:init

参数透传验证:

• ✅ /workflow:init 无需参数，用于项目级别初始化

状态: ✅ 正确

---

检查方法

1. 搜索范围: 搜索所有包含 SlashCommand 调用的命令文件
2. 验证标准:
   • 用户输入参数是否正确传递给子命令
   • 阶段间输出是否正确传递给下一阶段
   • 可选参数是否按条件正确透传
   • 参数格式是否匹配子命令要求
3. 关注要点:
   • 参数变量名是否一致
   • 可选参数 (如 --cli-execute) 是否正确传递
   • 条件参数 (如 --session) 是否按逻辑透传
   • 阶段输出路径是否正确传递

---

结论

✅ 所有编排器命令参数透传正确

检查了 11 个编排器命令，涵盖:

• Workflow planning orchestrators (plan, tdd-plan, lite-plan)
• Test generation orchestrators (test-gen, test-fix-gen)
• UI design orchestrators (explore-auto, imitate-auto, codify-style)
• Memory management orchestrators (skill-memory, workflow-skill-memory)
• Session management orchestrators (session:start)

所有命令的参数透传逻辑符合设计规范，未发现错误或遗漏。

---

建议

虽然当前所有编排器参数透传正确，但为了保持代码质量，建议:

1. 添加参数验证: 在每个 phase 开始前验证必需参数是否存在
2. 统一错误处理: 规范参数缺失或格式错误时的错误信息
3. 文档完善: 为每个编排器添加参数流图，清晰展示参数在各 phase 间的传递
4. 自动化测试: 考虑为关键编排器添加参数透传的单元测试

---

检查人员: Claude (Sonnet 4.5) 检查完成时间: 2025-11-20