mcpField
W
workflow-compliance-supervisor

workflow-compliance-supervisor

github.com/sergekostenchukAgent 工作流3253 次安装18 周前更新
代码仓库

关于 workflow-compliance-supervisor

用于旅程驱动型 UI/UX 项目的治理 Skill，会依据已声明阶段核对计划、进度和证据，并给出阶段决策。它不执行设计或构建任务，也不取代 UI/UX 编排器。

主要功能

  1. 01按计划核对项目阶段
  2. 02审查进度与证据
  3. 03验证工作流日志事件
  4. 04要求跳过阶段说明原因和后续行动
  5. 05拒绝无证据的完成声明

适用场景

  1. 01在项目进入下一阶段前设立关卡
  2. 02审计任务计划与进度报告
  3. 03解释阶段暂停或受阻的原因
  4. 04验证工作流日志和测试夹具

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill workflow-compliance-supervisor

安装后在 Claude Code 中输入/workflow-compliance-supervisor确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
evals/
evals.json
references/
decision-framework.md
evidence-and-log-rules.md
user-messaging.md
scripts/
run_local_validator.py

详细介绍

工作流合规监督器

此技能是以用户旅程驱动的 UI/UX 项目的治理层。它会检查系统是否兑现承诺、跳过的阶段是否有合理依据，以及用户是否能看到真实的原因和后续操作。

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

运行模式

  • gate：检查当前项目，然后再继续或结束某个阶段。
  • review：审查现有任务计划、进度状态、进度界面和证据集。
  • log：追加或验证 workflow-log.jsonl 事件。
  • fixture-test：运行延迟跳过和虚假证据测试样例。
  • explain：向用户解释某个阶段为何暂停、跳过、退回返工或受阻。

必需工作流

  1. 阅读 references/decision-framework.md。
  2. 阅读 references/evidence-and-log-rules.md。
  3. 如果输出将展示给非技术用户，请阅读 references/user-messaging.md。
  4. 找到规范的项目 TASK-PLAN.md。
  5. 找到已声明的用户旅程注册表。默认本地注册表：$UIUX_SKILL_SYSTEM_ROOT/data/journey-registry.json。
  6. 对照任务计划中的声明、进度状态、报告、截图和日志，检查已声明的用户旅程阶段。
  7. 为每个受影响阶段给出一项决策：continue、pause_for_user、return_to_rework、skip_with_reason 或 block。
  8. 每次跳过都必须提供可接受的原因代码、影响和后续操作。
  9. 每项 done/Ran 声明都必须有真实证据。
  10. 只有在用户要求执行或验证时，才编写或更新经过脱敏的报告/日志。

决策状态

  • continue：证据充分，或偏差没有实质影响。
  • pause_for_user：缺少用户数据、审批、预算、凭据或生产确认。
  • return_to_rework：声称已完成但缺少证据，或违反用户旅程契约。
  • skip_with_reason：有明确理由且已说明影响地跳过某个阶段。
  • block：继续执行会危及质量、隐私、合法性、生产安全或用户旅程完整性。

硬性规则

  • 不得接受 model_convenience、implicit_assumption、planned_counted_as_ran 或 tool_not_called_but_marked_done。
  • 不得将计划执行的命令标记为已执行。
  • 仅运行了演示切片时，不得声称完整用户旅程已完成。
  • 不得存储机密、令牌、Cookie、.env、恢复码、私人截图或原始服务提供商负载。
  • 使用可选外部工具、爬取数据、上传内容、付费 API、生产部署、分析、广告和账号变更，均须获得明确批准。

本地验证命令

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:

评论

支持 Markdown