القائمة
子代理调度 — 将Agent激活指令翻译为运行时具体操作。当 orchestrator 将某 phase agent 激活为 subagent_type 子代理、需要派发任务并解析返回值时由本 skill 翻译执行。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/lync-cyber/CataForge --skill agent-dispatchيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
CataForge 框架同步 — 把已安装包、.cataforge/ scaffold、IDE 产物、项目初始化四层对齐到当前已验证状态。幂等、升级感知：检测包↔scaffold 版本差异，升级包并刷新 scaffold，部署 IDE 产物，运行 doctor 验证，按版本迁移要点提示升级重点与迁移动作；项目未初始化时进入 Project Bootstrap，已初始化时装配执行环境并交接 start-orchestrator。当用户提到 CataForge 升级、scaffold 过期、框架版本不一致、bootstrap 或刷新项目脚手架、初始化/恢复项目时，使用此 skill。
部署配置 — CI/CD流水线、容器化、环境配置、基础设施即代码。当需要配置 CI/CD 流水线、编写 Dockerfile/compose、管理多环境配置或基础设施即代码时使用此 skill。库/SDK 项目可标 deployment N/A 跳过。
测试 — 测试策略规划、测试编写与执行、覆盖率分析、缺陷记录。当需要规划测试策略、编写或执行测试套件、分析覆盖率或记录缺陷时使用。本 skill 不改源码（缺陷修复由 debug 负责），单任务 RED/GREEN 单元测试由 tdd-engine 负责，testing 聚焦集成/E2E 与覆盖盲区补充。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | agent-dispatch |
| description | 子代理调度 — 将Agent激活指令翻译为运行时具体操作。当 orchestrator 将某 phase agent 激活为 subagent_type 子代理、需要派发任务并解析返回值时由本 skill 翻译执行。 |
| argument-hint | <agent_id: 目录名如architect> <task: 任务描述> |
| suggested-tools | file_read, file_glob, file_grep, shell_exec, agent_dispatch |
| depends | [] |
| disable-model-invocation | false |
| user-invocable | false |
调用方(orchestrator)提供:
reflector 家族任务（retrospective / skill-improvement / apply-learnings）经 orchestrator inline 或 CLI
cataforge agent run --task-type触发，不走本调度枚举。
单一事实来源: 各 AGENT.md 的
skills:字段（由 subagent_type 自动加载）。 本文件不维护映射副本。查询当前映射请运行:cataforge agent list --skills
当前运行时平台由 .cataforge/platforms/{platform_id}/profile.yaml 声明。
调度工具名和参数由 profile.yaml 的 dispatch 段定义。
prompt 主模板: .cataforge/skills/agent-dispatch/templates/dispatch-prompt.md。
平台特异性覆盖: .cataforge/platforms/{platform_id}/overrides/dispatch-prompt.md（若存在）。
调度前 orchestrator 自行 Read 主模板 + 当前平台 override（若有），两者由 LLM 上下文合并使用 —— OVERRIDE 块边界在源文件中以 <!-- OVERRIDE:<section> --> 注释标识，便于 LLM 识别替换语义。主模板已含平台分支（如 "Claude: .claude/rules，Cursor: .cursor/rules"），override 只在需要补充平台特异性内容时才填充对应块。
deploy 阶段无运行时合并器；frontmatter 能力标识符翻译由 cataforge.runtime.agent.translator.translate_agent_md 负责，agent 返回值解析由 orchestrator 主循环按下方 §返回值解析与容错 处理。
修改 prompt 模板影响所有通过 agent-dispatch 调度的 Agent，请谨慎变更并做 diff review。 TDD 子代理由 tdd-engine 直接调度，仅传入任务信息，通用约束和返回格式依赖 AGENT.md 自动加载，无需同步。
orchestrator 收到子代理返回后，按以下优先级解析:
<agent-result> 标签内容，获取 status/outputs/summary<agent-result>:
Glob docs/{doc_type}/ 检查是否有新文件产出<agent-result> 缺少必填字段(status/outputs):
git status docs/ 检查是否有自本次调度后新增或修改的文件（untracked 或 modified）实现: orchestrator 主循环按上述优先级处理子代理返回，无独立 runtime 模块。
子代理返回后，orchestrator 通过 git diff --name-only 检查本次调度期间修改的文件:
allowed_paths 字段allowed_paths 为空数组 [] 时跳过校验（orchestrator 等无限制 Agent）docs/EVENT-LOG.jsonl、docs/.doc-index.json、.cataforge/**（context / event CLI 在任何角色调度期间都可能自动刷新，回滚即审计与索引数据破坏）git checkout -- {违规文件} 回滚，在 summary 中标注"Agent 写入违规已回滚"，记录违规文件路径execution_host: subagent 的 Phase Agent 作为独立子代理运行，拥有自己的上下文窗口（inline phase 由 orchestrator 主线程承载，不经本 skill，见 ORCHESTRATOR-PROTOCOLS.md §Inline Role Execution Protocol）框架 13 agent 的 model tier 由各自 AGENT.md model_tier 固定、deploy 解析为原生 model:，调度时无需干预。派发无 frontmatter tier 的通用子代理（general-purpose / Explore / Plan 等）时，调用方必须显式指定 model —— 判据见 子代理模型选型判据：默认 sonnet，仅重推理判据用 opus，禁 haiku；省略即继承会话模型（常为 opus）造成静默过度使用。
派发类事件（agent_dispatch / tdd_phase / review_verdict）记录时附 --model <tier|id>：派发子代理填其 model_tier（standard / heavy）或原生 id，主线程内联档填 inline，供 reflector 成本复盘（EVENT-LOG schema 字段 model）。
git diff 检测的违规由本 skill 兜底，跳过会让 phase-bound agent 写入越权而无回滚<agent-result>.summary 内自摘要，主线程仅解析结构化字段