workflow-compliance-supervisor

用途

Workflow Compliance Supervisor 是旅程驱动型 UI/UX 项目的治理层技能。它检查系统是否做到了它所承诺的事情，被跳过的阶段是否有正当理由，以及用户是否能看到诚实的理由和后续动作。

它不执行设计/构建任务，也不覆盖 senior-ui-ux-orchestrator。

主要能力

运行模式

gate：在继续或关闭某个阶段之前检查当前项目。
review：审计已有的任务计划、进度状态、进度界面和证据集。
log：追加或校验 workflow-log.jsonl 事件。
fixture-test：运行 lazy-skip 和 fake-evidence 夹具。
explain：向用户解释某个阶段为何被暂停、跳过、退回返工或阻塞。

决策状态

continue：证据充分，或偏差没有实质性影响。
pause_for_user：缺少用户数据、审批、预算、凭据或生产确认。
return_to_rework：声称的完成缺乏证据，或违反旅程契约。
skip_with_reason：阶段被有意跳过，且原因被接受、影响可见。
block：继续会损害质量、隐私、合法性、生产安全或旅程完整性。

使用方式

必需工作流

阅读 references/decision-framework.md。
阅读 references/evidence-and-log-rules.md。
如果输出将展示给非技术用户，阅读 references/user-messaging.md。
定位规范的项目 TASK-PLAN.md。
定位声明的旅程注册表。默认本地注册表：$UIUX_SKILL_SYSTEM_ROOT/data/journey-registry.json。
将声明的旅程阶段与任务计划声明、进度状态、报告、截图和日志进行比对。
对每个受影响阶段产出一个决策：continue、pause_for_user、return_to_rework、skip_with_reason 或 block。
对每个跳过项，要求可接受的原因码、影响和后续动作。
对每个 done/Ran 声明，要求真实证据。
仅在用户要求执行或校验时，写入或更新经过脱敏的报告/日志。

本地校验命令

python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_compliance.py" --fixtures
python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_log.py" --fixtures
python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_compliance.py" --project "$PROJECT_ROOT" --journey new-premium-site --out "$PROJECT_ROOT/reports/workflow-compliance-report.md" --log "$PROJECT_ROOT/workflow-log.jsonl"

技能包检查：

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/workflow-compliance-supervisor
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/workflow-compliance-supervisor

交接结构

Declared journey:
Checked artifacts:
Decision:
Reason code:
Evidence:
User-visible message:
Next action:
Can continue:
Must rework:
Skipped with accepted reason:
Blocked:

适用场景

适用于需要验证承诺的用户旅程、TASK-PLAN.md、progress-state.json、渲染的进度 HTML、证据产物与跳过阶段是否一致的 UI/UX 项目；也适用于审计已有任务计划、进度状态、进度界面和证据集，或向用户解释阶段被暂停、跳过、退回返工、阻塞的原因。

限制

硬性规则

不接受 model_convenience、implicit_assumption、planned_counted_as_ran 或 tool_not_called_but_marked_done。
不将计划中的命令标记为已执行。
当仅运行了演示切片时，不宣称完整旅程已完成。
不存储密钥、令牌、Cookie、.env、恢复码、私密截图或原始供应商载荷。
可选的外部工具、爬取、上传、付费 API、生产部署、分析、广告和账户变更需要明确审批。

该技能不执行设计/构建任务，也不覆盖 senior-ui-ux-orchestrator。