用途:在 Trellis 临时项目(如 /tmp/trellis-{VERSION}-2)中扫描当前实际安装、正在使用的工作流,并生成结构化 WORKFLOW_QUESTIONS.md 报告。它只负责分析与产出问题/证据文档,是 workflow-scan / workflow-repair 配对中的分析方,不修改工作流源文件、已安装产物或任务状态。
主要能力与规则:判定目标仅为临时项目内的完整工作流表面,不与源代码仓库对比;所有发现须标注来源(trellis-native 或 workflow-source)与修复分类(confirmed-defect、design-debt、evidence-gap);仅复杂度、可维护性、过度设计类观察归为 design-debt,证据不足归为 evidence-gap;严重度仅为修复前初步估计。输出须严格符合 references/scan-output-template.md 格式,写完后必须回读校验 frontmatter、摘要与发现结构;缺少 workflow-version 或 workflow-schema-version 时以 Blocked / Invalid Embedded State 停止。
使用方式:默认内联在当前 CLI 会话执行,不使用 agent;仅当输入显式包含 --agent 或等效自然语言时才启用少量辅助 agent 做只读证据收集,协调方仍由当前会话担任并独占最终结论与写报告权,不支持 agent 时必须标记 Blocked / Agent Mode Unsupported,不得静默回退。可输入 temp_project_path(默认自动探测)与 candidate_focus。修复问题需用 workflow-repair,完整审计用 workflow-audit,版本漂移分析用 workflow-capability-audit。
限制:本版本可操作缺陷范围仅限 Claude Code / OpenCode / Codex 受管表面;共享载体(如 .agents/skills/)除非临时项目证明工作流显式拥有或修补,否则不作为缺陷;有意停用且无矛盾的载体省略出最终发现集;.backup-original/ 配对补丁资产视为恢复面而非残留缺陷;临时运行时生成文件(如 finish-work-checklist.md)缺失不算发现。