SKILL.md 5.9 KB


name: task-dispatch description: "触发词:派发、并行、多任务、分发、同时执行。自动选择最佳派发模式,无需用户指定。" version: 4.0.0 author: Yuyang001 (FmodeAgent) license: MIT

tags: [dispatch, parallel, cc, delegation, workflow]

task-dispatch v4 — 自动任务调度中枢

2026-09-22 升级说明:不再需要用户说"派发、并行"——任何 Git 级、多文件、跨案例任务都自动走五步流程

设计理念

用户只需说出需求 → 我自动推导最适合的派发模式。不需要用户额外说"并发""分配""派发"这些词。

一、自动任务分类器(新增——不再需要用户指定模式)

收到任务后第一步:分类。以下规则自动触发,用户不必说模式名。

任务属于哪类?
├─ 课程开发/课件制作(skill-present 仓库内)
│   ├─ 首次制作/重做 → 模式A-1:五步完整流程(调研→计划→任务书→4CC并行→验收)
│   ├─ 增强/加资源(图文并茂) → 模式A-2:保留框架增量增强(案例图+skill-image+自绘保留)
│   └─ 改文案/微调 → 模式A-3:定点任务书+单CC
├─ 基础设施/软件开发(fmode-hub/fmode-app/fmode-studio)
│   ├─ 全栈开发 → 模式B:delegate_task 子代理(跨仓库素材+独立工具链)
│   └─ 配置/部署 → 主Agent亲手(纯机械操作)
├─ 信息检索/文件操作 → 直接执行或delegate_task
└─ 简单问答 → 直接回答

课程开发五步完整流程(模式A-1,用户说「做四个主题课件」自动触发)

  1. 调研素材(1次回合):读项目 CLAUDE.md + 读参考源 + 盘点案例 + 查历史
  2. 写计划:方向、结构、阶段划分 → 产出 plan.md
  3. 写任务书(每主题一份):inline 素材引用 + 绝对路径 + 验收标准
  4. 并行派发(4个CC同时跑):写提示文件 → terminal(background) × 4 → 各自独立log
  5. 验收收尾:git commit+push → OBS→CDN→curl 全路由200

课程增强增量模式(模式A-2,用户说「加图、增强、图文并茂」自动触发)

  1. 现状盘点:当前 HTML 的自绘 SVG 有哪些?引用了什么外图?
  2. 素材定位:8案例 CDN 图索引 + skill-image 能力检查 + 现有图验证(Content-Type)
  3. 逐主题任务书:指定每页加什么图(案例CDN图 + skill-image生成图),明确"保留全部现有内容"
  4. 并行派CC:4个主题同时跑
  5. 图片验证:curl Content-Type 含 image/ 才算通过

二、三种派发模式(技术实现细节)

模式A:CC自并发 — 同项目多任务【首选】

自动触发条件:skill-present 仓库、课程开发、多文件产出

实现模板:

# 1. 写提示文件(避免shell转义)
cat > /tmp/cc-task-book.md << 'EOF'
[inline 素材引用 + 验收标准 + 纪律]
EOF

# 2. 启动(绝对路径防exit 127)
export PATH="/opt/data/npm-global/bin:$PATH"
cd /opt/data/git-repos/skill-present
/opt/data/npm-global/bin/claude -p \
  --dangerously-skip-permissions \
  "$(cat /tmp/cc-task-book.md)" \
  > /tmp/cc-task.log 2>&1 &

# 3. 60s健康检查
sleep 60 && pgrep -f "claude -p" || echo "启动失败"

模式B:delegate_task — 跨项目/跨目录

自动触发条件:多仓库素材、基础设施工具链、容器操作

模式C:亲手执行

自动触发条件:纯机械操作、单文件修改、部署命令、验证脚本

三、并行派发纪律(2026-09-21 四主题并行实证)

  1. 每任务独立 log> /tmp/cc-<任务名>.log 2>&1
  2. 绝对路径防 127/opt/data/npm-global/bin/claude
  3. 先 git pull 再干活:修改前拉取最新
  4. 提交用显式 pathspecgit add <明确文件>,禁 git add .
  5. 共享文件不抢提交(index/manifest):批次收口统一提交
  6. 启动后 60s 健康检查:确认真在跑
  7. 4 个以内直接并行(已验证可行),4 个以上分批

四、图片验证铁律(2026-09-22 用户钦点)

# ❌ 只查HTTP 200不够——可能返回404首页替代
curl -s -m 10 -o /dev/null -w "%{http_code}" <URL>  # 不够!

# ✅ 必须检查 Content-Type
CT=$(curl -s -m 10 -o /dev/null -w "%{content_type}" <URL>)
echo "$CT"  # 必须是 image/png 或 image/jpeg

五、保留框架增量增强纪律(2026-09-22 V6 实证)

当用户说"内容不错、结构好了,但需要加图/增强"时:

  1. 框架/content 结构不动——用户已认可的不要改
  2. 自绘 SVG/自绘资源全部保留——宝贵素材
  3. 只在对应位置补充:CDN 案例图 + skill-image 生成的场景图
  4. 技术架构图升级:skill-image 出图加入人、场景、业务流程,让非技术老板看懂
  5. 每增加一屏或加图后:验证图片的 Content-Type

六、skill-image 集成模式(2026-09-22 新增)

# --scene: 场景图(插图/含人的架构图/业务流程)
node /opt/data/skills/skill-image/lib/fmode-image.mjs --scene \
  "蓝紫色科技风, 办公室场景描述, 具体内容描述" \
  output-file.png

# --app: 应用界面(白底UI图)
node ... --app "APP界面描述" output.png

# --product: 产品爆炸图/架构图
node ... --product "架构分层描述" output.png

生成后上传 OBS + CDN 刷新,然后验证 Content-Type。

七、自检清单(六步)

  • 分类:这是课程开发/基础设施/查询?
  • 需要走五步完整流程还是增量增强?
  • 素材调研完没?(读CLAUDE.md/索引/验证图片)
  • 任务书写好且 inline 引用了吗?
  • 派发后 60s 健康检查过了吗?
  • 验收:所有资源 Content-Type 正确?

八、沟通铁则

  1. 接任务秒回执(收到+拆解+派发模式+预计时间)
  2. 派发后告知任务面板(共X个后台CC在跑)
  3. 完成报结果(全部完工/部分+缺陷)
  4. 卡住汇报原因+替代方案