技能介绍

先固定问题

Agent 工作流最常见的失控不是缺少 Skill，而是把“路由”悄悄变成“什么都做一点”。一旦入口 Skill 开始顺手执行完整流程，任务边界就被抹平：PDF 检索、视频转写、视觉验收和项目收口看起来都能做，实际却可能各写一套临时逻辑，最后无法判断哪一步负责结果、哪一步只是被顺手调用。

@user_6c41e2d5/zhishuo-workflows 只承担路由职责：不复述一遍文件类型就开跑，不把未支持任务塞进现有 Skill，也不在这里完成完整流程。 它的目标是让每个任务只有一个主流程，或有一条明确的多流程顺序。

路由如何工作

路由步骤很直接：

先用一句话复述用户真正要得到的结果，而不是只识别“PDF”“视频”或“页面”这类输入格式。
再对照路由表选择主 Skill；如果任务包含连续阶段，必须写明执行顺序。
告知用户已选择的 Skill、选择理由和关键边界。
最后读取并执行对应子 Skill。没有匹配项时停止路由，说明当前目录没有覆盖。

当前路由表覆盖四类稳定入口：

项目阶段结束、暂停、归档、交接或检查能否恢复 → zhishuo-close-project，稳定锚点是收口；不处理普通开发与修 Bug。
大部头或多份 PDF 需要长期检索、拆章和回源 → zhishuo-build-pdf-knowledge-base，稳定锚点是派生链；不处理一次性阅读短 PDF 或少量普通拆解。
单条或批量 B 站 / YouTube 视频、本地视频需要变成可追溯文字 → zhishuo-transcribe-video，稳定锚点是字幕优先；不处理视频剪辑与摘要排版。
网页、产品、作品集或演示需要明确视觉方向、设计 token 或审美验收 → zhishuo-apply-visual-taste，稳定锚点是视觉合同；不处理复制第三方截图或只做随机美化。

多阶段任务也需要显式排序。例如“把视频转写后做 PDF 知识库”：先执行视频转写，再在用户确认文字资产后评估是否需要 PDF 知识库；不要把视频摘要冒充 PDF 来源。“按智说审美做页面并收口项目”：先生成视觉合同并完成真实渲染验收，再执行项目收口。

适用边界

首发边界里，macOS Apple Silicon 是外部工具真实运行的已验证基线；仓库安装与匿名核心测试覆盖 macOS 和 Windows。视频批量入口支持 B 站 UP 主空间与 YouTube 频道 / 播放列表，但必须先限制范围并核对清单。证据文档修订计划在 v0.2 发布，本版本不路由也不分发。没有 Agent 的用户可阅读子 Skill 和运行检测脚本，但没有自动路由。需要核对版本状态时，读取 catalog reference。