|
|
@@ -0,0 +1,141 @@
|
|
|
+---
|
|
|
+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 仓库、课程开发、多文件产出
|
|
|
+
|
|
|
+实现模板：
|
|
|
+```bash
|
|
|
+# 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. **提交用显式 pathspec**：`git add <明确文件>`，禁 `git add .`
|
|
|
+5. **共享文件不抢提交**（index/manifest）：批次收口统一提交
|
|
|
+6. **启动后 60s 健康检查**：确认真在跑
|
|
|
+7. **4 个以内直接并行**（已验证可行），4 个以上分批
|
|
|
+
|
|
|
+## 四、图片验证铁律（2026-09-22 用户钦点）
|
|
|
+
|
|
|
+```bash
|
|
|
+# ❌ 只查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 新增）
|
|
|
+
|
|
|
+```bash
|
|
|
+# --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. 卡住汇报原因+替代方案
|
