Skill Seekers 自定义工作流（Custom Workflows）完全指南：用 YAML 编排多阶段 AI 增强流水线

Skill Seekers 自定义工作流Custom Workflows完全指南用 YAML 编排多阶段 AI 增强流水线【免费下载链接】Skill_SeekersConvert documentation websites, GitHub repositories, and PDFs into Claude AI skills with automatic conflict detection项目地址: https://gitcode.com/gh_mirrors/sk/Skill_Seekers本文面向 Skill Seekers v3.9.0。工作流Workflow是 Skill Seekers 中用于驱动 SKILL 生成与增强的 YAML 多阶段流水线通过内置或自定义提示词把抓取/分析得到的原始资料逐级加工成高质量的 Claude AI Skill 文档。读完本文你将掌握工作流的 YAML 结构、全部字段语义、内置 70 预置工作流、运行时变量覆盖、阶段间历史传递、workflows子命令全量用法以及从性能分析到安全审查的完整落地范式。什么是自定义工作流工作流是YAML 定义的多阶段 AI 增强流水线。一个工作流文件把若干阶段stage串联起来每个阶段负责对 Skill 文档的某个部分执行一次 AI 增强后一个阶段可以消费前一个阶段的输出从而把简单的一次性增强升级为分层加工。从源码看工作流引擎的核心位于 enhancement_workflow.pyEnhancementWorkflow数据类描述整个工作流WorkflowStage描述单个阶段WorkflowEngine负责加载、校验与顺序执行。所有 scrapersdoc_scraper、github_scraper、pdf_scraper、codebase_scraper等都通过 workflow_runner.py 中的统一run_workflows()函数消费 CLI 传入的工作流参数意味着任何来源的抓取结果都可以挂接自定义工作流。一个工作流文件的顶层结构如下my-workflow.yaml ├── name ├── description ├── variables (optional) └── stages (1-10) ├── name ├── type (builtin/custom) ├── target (skill_md/references/) ├── prompt └── uses_history (optional)说明stages数量限制为 110 个target在文档中给出skill_md/references两个面向产物文件的取值而在引擎内部还支持更细粒度的分析数据目标patterns、examples、all等见下文目标target一节。基本工作流结构最小可用工作流如下包含一个内置阶段和一个自定义阶段name: my-custom description: Custom enhancement workflow stages: - name: stage-one type: builtin target: skill_md prompt: | Improve the SKILL.md by adding... - name: stage-two type: custom target: references prompt: | Enhance the references by...stage-one使用内置增强逻辑修改主 SKILL.mdstage-two使用自定义提示词增强 references 参考文件。引擎会按 YAML 中的顺序依次执行各阶段enhancement_workflow.py任一阶段失败不会中断整个工作流而是记录错误后继续执行后续阶段。工作流字段顶层字段字段必需描述name是工作流标识符也是--enhance-workflow引用的名称description否人类可读的描述会显示在workflows list输出中variables否可配置变量可在运行时用--var覆盖stages是阶段定义数组110 个除文档列出的四个顶层字段外从源码enhancement_workflow.py还可以看到引擎支持以下扩展字段字段必需描述version否工作流版本号默认1.0applies_to否适用场景如codebase_analysis、github_analysis默认[codebase_analysis]post_process否后处理配置remove_sections、reorder_sections、add_metadata、custom_transformsextends否继承另一个工作流按阶段名覆盖父级阶段字段字段必需描述name是阶段标识符可通过{stages[名字]}在后续阶段引用其输出type是builtin或customtarget是本阶段写入的目标skill_md或referencesprompt是AI 提示文本可使用{变量}与历史占位符uses_history否是否访问前一阶段结果默认false引擎在解析阶段时enhancement_workflow.py还会读取两个可选字段enabled是否启用该阶段默认true可用于临时停用阶段而不删除与metadata附加到阶段执行历史的任意字典。创建你的第一个工作流示例性能分析以下performance.yaml展示了一个双阶段工作流先用内置阶段在 SKILL.md 中补充性能总览再用自定义阶段生成一份引用运行时变量、并消费历史结果的优化指南# performance.yaml name: performance-focus description: Analyze and document performance characteristics variables: target_latency: 100ms target_throughput: 1000 req/s stages: - name: performance-overview type: builtin target: skill_md prompt: | Add a Performance section to SKILL.md covering: - Benchmark results - Performance characteristics - Resource requirements - name: optimization-guide type: custom target: references uses_history: true prompt: | Create an optimization guide with: - Target latency: {target_latency} - Target throughput: {target_throughput} - Common bottlenecks - Optimization techniques安装与使用# 添加工作流安装到 ~/.config/skill-seekers/workflows/ skill-seekers workflows add performance.yaml # 使用它 skill-seekers create source --enhance-workflow performance-focus # 使用自定义变量覆盖默认值 skill-seekers create source \ --enhance-workflow performance-focus \ --var target_latency50ms \ --var target_throughput5000req/s--enhance-workflow既可以按名称引用已安装/内置工作流也可以直接传 YAML 文件路径。参数定义见 arguments/workflow.py。引擎加载时按三级查找顺序解析工作流enhancement_workflow.py原始文件路径绝对路径或相对当前目录用户目录~/.config/skill-seekers/workflows/{name}.yaml包内内置工作流skill_seekers/workflows/{name}.yaml通过importlib.resources读取。workflows add在安装前会做基础校验YAML 根必须是映射且必须包含stages键并把文件复制到用户目录workflows_command.py同名覆盖会输出Warning。阶段类型Stage Typesbuiltin复用内置增强逻辑builtin阶段不直接调用 AI 生成而是复用项目内置的增强器。当target为patterns时调用PatternEnhancer.enhance_patterns()为examples时调用TestExampleEnhancer.enhance_examples()enhancement_workflow.pystages: - name: structure-improvement type: builtin target: skill_md prompt: Improve document structure注意builtin阶段主要面向分析数据patterns/examples当目标数据在当前结果中不存在时会跳过该阶段并输出提示日志。custom完全自定义提示控制custom阶段将prompt模板用当前上下文格式化后交给 AI 增强器执行enhancement_workflow.py。提示中可直接使用{variables}与{history}相关占位符stages: - name: custom-analysis type: custom target: skill_md prompt: | Your detailed custom prompt here... Can use {variables} and {history}格式化使用 Python 的str.format()缺失变量不会崩溃而是记录警告并退回原始提示文本AI 响应优先按 JSON 解析json.loads解析失败则把整段文本作为{content: ..., stage: ...}返回调用走 agent 无关的AIEnhancer.call()max_tokens3000旧版增强器回退到_call_claude()。快速内联阶段--enhance-stage不想新建 YAML 文件时可用--enhance-stage name:prompt直接注入自定义阶段多个 flag 会被合并成一个名为inline_workflow的内联工作流workflow_runner.pyskill-seekers create source \ --enhance-stage security:Analyze for security issues \ --enhance-stage cleanup:Remove boilerplate sections目标Targetstarget决定本阶段的增强结果写入哪里。skill_md增强主 SKILL.md 文件面向最终产物stages: - name: improve-skill target: skill_md prompt: Add comprehensive overview sectionreferences增强参考文件如 references 目录下的补充文档、跨文件交叉引用等stages: - name: improve-refs target: references prompt: Add cross-references between files引擎内部的分析数据目标从源码看target在引擎层面还有更细的取值enhancement_workflow.pytarget行为all阶段结果整体合并进当前结果{**current, **stage_results}patterns只更新 patterns 数据通常配合builtin使用examples只更新 examples 数据通常配合builtin使用其他任意键将阶段结果写入当前结果的该键名下内置工作流security-focus.yaml就用到了target: security、target: auth这类自定义键见 workflows/security-focus.yaml把不同阶段的产出分别归入独立分区方便后续引用。变量Variables定义变量variables: audience: beginners focus_area: security include_examples: true变量支持字符串、布尔值等 YAML 标量运行时可通过--var keyvalue覆盖。使用变量在任意阶段的prompt中用{变量名}引用stages: - name: customize prompt: | Tailor content for {audience}. Focus on {focus_area}. Include examples: {include_examples}运行时覆盖skill-seekers create source \ --enhance-workflow my-workflow \ --var audienceexperts \ --var focus_areaperformance变量合并的优先级从低到高为引擎注入的 scraper 上下文如 GitHub 元数据→ 配置文件workflow_vars→ 工作流文件内的variables→ 命令行--var最高优先级实现见 workflow_runner.py。即--var永远能覆盖文件默认值。历史传递History Passing阶段可以通过uses_history: true读取此前所有阶段的产出。引擎构建阶段上下文时enhancement_workflow.py会注入三类历史占位符占位符含义{previous_results}最近一个已完成阶段的结果{all_history}全部历史记录含 stage 名、结果、时间戳、metadata{stages[阶段名]}按阶段名精确索引某一次结果stages: - name: analyze type: custom target: skill_md prompt: Analyze security features - name: document type: custom target: skill_md uses_history: true prompt: | Based on previous analysis: {previous_results} Create documentation...高级示例安全审查组合variables、uses_history与多目标可以搭建资产盘点 → 威胁分析 → 缓解指南的三阶段安全流水线name: comprehensive-security description: Multi-stage security analysis variables: compliance_framework: OWASP Top 10 risk_level: high stages: - name: asset-inventory type: builtin target: skill_md prompt: | Document all security-sensitive components: - Authentication mechanisms - Authorization checks - Data validation - Encryption usage - name: threat-analysis type: custom target: skill_md uses_history: true prompt: | Based on assets: {all_history} Analyze threats for {compliance_framework}: - Threat vectors - Attack scenarios - Risk ratings ({risk_level} focus) - name: mitigation-guide type: custom target: references uses_history: true prompt: | Create mitigation guide: - Countermeasures - Best practices - Code examples - Testing strategies仓库内置的 security-focus.yaml 是同类思路的真实模板它包含提示注入扫描injection_scan、基础模式增强base_patternsbuiltin、OWASP 漏洞分析vulnerabilities与认证授权审查auth_review四个阶段并通过post_process.add_metadata向最终产物写入enhanced: true、workflow: security-focus、security_reviewed: true元数据。验证Validation安装前验证skill-seekers workflows validate ./my-workflow.yamlvalidate通过WorkflowEngine实际解析文件支持传路径或已安装工作流名称成功时输出工作流名称、描述、版本与每个阶段的类型/启用状态workflows_command.py。常见错误错误原因修复Missing stages无 stages 数组添加stages:Invalid type不是 builtin/custom检查type字段Undefined variable已使用但未定义添加到variables:workflows add安装时也会执行同样的stages键校验未通过的文件不会被安装workflows_command.py。内置工作流与 workflows 子命令预置工作流仓库自带 70 内置工作流workflows 目录覆盖广泛主题security-focus安全审查、performance-optimization性能、architecture-comprehensive架构、api-documentationAPI 文档、kubernetes-deployment、message-queues、vector-databases、graphql-schema、microservices-patterns、compliance-gdpr、testing-focus、observability-stack等另有default.yaml与minimal.yaml作为基础模板。内置工作流是只读的无法直接remove如需定制先复制到用户目录再编辑见下文copy。workflows 子命令全量用法skill-seekers workflows子命令定义在 workflows_command.py# 列出所有工作流内置 用户附带描述 skill-seekers workflows list # 打印某个工作流的 YAML 内容按名称或路径 skill-seekers workflows show my-workflow # 复制内置工作流到用户目录以便编辑 skill-seekers workflows copy security-focus # 安装自定义 YAML 工作流--name 可重命名单文件时可用 skill-seekers workflows add ./my-workflow.yaml skill-seekers workflows add ./my-workflow.yaml --name custom-name # 删除用户工作流内置工作流会被拒绝 skill-seekers workflows remove my-workflow # 校验工作流 skill-seekers workflows validate security-focus要点均有测试覆盖见 test_workflows_command.pycopy支持一次复制多个且同名已存在时覆盖并告警目标写入~/.config/skill-seekers/workflows/add支持一次安装多个文件此时不能用--name单个文件校验失败不影响其余文件安装但进程以非零码退出remove对内置工作流报错并提示先copyshow/validate均可直接接受文件路径解析顺序与引擎的三级查找一致。最佳实践1. 从简单开始先写 12 个阶段的工作流验证效果再逐步叠加# Start with 1-2 stages name: simple description: Simple workflow stages: - name: improve type: builtin target: skill_md prompt: Improve SKILL.md2. 使用清晰的阶段名称阶段名同时是{stages[...]}历史索引的键可读性直接影响后续阶段的引用体验# Good stages: - name: security-overview - name: vulnerability-analysis # Bad stages: - name: stage1 - name: step23. 记录变量在variables中为每个键写注释说明取值范围方便团队复用variables: # Target audience level: beginner, intermediate, expert audience: intermediate # Security focus area: owasp, pci, hipaa compliance: owasp4. 增量测试先用干运行--workflow-dry-run会预览所有阶段与将注入的变量而不执行任何 AI 调用、不修改文件workflow_runner.py# Test with dry run skill-seekers create source \ --enhance-workflow my-workflow \ --workflow-dry-run # Then actually run skill-seekers create source \ --enhance-workflow my-workflow干运行预览结束后进程直接退出并提示 Dry run complete! No changes made.。5. 链式调用以进行复杂分析--enhance-workflow可重复使用多个工作流按给定顺序依次执行前一个完成后立即执行下一个并在日志中输出Chaining N workflow(s) in sequence# Use multiple workflows skill-seekers create source \ --enhance-workflow security-focus \ --enhance-workflow performance-focus也可以混合使用--enhance-workflow与--enhance-stage先依次运行命名工作流再运行合并后的内联工作流workflow_runner.py。单个工作流加载失败不会中断后续工作流跳过并继续但--workflow-dry-run会贯穿所有工作流的预览。6. 使用继承复用现有工作流若多个工作流共享相同的前置阶段可用extends继承父工作流子级按阶段名覆盖父级阶段variables与add_metadata深合并custom_transforms拼接enhancement_workflow.py。共享工作流导出工作流# Get workflow content skill-seekers workflows show my-workflow my-workflow.yamlshow同样支持按名称或路径解析非常适合把已安装的工作流导出为文件。与团队共享# Add to version control git add my-workflow.yaml git commit -m Add custom security workflow # Team members install skill-seekers workflows add my-workflow.yaml配合workflows list/workflows validate可以让团队成员先查看可用工作流、再安装与校验降低出错概率。发布可以把成熟的工作流提交到 Skill Seekers 社区GitHub Discussions、Skill Seekers 网站以及文档贡献渠道。通过配置文件与 MCP 使用工作流除了 CLI 参数工作流也可以在配置文件中声明配置文件中的workflow_vars会进入变量合并链优先级低于--var配置文件声明的enhancement.workflows与enhancement.stages会通过ExecutionContext在无 CLI flag 时自动生效execution_context.py、workflow_runner.py。统一抓取器在 Phase 5 执行配置文件工作流时会以use_context_fallbackFalse避免重复执行unified_scraper.py。工作流同样可通过 MCP 工具调用详见 MCP 参考。另请参阅工作流指南 —— 工作流的基础使用流程增强指南 —— 增强Enhancement基础概念MCP 参考 —— 通过 MCP 使用工作流增强功能说明 —— 增强模式与工作流的关系测试用例 与 workflow runner 测试 —— workflows 子命令与执行链的行为验证【免费下载链接】Skill_SeekersConvert documentation websites, GitHub repositories, and PDFs into Claude AI skills with automatic conflict detection项目地址: https://gitcode.com/gh_mirrors/sk/Skill_Seekers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考