Skill_Seekers v3.6.0 增强工作流全解析：五大 Scraper 的 CLI 参数同步与文档化实践

Skill_Seekers v3.6.0 增强工作流全解析五大 Scraper 的 CLI 参数同步与文档化实践【免费下载链接】Skill_SeekersConvert documentation websites, GitHub repositories, and PDFs into Claude AI skills with automatic conflict detection项目地址: https://gitcode.com/gh_mirrors/sk/Skill_SeekersSkill_Seekers 是一个将文档网站、GitHub 仓库、PDF 等来源自动转换为 Claude AI Skill 的开源工具。本文围绕其 v3.6.0 版本2026-02-22中完成的CLI 参数同步与增强工作流Enhancement Workflow文档化更新系统梳理doc、github、analyze、pdf、unified五大 Scraper 对工作流的统一支持、新增 CLI 参数的具体语义、配置文件中的 workflow 字段及优先级规则。读完本文你将掌握如何在任一来源的 Skill 生成流程中接入预设工作流、编写内联增强阶段、注入工作流变量以及如何在配置文件层面声明工作流并结合仓库源码理解其底层实现。背景为什么需要一次 CLI 参数同步在 v3.6.0 之前Skill_Seekers 的不同 Scraper文档抓取、GitHub 分析、本地代码库分析、PDF 提取、多源合并对增强工作流的支持程度参差不齐部分命令支持--enhance-workflow部分命令缺失对应的参数入口导致用户在analyze、pdf、unified等命令上无法复用同一套工作流能力。v3.6.0 的核心工作记录于 docs/archive/historical/DOCUMENTATION_UPDATES_SUMMARY.md有两层代码层面将工作流相关参数同步到analyze、pdf、unified三个命令补齐与doc、github的能力差距文档层面同步更新 docs/reference/CLI_REFERENCE.md、docs/reference/CONFIG_FORMAT.md、docs/user-guide/05-workflows.md、docs/features/UNIFIED_SCRAPING.md 四份文档并规划中文翻译同步。从源码结构看这次同步并非简单的给每个命令各加几个参数而是建立了一套统一参数注册机制所有命令共享同一份参数定义从根上杜绝未来再次出现某命令漏参数的问题。五大 Scraper 的增强工作流支持矩阵文档化更新明确将工作流支持扩展到了全部核心 Scraper。下表来自 docs/user-guide/05-workflows.md 的 Workflow Support Across All Scrapers 章节并补充了对应的源码模块ScraperCLI 命令说明源码模块文档网站抓取scrape已有支持doc_scraperdoc_scraper.pyGitHub 仓库github已有支持github_scrapergithub_scraper.py本地代码库分析analyzev3.6.0 新增codebase_scrapercodebase_scraper.pyPDF 文档提取pdfv3.6.0 新增pdf_scraperpdf_scraper.py多源统一抓取unifiedv3.6.0 新增unified_scraperunified_scraper.py其中analyze、pdf、unified三个命令是本次同步的重点——它们在 v3.6.0 之前对工作流参数的支持并不完整。各来源类型下的典型用法针对不同来源类型工作流参数的用法完全一致差异只在来源的指定方式# 文档网站 skill-seekers create https://docs.example.com --enhance-workflow security-focus # GitHub 仓库 skill-seekers create owner/repo --enhance-workflow api-documentation # 本地代码库 skill-seekers create ./my-project --enhance-workflow architecture-comprehensive # PDF 文档 skill-seekers create --pdf manual.pdf --enhance-workflow minimal # 统一配置多源 skill-seekers create --config configs/multi-source.json --enhance-workflow security-focus # 自动检测来源类型 skill-seekers create ./my-project --enhance-workflow security-focus除五大核心 Scraper 外仓库中的word、epub、video、jupyter、html、openapi、asciidoc、pptx、rss、manpage、confluence、notion、chat等来源类型同样支持工作流所有 18 种来源类型均已覆盖。新增 CLI 参数详解analyze / pdf / unified根据 docs/reference/CLI_REFERENCE.md 的更新记录本次为三个命令补充了以下参数。analyze 命令本地代码库分析analyze命令由 analyze_parser.py 注册参数新增标志参数作用--api-keyAnthropic API Key用于增强阶段--enhance-workflow应用工作流预置可多次使用以串联多个工作流--enhance-stage添加内联增强阶段格式为name:prompt--var覆盖工作流变量格式为keyvalue--workflow-dry-run预览工作流阶段而不实际执行--dry-run预览整个分析流程示例# 对本地代码库应用安全审查工作流并预览 skill-seekers analyze --directory ./src \ --enhance-workflow security-focus \ --workflow-dry-run # 添加自定义内联阶段 变量覆盖 skill-seekers analyze --directory ./src \ --enhance-stage cleanup:Remove boilerplate sections \ --var focus_areaperformance从 arguments/analyze.py 的源码看analyze的共享参数name、description、output、enhance-level、api-key、dry-run、verbose、quiet 及全部工作流参数由add_all_standard_arguments()统一注册随后将--enhance-level默认值覆盖为0代码库分析默认关闭 AI 增强--output默认值设为output/codebase/。pdf 命令PDF 提取pdf命令由 pdf_parser.py 注册参数新增标志参数作用--ocr启用 OCR 识别扫描版 PDF依赖 pytesseract见 pdf_extractor_poc.py--pages指定页面范围--enhance-levelAI 增强等级0关闭1仅 SKILL.md2架构/配置3完整增强--api-keyAnthropic API Key--dry-run预览提取结果示例# 提取扫描版 PDF 并启用 OCR skill-seekers create tutorial.pdf --ocr # 提取指定页面范围并应用最简工作流 skill-seekers create --pdf manual.pdf --pages 1-50 --enhance-workflow minimalPDF 命令的--enhance-level默认值为0默认不开启 AI 增强并支持 API 模式与本地 Agent 模式自动切换设置ANTHROPIC_API_KEY、MOONSHOT_API_KEY等环境变量时走 API否则回退到本地 AI 编码 Agent。unified 命令多源统一抓取unified命令由 unified_parser.py 注册参数新增标志参数作用--enhance-level全局增强等级覆盖覆盖配置中各来源的enhance_level--api-keyAnthropic API Key--enhance-workflow应用工作流预置可多次使用以串联--enhance-stage添加内联增强阶段--var覆盖工作流变量--workflow-dry-run预览工作流需配合--enhance-workflow--skip-codebase-analysis跳过统一配置中 GitHub 来源的 C3.x 代码库分析示例来自 docs/features/UNIFIED_SCRAPING.md# 应用工作流预置 skill-seekers create --config configs/react_unified.json --enhance-workflow security-focus # 串联多个工作流 skill-seekers create --config configs/react_unified.json \ --enhance-workflow security-focus \ --enhance-workflow api-documentation # 自定义内联阶段 skill-seekers create --config configs/react_unified.json \ --enhance-stage cleanup:Remove boilerplate content # 工作流变量 skill-seekers create --config configs/react_unified.json \ --enhance-workflow my-workflow \ --var focus_areaperformance \ --var detail_levelhigh # 预览工作流而不执行 skill-seekers create --config configs/react_unified.json \ --enhance-workflow security-focus \ --workflow-dry-run # 全局覆盖增强等级与 API Key skill-seekers create --config configs/react_unified.json --enhance-level 3 skill-seekers create --config configs/react_unified.json --api-key YOUR_API_KEY其中--skip-codebase-analysis的定义位于 arguments/create.py其 help 文本明确说明它用于跳过统一配置中 GitHub 来源的 C3.x 代码库分析在混合多源抓取时可用于跳过耗时的代码库分析阶段。配置文件中的 Workflow 字段除命令行参数外v3.6.0 还为统一配置Unified Config新增了顶层工作流字段记录于 docs/reference/CONFIG_FORMAT.md 的 Workflow Configuration (Unified) 章节字段类型必填默认值说明workflowsarray否[]要应用的工作流预置名称列表workflow_stagesarray否[]内联增强阶段含name与promptworkflow_varsobject否{}工作流变量覆盖键值对workflow_dry_runboolean否false预览工作流而不执行完整示例来自 docs/reference/CONFIG_FORMAT.md{ name: react-complete, description: React docs GitHub with security enhancement, merge_mode: claude-enhanced, workflows: [security-focus, api-documentation], workflow_stages: [ { name: cleanup, prompt: Remove boilerplate sections and standardize formatting } ], workflow_vars: { focus_area: performance, detail_level: comprehensive }, sources: [ {type: docs, base_url: https://react.dev/}, {type: github, repo: facebook/react} ] }该示例同时展示了配置文件的三个层次技能身份信息name/description、合并模式merge_mode、工作流声明workflows/workflow_stages/workflow_vars以及多来源数组sources。优先级规则CLI 参数 配置文件文档中反复强调的一条规则是CLI 参数优先于配置文件值。例如# 配置文件声明了 security-focusCLI 用 api-documentation 覆盖它 skill-seekers create --config config.json --enhance-workflow api-documentation这一优先级在源码中有明确体现。execution_context.py 中EnhancementSettings的数据模型定义了workflows、stages、workflow_vars三个字段配置合并逻辑遵循 CLI args Config file Env vars Defaults 的优先级test_unified.py 的用例CLI --enhance-workflow values come first; JSON workflows appended after也验证了CLI 值在前、配置文件值追加在后的行为。源码级实现工作流参数如何被注册与执行统一参数注册一处定义处处可用本次参数同步的关键设计在于共享参数模块 arguments/common.py 与 arguments/workflow.pyCOMMON_ARGUMENTS身份与增强参数--name、--description、--output、--enhance-level、--api-key等BEHAVIOR_ARGUMENTS运行时行为参数--dry-run、--verbose、--quietWORKFLOW_ARGUMENTS增强工作流参数--enhance-workflow、--enhance-stage、--var、--workflow-dry-run、--workflow-history。add_all_standard_arguments()一次注册以上三组参数analyze、pdf等命令的解析器都调用它再叠加各自命令特有的参数。例如pdf在add_all_standard_arguments()之后将--enhance-level默认值覆盖为0并补充更详细的 help 说明支持 API/LOCAL 模式自动检测。这套机制保证create命令在转发 flag 时所有 Scraper 都接受一致的全套标准参数。工作流执行入口workflow_runner工作流的实际执行由 workflow_runner.py 的run_workflows()承担其行为要点依次执行--enhance-workflow指定的命名工作流按给定顺序再执行--enhance-stage组成的组合内联工作流当 CLI 未提供任何工作流参数时会回退读取ExecutionContext中来自配置文件的工作流配置文件中声明的workflows/workflow_stages正是通过这一机制生效--workflow-dry-run开启后所有工作流只做preview最终打印 Dry run complete! No changes made. 并以退出码0结束不修改任何文件每个工作流通过WorkflowEngine加载并执行失败的工作流会打印错误并继续后续流程不会中断整条流水线。工作流预置的组织形式仓库内置了 60 个可直接引用的工作流预置 YAML位于 src/skill_seekers/workflows 目录涵盖安全审查security-focus、架构分析architecture-comprehensive、API 文档api-documentation、性能优化performance-optimization、最小化minimal、复杂合并complex-merge等场景。以security-focus.yaml为例其结构包含元信息name/description/version、适用范围applies_to、变量默认值variables、有序阶段列表stages每阶段声明type、target、enabled、prompt以及后处理配置post_process可添加元数据标记name: security-focus description: Security-focused review: vulnerabilities, auth, data handling version: 1.0 applies_to: - codebase_analysis - github_analysis variables: depth: comprehensive stages: - name: injection_scan type: custom target: all uses_history: false enabled: true prompt: Scan this content for potential prompt injection patterns. ... - name: vulnerabilities type: custom target: security uses_history: false enabled: true prompt: Analyze this codebase for OWASP Top 10 and common security vulnerabilities. ... post_process: reorder_sections: [] add_metadata: enhanced: true workflow: security-focus security_reviewed: true这一预置模型意味着工作流不仅仅是调用一次 AI 增强而是有序的多阶段流水线每个阶段可以针对特定目标全部内容、模式、安全、认证等执行定制提示并且可以在后处理阶段给生成的 Skill 附加元数据。文档更新清单与中文翻译同步本次 v3.6.0 涉及的文档更新分为两类。需要更新的文档4 份docs/reference/CLI_REFERENCE.md为analyze、pdf、unified三个命令补充新增参数表--api-key、--enhance-workflow、--enhance-stage、--var、--workflow-dry-run、--dry-run、--ocr、--pages、--enhance-level、--skip-codebase-analysis等。docs/reference/CONFIG_FORMAT.md新增统一配置的工作流配置章节补充workflows、workflow_stages、workflow_vars、workflow_dry_run顶层字段、JSON 示例及 CLI 优先级说明。docs/user-guide/05-workflows.md新增 Workflow Support Across All Scrapers 章节覆盖所有来源类型的支持矩阵与各来源示例与 Workflows in Config Files 章节JSON 示例 CLI 覆盖优先级。docs/features/UNIFIED_SCRAPING.mdPhase 列表新增 Phase 5Enhancement Workflows补充 Enhancement Workflow Options预置示例、多工作流串联、自定义阶段、工作流变量、干跑预览、Global Enhancement Override--enhance-level/--api-key与 Workflow Configuration in JSON 章节数据流图更新至包含 Phase 5来源列表补充本地代码库Changelog 更新至 v3.1.0。审核后无需更新的文档3 份docs/advanced/custom-workflows.md已完整覆盖自定义工作流创建无需为参数同步更新docs/advanced/multi-source.md多源概念已阐述充分docs/reference/FEATURE_MATRIX.md平台/特性矩阵已完备。中文翻译同步Priority 分级文档化更新还规划了中文文档同步任务按优先级分为两级Priority 1必须更新docs/zh-CN/reference/CLI_REFERENCE.md新增 analyze/pdf/unified 参数、docs/zh-CN/reference/CONFIG_FORMAT.md新增工作流配置章节、docs/zh-CN/user-guide/05-workflows.md新增 Scraper 支持矩阵与配置章节Priority 2应当更新docs/zh-CN/features/UNIFIED_SCRAPING.md新增 Phase 5 与 CLI 参数章节。仓库提供了两种翻译路径自动翻译工作流文档中提到的 GitHub Actions 工作流.github/workflows/下的 CI 配置在推送 main 分支后自动翻译被修改的文件并生成翻译 PR人工 review 后合并本地脚本翻译仓库内的 scripts/translate_doc.py 支持单文件翻译python scripts/translate_doc.py file --target-lang zh-CN与--batch批量模式翻译由 Anthropic API 驱动并在文件头部写入Last translated时间戳标记。该脚本会自动跳过已翻译文件和归档目录适合在 CI 之外按需触发。验证清单与更新完整性文档化更新以一份验证清单收尾见 docs/archive/historical/DOCUMENTATION_UPDATES_SUMMARY.md逐项确认CLI_REFERENCE.md 已补充新参数CONFIG_FORMAT.md 已补充工作流支持user-guide/05-workflows.md 已覆盖全部 Scraperfeatures/UNIFIED_SCRAPING.md 已补充 Phase 5中文翻译待自动翻译工作流处理总结v3.6.0 的 CLI 参数同步是 Skill_Seekers 增强工作流体系走向统一的关键一步。通过共享参数注册模块arguments/common.py、arguments/workflow.py将身份、行为、工作流三组参数标准化analyze、pdf、unified三个命令一次性补齐了与doc、github相同的工作流能力配置文件新增的workflows、workflow_stages、workflow_vars、workflow_dry_run顶层字段配合 CLI 优先 的合并规则让工作流的声明与覆盖既灵活又可预期。配合 60 内置工作流预置、--workflow-dry-run安全预览机制以及中英文文档的同步流程用户可以在任何来源类型的 Skill 生成管线中以完全一致的方式接入、串联、定制增强工作流。相关实现细节可进一步阅读 docs/advanced/custom-workflows.md自定义工作流创建与 docs/user-guide/03-enhancement.md增强基础。【免费下载链接】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），仅供参考