Workflow-Forge

盲测执行与失败分类中枢（v2.0.0）。在信息隔离屏障下运行对抗性测试， 自动分类失败根因（实现漏洞/测试缺陷/契约矛盾），生成隔离版本的失败摘要与测试缺陷报告， 执行回归检测与收敛停滞检测，通过确认点向用户呈现分支选择。 当需要运行对抗性测试、分类测试失败、生成隔离摘要或判定修复方向时使用本 Skill。

对抗性模块实现流水线入口——环境就绪与契约冻结。 负责环境检查、强化契约提取（含模糊边界显式仲裁）、契约冻结、 执行计划预览与用户确认。支持 core / recontract / contract-update / from-reverse 四种模式。

差异仲裁器。三模式 Skill：模式 A（设计变更差异分析）——对比当前设计文档与已冻结的 contract-expectations.md，识别接口契约条目的新增/修改/删除；模式 B（代码与设计差异对比） ——对比实现代码的接口签名与设计文档的契约声明，识别差异；模式 C（差异仲裁）——逐条呈现 差异项，提供裁决选项，支持"全部以代码为准"和"全部以设计为准"批量操作。 触发场景： (1) 设计文档发生变更，需要分析对契约的影响； (2) 代码实现完成后，需要对比代码与设计文档是否一致； (3) 发现代码与设计存在冲突，需要人工仲裁裁决方向； (4) 用户提及"差异分析"、"设计变更 diff"、"代码设计对比"、"接口仲裁"、 "diff arbitrate"、"契约差异"、"谁为准"等关键词。 核心特征：自动差异检测（模式 A/B）→ 人工裁决（模式 C）。模式 C 在逐条呈现差异时 提供三个裁决方向，并支持批量快捷操作。

存量制品检测器（轻量版）。纯文件系统扫描，检测指定模块的四类存量制品—— 设计文档、实现代码、测试代码、契约文件——并输出结构化 JSON 报告。 本 Skill 不做任何 AI 推理，全部检测逻辑由确定性扫描脚本完成。 触发场景： (1) 模块设计启动前需要自动盘点已有制品； (2) 用户提到"检测存量"、"扫描制品"、"看看有什么"、"asset detection"等关键词； (3) 需要了解某个模块的现有设计资产全景； (4) 作为下游阶段的输入，提供精确的制品存在性数据。

模块实现执行器。根据输入材料类型自动选择工作模式——全量优雅实现（A）、 最小化修复迭代（B）、增量更新或冲突修正（C）。 由工作流编排器调度使用。

验证模块实现产物的格式合规性与风险可控性。运行函数签名校验脚本， 读取并评估待确认事项中的风险条目等级，存在重大风险时条件性请求用户确认。 使用场景：模块实现落地完成后的质量门控；实现输出验证；签名格式校验；实现风险审核。 当用户要求"验证实现"、"检查实现输出"、"审核实现风险"、"确认函数签名"、"审查 pending-confirmations"时使用本 Skill。

增量路径判定器。基于存量检测报告 JSON，应用自动判定规则推荐增量设计路径（全量实施 / 增量更新 / 纯代码 / 代码设计冲突）， 仅在规则无法覆盖的边界情况时请求用户确认。负责冲突检测——对比代码接口签名与设计文档契约声明，识别差异。 触发场景： (1) 存量制品检测完成后需要决定模块的增量设计路线； (2) 用户提到"判定增量路径"、"路由推荐"、"路径选择"、"incremental path"、"route decision"等关键词； (3) 模块同时存在代码和设计文档，需要判断走差异对比还是直接增量更新； (4) 模块只有代码没有设计文档，需要确认走逆向工程还是全量设计； (5) 用户希望了解当前模块的最佳设计起点和跳过步骤。

对抗性验证最终报告生成与验收技能（v2.0.0）。收集全流程证据文件，执行最终全量测试运行， 运行契约一致性与隔离合规审计脚本，执行分组验收检查， 生成 adversarial-report.md、TESTING.md 和 IMPLEMENTATION_NOTES.md， 通过确认点让用户审查并选择"接受并结束"或"追加一轮修复"。 当需要生成对抗验证报告、验收模块实现、审计隔离合规性或整理测试文档时使用本 Skill。

逆向工程分析器。从现有代码反向提取设计意图与接口契约，生成逆向设计文档草稿。 你不是代码复读机——你从实现细节中推断设计意图，标注每条结论的可信度。 触发场景： (1) 模块有代码但缺少设计文档，需要从代码重建设计规格； (2) 用户提到"逆向分析"、"从代码提取设计"、"反向推导"、"reverse engineering"、"code analysis"等关键词； (3) 接手遗留代码模块，需要快速理解其接口契约和内部逻辑； (4) 代码先行开发完成后需要补充设计文档； (5) 用户要求从现有实现中提取函数签名、类型定义、状态机或异常策略。

在不知道实现细节的前提下，仅基于接口契约生成/修正/增量更新对抗性测试代码。 自动检测输入类型切换模式 A（全量生成）、模式 B（缺陷修正）、模式 C（增量更新）。 目标是找出实现漏洞，而非验证正确行为。

通用工作流编排器（v3）。教导主 Agent 如何通过 wfctl 机械调度程序驱动工作流循环。 当用户提到"工作流"、"workflow"、"流水线"、"多阶段任务"、"启动 workflow"、 "按流程执行"、"编排"、"stage"、"确认"、"回退到上一步"、"/workflow"时， **必须优先使用本 skill**。 注意：用户说"你自己按步骤做"不属于工作流调度——编排器只在用户需要显式 stage 管理、 确认门控、回退能力时介入。 也用于处理工作流状态查询、实例终止、异常恢复。

工作流结构设计师。将需求、旧 Skill 或已有工作流转化为符合 Workflow v3.0.0 规范的完整产物（WORKFLOW.yaml + WORKFLOW.md + skills/ + resources/）。 以技能包按需加载方式工作：根据用户请求自动识别所需能力模块，自主完成 分析、设计、编写 Skill、校验全流程。覆盖 Stage 编排、确认点设计、Skill 编写、子工作流嵌套、并发优化等场景。只要涉及多步骤任务编排、pipeline 设计、 stage 编排、任务 orchestration、多阶段协作流程，即使客户未说"工作流"也应使用。不负责纯 Skill 文案优化（用 skill-creator）或性能 审计（用 workflow-efficiency-optimizer）。

对抗性模块实现流水线入口——环境就绪与契约冻结。 负责环境检查、强化契约提取（含模糊边界显式仲裁）、契约冻结、 执行计划预览与用户确认。支持 core / recontract / contract-update / from-reverse 四种模式。

模块实现执行器。根据输入材料类型自动选择工作模式——全量优雅实现（A）、 最小化修复迭代（B）、增量更新或冲突修正（C）。

验证模块实现产物的格式合规性与风险可控性。运行函数签名校验脚本， 读取并评估待确认事项中的风险条目等级，存在重大风险时条件性请求用户确认。 使用场景：模块实现落地完成后的质量门控；实现输出验证；签名格式校验；实现风险审核。 当用户要求"验证实现"、"检查实现输出"、"审核实现风险"、"确认函数签名"、"审查 pending-confirmations"时使用本 Skill。

工作流对抗式审计器。以攻击者视角审查 WORKFLOW.yaml 和关联 Skill，检测状态机死锁、循环缺口、 并发冲突、异常路径断裂、子工作流传播漏洞、YAML-Skill 接口不一致等问题。 当用户提到"审查工作流"、"审计工作流"、"工作流体检"、"这个工作流能跑吗"、 "检查有没有死锁"、"workflow audit"、"工作流安全吗"、"能不能扛住异常"时使用本 Skill。 也用于 workflow-designer 深度设计完成后对产出做独立验收。 本 Skill 是车间自用工具，不做消费者分发。

工作流效率优化器。对已有 Workflow v2 工作流及其关联 Skill 进行 Token 消耗、时间效率和 Prompt 缓存命中率的全面审计与精准瘦身。 当用户提到"优化工作流效率"、"减少 token 消耗"、"提升缓存命中率"、"工作流太慢了"、 "workflow 太贵"、"降低工作流成本"、"优化 prompt 缓存"、"瘦身 skill"、"工作流跑得太慢"、 "token 用太多了"、"缓存命中率低"时，必须优先使用本 Skill。 与 workflow-optimizer 互补：前者追求产出质量不妥协，本 Skill 追求成本最小化（允许 ≤5% 质量劣化）。 审计高度自主，用户仅需在建议清单上逐条勾选审批，通过后自动执行。

代码逆向推导编写器。当模块已有代码实现但缺少设计文档时，通过分析源代码提取数据模型、公共接口、状态机和业务逻辑，重建意图文档和技术规格。 你是考古学家不是设计师——如实记录代码现状，标注推断的不确定性。 触发场景： (1) 模块有源代码但缺少意图文档或设计文档； (2) 用户提到"逆向推导"、"从代码生成文档"、"逆向工程"、"reverse engineer"、"code to doc"等关键词； (3) 需要理解一个没有文档的遗留代码模块； (4) 代码先行开发完成后需要补充设计文档； (5) 用户要求从现有实现中提取接口规格或业务规则。

模块契约协调与冲突检测 Skill。从设计文档提取对外接口类型草案（Pydantic Models、函数签名、状态枚举、数据类型定义）， 扫描项目中已有契约文件，检查命名冲突、语义冲突及可复用共享类型，输出精确协调报告。 支持首次全量提取和增量 delta 对比两种模式。 触发关键词：契约协调、契约冲突检测、contract harmonize、接口冲突检测、类型比对、契约草案提取、 类型复用扫描、接口一致性校验、契约存量 diff。

设计代码差异更新器。当模块同时存在设计文档和代码实现时，逐字段对比两者差异，识别设计偏离——是有意演进、意外漂移还是文档错误——并增量更新设计文档以反映真实状态。 默认归类为"需用户判断"，不做激进自动分类。 触发场景： (1) 模块已有设计文档和代码，需要对比两者是否一致； (2) 用户提到"设计代码对比"、"设计偏离检测"、"diff design and code"、"文档代码同步"、"设计文档落后于代码"等关键词； (3) 代码发生变更后需要同步更新设计文档； (4) 发现设计文档和实际实现不一致，需要追查原因； (5) 用户要求增量更新设计文档以反映最新的代码状态。

存量制品检测器。扫描指定模块的已有设计文档、代码实现和契约文件，判定增量设计场景，并推荐最佳路由路径供用户确认。 触发场景： (1) 模块设计启动前需要自动检测已有制品并决定从哪里开始； (2) 用户提到"检测存量"、"增量设计"、"探测已有文档"、"artifact detection"、"incremental path"等关键词； (3) 模块已有部分设计文档，需要判断是继续补充还是从头开始； (4) 模块已有代码但没有设计文档，需要确定逆向推导路径； (5) 用户希望了解某个模块的现有设计资产全景。 按两阶段连续流程执行：存量制品扫描 → 增量路径判定，每步完成后等待用户确认再推进。

将功能模块转化为业务意图文档，面向业务方和测试人员的业务契约。 触发场景：(1) 用户需要为模块编写意图文档；(2) 用户提到"意图文档"、"intent document"； (3) 用户需要做"业务意图澄清"、"需求澄清"、"intent writing"； (4) 用户要为模块做"业务对齐"、"业务设计"；(5) 模块设计流水线被调度执行时。 按四步连续流程执行：意图澄清 → 书写授权 → 生成意图文档 → 冻结授权。 每次调用为指定单一模块输出一份意图文档。

基于已冻结的意图文档，为功能模块执行材料准备、生成设计文档或输出落地规范与契约文件。 触发场景：(1) 用户要求编写技术规格、编码规范或落地实现； (2) 用户提到"技术设计"、"编码规格"、"类型定义"、"接口契约"、"状态机实现"等关键词； (3) 模块设计流水线进入规格阶段，意图文档已冻结； (4) 用户要求生成设计文档或落地规范； (5) 用户要求将高层设计转化为包含精确类型定义、异常处理、状态机的代码级文档； (6) 用户要求生成或更新接口契约文件与索引。 按三步连续流程执行：材料准备与前置检查 → 生成设计文档 → 最终规格与契约输出。

模块同步上报器。收集当前模块设计过程中发现的所有设计矛盾，按类型和严重程度分类，以结构化格式写入同步问题报告，供上层聚合和用户裁决。 你不与用户交互——只记录和上报。 触发场景： (1) 模块设计阶段结束，需要上报发现的同步矛盾； (2) 模块设计过程中发现了与其他模块的契约冲突、类型不一致或接口语义矛盾； (3) 用户提到"模块同步上报"、"同步问题记录"、"sync report"、"issue escalation"等关键词； (4) 模块设计因异常中止，需要上报已完成部分的同步状态； (5) 模块设计循环超限或用户放弃模块时，需要汇聚已有发现。

独立技术决策子代理。读取全部项目设计文档，做出技术上最优的全部决策， 标记必须由用户裁决的业务矛盾点，输出《技术决策完整报告》。 覆盖：技术决策预研、spec research、技术调研、技术选型分析、兼容性审查。

扫描项目设计文档，通过针对性提问与用户对齐需求，生成包含模块编号、名称、类型、核心功能、颗粒度描述、设计文档溯源和可选设计状态列的功能模块全拆解文档。 触发场景： (1) 用户要求根据现有设计文档生成功能模块拆解表或功能模块全拆解； (2) 用户要求将架构/设计文档中的功能点提取为模块化清单； (3) 用户要求审查或优化已有的模块拆解文档，解决边界模糊或覆盖不足问题； (4) 用户希望从设计文档中提取功能模块并参考行业常见实践补充盲区； (5) 用户提及 docs/ 目录、"功能模块"、"拆解"、"module breakdown"、"模块划分"等关键词。

项目调度管理器。负责汇报项目设计状态、按依赖分层展示可选模块清单、引导用户批量选择模块并判定各模块的增量场景。 触发场景： (1) 项目级设计状态汇总与模块进度全景展示； (2) 用户需要从功能模块全拆解中选择一批模块进入详细设计； (3) 用户提到"模块调度"、"选择模块"、"dispatch"、"批量设计"、"多模块选择"等关键词。 本 Skill 仅负责状态汇报与模块选择——模块调度执行由编排器处理。

基于已确认的技术栈方案，设计项目整体结构骨架——分层架构、代码组织、目录布局、 层间数据流与技术映射，产出项目结构设计文档。 触发场景： (1) 技术栈方案已确认，需要设计项目目录与代码组织结构； (2) 用户要求规划 monorepo 包划分、模块目录骨架或分层架构； (3) 用户提及"项目结构"、"目录规划"、"分层设计"、"project structure"、"代码组织"等关键词； (4) 作为项目设计流水线中技术栈设计后的下一环节。

工作流更新器（v3）。负责在已初始化工作流环境的真实项目中，检测并同步工作流定义和配套 Skill 的更新。 当用户提到"更新工作流"、"升级工作流版本"、"同步工作流"、"workflow update"、"更新 skill"、 "工作流有新版了"、"升级 math-model"、"同步 workflow"、"更新 orchestrator"、 "更新 workflow-orchestrator"、"升级基础设施 skill"时，**必须优先使用本 skill**。 也用于检查已安装工作流是否过时、对比新旧版本差异、批量更新多个工作流。 与 workflow-puller 的核心区别：puller 用于首次安装（跳过已有 Skill），updater 用于增量更新（对比差异、用户确认后覆盖）。

根据功能需求设计项目技术栈，或基于已有技术栈进行增量更新与评估。 触发场景： (1) 用户要求为新项目从零设计完整技术架构与选型方案； (2) 用户需要基于功能需求文档输出可落地的技术栈设计文档； (3) 用户希望对现有技术栈进行增量更新或架构演进评估； (4) 用户提及"技术栈"、"技术选型"、"架构设计"、"tech stack"、"选型方案"、"技术方案"等关键词； (5) 用户提供功能需求文档，需要将其映射为技术实现方案。 核心特征：在关键技术选型关节点（前端框架、后端语言、数据库、部署方式、 认证方案、实时通信、AI 集成、架构模式）提供选项对比与约束分析， 而非单方面决定。按三步连续流程执行：需求收集 → 架构选型 → 文档输出， 每步完成后等待用户确认再推进。

扫描项目设计文档，通过针对性提问与用户对齐需求，生成包含模块编号、名称、类型、核心功能、颗粒度描述、设计文档溯源和可选设计状态列的功能模块全拆解文档。 触发场景： (1) 用户要求根据现有设计文档生成功能模块拆解表或功能模块全拆解； (2) 用户要求将架构/设计文档中的功能点提取为模块化清单； (3) 用户要求审查或优化已有的模块拆解文档，解决边界模糊或覆盖不足问题； (4) 用户希望从设计文档中提取功能模块并参考行业常见实践补充盲区； (5) 用户提及 docs/ 目录、"功能模块"、"拆解"、"module breakdown"、"模块划分"等关键词。

执行模块依赖关系分析，梳理各模块之间的数据依赖、调用依赖、时序依赖和共享资源依赖， 产出依赖列表、Mermaid 依赖图、依赖矩阵、实现分层与不确定项标注。 当你需要进行"模块依赖分析"、了解"模块间关系"、生成"依赖矩阵"、 绘制"dependency graph"、或评估模块间耦合度时，使用此 Skill。

项目调度管理器。负责汇报项目设计状态、按依赖分层展示可选模块清单、引导用户批量选择模块并判定各模块的增量场景。 触发场景： (1) 项目级设计状态汇总与模块进度全景展示； (2) 用户需要从功能模块全拆解中选择一批模块进入详细设计； (3) 用户提到"模块调度"、"选择模块"、"dispatch"、"批量设计"、"多模块选择"等关键词。 本 Skill 仅负责状态汇报与模块选择——模块调度执行由编排器处理。

项目同步矛盾聚合器。收集所有子工作流上报的模块级设计矛盾，按类型和严重程度分类，以项目级视角呈现冲突全景，辅助用户做出裁决。 触发场景： (1) 模块设计完成后，需要汇总所有模块的同步矛盾形成全局视图； (2) 用户需要了解跨模块契约冲突、类型不一致或接口语义歧义等问题； (3) 用户提到"聚合矛盾"、"全局同步检查"、"项目级冲突报告"、"sync aggregation"、"cross-module conflicts"等关键词； (4) 用户需要对多个模块的同步矛盾做出统一裁决； (5) 项目级设计阶段完成后，需要最终确认所有跨模块问题已解决或已接受。

工作流预检员。在编排器正式调度 stages 之前，扫描项目现状，判断哪些 stages 看起来已经完成。 只检查、不修改任何文件。通过 Shell、Glob、ReadFile 等工具自主获取项目信息，返回 JSON 格式的阶段完成度判断。

工作流环境初始化器。负责在任意工作目录一键搭建完整的工作流基础设施，从固定的工作流生产车间拉取全部基础设施 Skill（workflow-orchestrator、preflight-checker、workflow-puller、workflow-updater 等）、契约文件、共用脚本和工作流定义。 当用户提到"初始化工作流"、"setup workflow"、"init workflow"、"拉取工作流资源"、"workflow env"、"工作流环境"、"安装工作流"、"配置工作流"、"workflow init"时，**必须优先使用本 skill**。 也用于在新项目中快速部署工作流基础设施，或修复/重置已损坏的工作流环境。 本 skill 会创建 .claude/（基础设施）和 .agent/（运行时状态）目录结构，并更新 .gitignore。

通用工作流编排器。负责将多阶段复杂任务拆解为流水线，调度 SubAgent 按 DAG 顺序执行、并发控制和确认点管理。 当用户提到"工作流"、"workflow"、"流水线"、"多阶段任务"、"编排 SubAgent"、"调度多个 agent"、 "确认后继续"、"回退到上一步"时，**必须优先使用本 skill**。 注意：用户说"你自己按步骤做"不属于工作流调度——编排器只在用户需要显式 stage 管理、确认门控、回退能力时介入。 也用于处理工作流状态查询、stage 重试、循环边界和异常回退。 负责读取 .claude/workflows/ 下的工作流 Reference 规范，维护 .agent/workflows/ 下的实例状态机与注册表， 统一收口确认点、回退与异常。不含任何业务能力。

工作流拉取器。负责在已初始化工作流环境的真实项目中，从工作流生产车间检索并拉取特定工作流定义及其配套 Skill。 当用户提到"拉取工作流"、"安装工作流"、"部署工作流"、"我需要 xxx 工作流"、"把 xxx 工作流拉过来"、"workflow pull"、"添加工作流"时，**必须优先使用本 skill**。 也用于查询有哪些可用工作流、检索工作流配套 Skill、补充项目中缺失的工作流定义。 本 skill 会扫描生产车间的工作流目录，按关键词匹配，将选定的工作流定义复制到 .claude/workflows/，并将配套 Skill 复制到 .claude/skills/（已存在的 Skill 自动跳过不覆盖）。

工作流更新器。负责在已初始化工作流环境的真实项目中，检测并同步工作流定义和配套 Skill 的更新。 当用户提到"更新工作流"、"升级工作流版本"、"同步工作流"、"workflow update"、"更新 skill"、 "工作流有新版了"、"升级 mathematical-model"、"同步 workflow"、"更新 orchestrator"、 "更新 workflow-orchestrator"、"升级基础设施 skill"时，**必须优先使用本 skill**。 也用于检查已安装工作流是否过时、对比新旧版本差异、批量更新多个工作流。 本 skill 会扫描生产车间最新版本，与目标目录已安装版本对比，在用户确认后执行差异更新。 与 workflow-puller 的核心区别：puller 用于首次安装（跳过已有 Skill），updater 用于增量更新 （对比差异、用户确认后覆盖）。

盲测执行与失败分类中枢。运行对抗性测试，辅助分类失败类型（实现漏洞/测试缺陷/契约矛盾）， 生成信息隔离的失败摘要与测试缺陷报告，执行回归/收敛检测，输出 branch_target 信号供 WORKFLOW edges 路由。 每轮输出进度摘要，支持用户提前终止。对应 Stage：s05-blindtest（adversarial-module-implementation@1.0.0）。