name: fmodecode-task-delegation description: "触发词:CC派发、Claude Code执行、claude -p、长任务。Git级项目五步流程+并行CC+图文并茂增强+图片验证。" version: 2.0.0 author: Yuyang001 (FmodeAgent), Hermes Agent license: MIT platforms: [linux] tags: [FmodeCode, claude-code, delegation, course-dev, image-vrf]

related_skills: [task-dispatch, fmode-brand-naming, skill-image]

FmodeCode 任务委派 v2 (fcode-task-delegation)

何时用

需把专业任务（课件创作/论文/开发/重构）委派给 FmodeCode CLI（claude 命令）非交互执行
长任务（>10分钟）后台运行、需验收产出
复盘"任务跑了很久却没产出"类事故

不要用于: 简单单轮问答（直接 claude -p "q" 即可）。

五步流程总纲（用户钦点，2026-09-21 固化）

调研素材 → 写计划 → 写任务书(含资源索引) → 派CC执行 → 验收部署上线

① 调研素材：项目现状（仓库结构/代码风格/已用库/线上效果）+ 权威参考源 + 盘点 PRD/架构文档 ② 写计划：定方向、列模块、分阶段、标依赖风险 → docs/task/<name>-plan.md ③ 写任务书：inline 所有参考素材，资源索引用绝对路径且事前验证，写明工作目录/模型/超时/验收 ④ 派 CC 执行：绝对路径调 claude，启动后 60s 健康检查确认真在跑 ⑤ 验收部署上线：本地验证 → git commit+push → OBS 上传 → CDN 刷新 → curl 全路由 200+内容验证

禁止 shortcut：❌ 跳调研直接写任务书 ❌ 调研后跳计划直接派 ❌ 计划后自己手工改例外：纯机械操作（改配置行/单文件批量替换/纯部署命令）可跳步

保留框架增量增强（2026-09-22 V6 实证，图文并茂专用）

用户说"内容不错了，需要加图、图文并茂"时触发：

框架/content 结构不动
自绘 SVG 全部保留（宝贵素材）
只在对应位置补充：CDN 案例图 + skill-image 生成场景图
技术架构图用 skill-image 升级为含人/场景的版本（让非技术老板看懂）
每屏或每加图后 verify Content-Type

同仓多 CC 并行的 git 索引污染（2026-09-21 四主题并行实证）

提交用显式 pathspec：git add <本次任务确切文件路径>，禁 git add . / git add <大目录>——后者连带提交兄弟会话暂存改动
被污染立即纠错：git reset --soft HEAD~1 + 显式 pathspec 重提，纠错追加进记录（不删历史）
共享外壳文件不抢提交（index/manifest）：交批次收口统一提交或事先分工
CC 报告"未纳入提交（避免带走并发会话改动）"= 正确行为，收口时补提共享文件
收口前先 git pull --rebase——push 前先拉，冲突就地合，合完必须重新发布上线

长任务后台启动与监控两坑（2026-09-21 实测）

后台进程不继承交互 shell 的 PATH——terminal(background=true) 里 export PATH=... && claude 报 bash: claude: command not found(exit 127)。用绝对路径 /opt/data/npm-global/bin/claude，PATH export 只作保险。派发后 process list 确认 running 而非 exited
不要 foreground sleep 等任务——等待一律 background=true + notify_on_complete，靠完成通知回收
每任务独立 log：> /tmp/cc-<task>.log 2>&1
四连发验证可行：同仓并发 4 个 CC 实测全一次跑通，但按上节纪律防 git 污染

图片验证铁律（2026-09-22 用户新增钦点）

# ❌ 不足：只查 HTTP 200（404 首页替代可能返回 200）
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>)
if [[ "$CT" != image/* ]]; then echo "❌ 不是真图片: $CT"; fi

skill-image 集成模式（2026-09-22 新增）

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

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

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

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

启动前三要素（缺一即失败）

export PATH="/opt/data/npm-global/bin:$PATH"     # claude 二进制
export ANTHROPIC_AUTH_TOKEN=$FMODE_API_KEY       # 必设,否则 Not logged in
export ANTHROPIC_BASE_URL=https://api.fmode.cn
which claude && claude --version

# 后台启动用绝对路径（见上节），启动后 pgrep -f claude 确认真在跑

Prompt 传参：stdin 是唯一安全方式（2026-08-30 事故铁律）

# ✅ 标准：长任务书走 stdin 重定向
claude -p "执行任务书全部内容,完成后git commit(不push)" \
  --permission-mode bypassPermissions < task.md > run.log 2>&1

# ❌ 禁止：claude -p "$(cat task.md)"
# 反引号/$(/括号被 shell 命令替换吃掉 → 模型收到残缺 prompt → 3分钟假完成(exit 0)

模型选择（settings.json 是唯一正确配置点）

{ "model": "deepseek-flash[1m]",
 "env": { "ANTHROPIC_MODEL": "deepseek-flash[1m]", "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-flash[1m]" },
  "permissions": { "defaultMode": "bypassPermissions" } }

配置后不需要也不应该传 --model；网关自行路由，渠道故障 failover 到 glm 系
⚠️ 网关把模型动态映射到其它上游模型是正常 failover 行为
unrecognized_model 警告可静默：export CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1
每次会话首次派发前 cat settings.json 确认 model 字段在位

启动后 60 秒健康检查

启动后 60 秒内必查（任一成立才算真运行中）：

run.log 出现模型回复或工具调用
进程 CPU 时间在增长（ps -o time= -p <pid>）
目标仓库出现新改动（git status --short）

command not found / 空日志 + exit=0 = 启动失败，禁止上报"运行中"。

接任务秒回执 + 看板同源状态

接任务即秒回执：第一条回复必须是一句话回执（收到+拆解成几件事+哪几件派后台+预计何时通知），先发回执再 spawn
任务状态与看板插件同源：后台 CLI 任务生命周期四态 ack→running→done/failed + 30s 心跳，写入 reporter/看板 AgentTaskStatus 同源表——CLI 死亡（心跳停）= 看板与主 Agent 同刻可见
复盘基线：9/9-9/10 实测 10 单，40% 静默率（死 4）是这套机制要消灭的数字

交付验收三级穿透（Web/App 类交付强制）

源码层：改动特征词在 src/ 里（grep -c > 0）
产物层：dist 产物里 grep 同一特征词
线上层：拉线上 URL 的 JS 产物再 grep（CDN 刷新后带 ?t=）

⚠️ 产物 grep 中文假阴性：esbuild/Angular 产物把中文转成 \uXXXX 十六进制转义（大写十六进制）。直接 grep 按时间 恒为 0。正确姿势：先 replace(/\\u([0-9A-Fa-f]{4})/g, ...) 解码再统计。判别：产物中文密度 0 且转义 0 = 构建真坏；转义形态命中 = 构建正常只是 grep 姿势错。

内容级复核（文档/方案类交付强制）

CLI 自报 DONE 后，除产物/线上穿透外还要内容级复核：

敏感细节残留 grep：每条"删除/降级/提名化"指令逐项验收
署名/称呼在位：grep 雨飏|袁（袁=0、雨飏≥1）
措辞替换全链：本地/OBS源对象/线上三层字节级确认（CDN 缓存顽固，curl ?v=参数+刷新+等待60s复验）
修复动作主 Agent 亲手做（小补丁不值再派 CLI）

通道熔断 / 账级故障

403 Account is suspended due to billing = Fmode API 账号因账单被暂停，只有用户充值能解，第一时间报告充值入口
Invalid token 401 = token/凭据问题（换 token）
The response stopped arriving... = API 响应中途断流，先盘点产物（可能已生成只差部署），收尾机械工作主 Agent 亲手做
通道熔断 vs 单次偶发：同通道连续 2-3 派、连最小任务都死 = 通道熔断停止重派；偶发单败 = 重试

delegate_task 子代理超时盘点与接管

长任务子代理常以 timeout 结束（Fmode API 稳定性 + 3600s 上限）。超时≠失败，先盘点再接管：

盘点三处落盘：进度日志、git log（CC 常已完成大量 commit 只差报告）、目标产物文件
子代理统计数字必须亲验（wc -c 是字节不是字数，中文场景字节≈字数1.5倍）
部分完成分级：全落盘→直接验收；核心完成缺报告→自己补；关键步骤缺→主 Agent 接管补完
防丢设计进任务书：每件完成立即 commit push、进度每20分钟落盘

CC 失败形态全谱

静默死亡：进程消失、无通知、零产物 → 盘点后原子重派或主Agent亲手
空手退出：exit0 但无 DONE、只建空骨架 → 同静默死亡
乱码退出：完成通知尾部是语义破碎乱码且无 DONE → 同静默死亡，产物重验
回执被吞（benign）：无 DONE 但产物完整 → 先盘点别当失败重派
model catalog 拒绝：模型名加 [1m] 后缀解
衍生保护：CC 退出但产物完整只差 commit → 主 Agent 代为 commit 保护

五连败铁律：同域任务连续 ≥5 次失败 = 该形态与 CC CLI 不兼容，停止重派，主 Agent + 底层协议完成。 单会话边界：长文创作按"一课一派/一节一棒"拆，每棒一份 MD/HTML 即收工；素材阅读消耗预算，任务书里素材要么已提取摘要要么指明只读不自由探索。

Web 会话自动化是 CC 派发高危区

"登录第三方 Web→多页表单/翻页→状态保持"类任务不要整包派 CC CLI（无头浏览器/SSO/反自动化是 CC 弱点）。拆到底层协议（requests 会话+CSRF+cookie）主 Agent 直接跑。派数据整合前先 grep 仓内已有数据（很多"采集任务"实为"整合任务"）。

执行层纪律与合规复查

用户会复查产出是不是 CC 做的——拿会话痕迹自证：

find ~/.claude/projects/-opt-data-<项目>/ -name "*.jsonl" -mmin <窗口> | wc -l——近窗口零痕迹 = Orchestrator 违规亲手
违规处理：不辩论，出增量任务书让执行层重做，验收加"会话痕迹存在"维度
"任务琐碎/CLI慢/中断过"都不是亲自干的理由
允许亲手例外（判据=这活需要"判断"吗）：单点字符串替换、配置行级修改、纯机械部署、批量正则补丁

权威事实喂料模式

派发涉及事实性内容的任务，任务书必须内联第一手权威事实并明令"禁止编造"：

vision 解析结果喂料 / 全量数据源喂料 / 既有实现仓喂料 / session_search 挖历史喂料
验收对照喂料事实逐项 grep，防 CC 换个名字编造

交付铁律

任务完成必须随回复附可点开交付物（URL/MEDIA），光说"完成"不算交付；主动交付=数字生命默认行为
报告/文档禁交付 MD 原文，转浅色阅读版 HTML 发公开链接
Web 应用交付必须给直连链接：<url>#token=<URI编码token>（hash模式不暴露，截屏不泄露）；桌面/移动路由一并验证200
Angular 子目录白屏根因：ng build --base-href="/dev/fmode-app/" 缺失 → index.html <base href="/"> → chunk 404 → 白屏。必须传 --base-href 且与 OBS 上传 URL 路径段一致。验证 grep dist/index.html <base href>

关联参考

references/hindsight-setup-pitfalls.md — Hindsight 记忆插件接入全坑册
scripts/md2html.py — MD→浅色阅读版HTML 转换脚本
相关技能: task-dispatch（自动调度分类）、fmode-brand-naming、claude-code-execution、skill-image

验证

任务完成后：交付文件存在 + git log --stat 与任务书清单一致 + 三要素下次启动仍通过

SKILL.md 12 KB Trvalý odkaz Historie Surový