sergekostenchuk/ui-ux-agent-skill-system

workflow-compliance-supervisor

Use when a UI/UX project must verify that the promised user journey, TASK-PLAN.md, progress-state.json, rendered progress HTML, evidence artifacts, and skipped stages are consistent.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill workflow-compliance-supervisor

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Workflow Compliance Supervisor

This skill is the governance layer for journey-driven UI/UX projects. It checks whether the system did what it promised, whether skipped stages are justified, and whether the user sees honest reasons and next actions.

It does not execute design/build tasks and does not override senior-ui-ux-orchestrator.

Operating Modes

  • gate: check the current project before continuing or closing a phase.
  • review: audit an existing task plan, progress state, progress screen, and evidence set.
  • log: append or validate workflow-log.jsonl events.
  • fixture-test: run lazy-skip and fake-evidence fixtures.
  • explain: explain to the user why a stage is paused, skipped, returned to rework, or blocked.

Required Workflow

  1. Read references/decision-framework.md.
  2. Read references/evidence-and-log-rules.md.
  3. Read references/user-messaging.md if the output will be shown to a non-technical user.
  4. Locate the canonical project TASK-PLAN.md.
  5. Locate the declared journey registry. Default local registry: $UIUX_SKILL_SYSTEM_ROOT/data/journey-registry.json.
  6. Compare declared journey stages with task-plan claims, progress state, reports, screenshots, and logs.
  7. Produce one decision per affected stage: continue, pause_for_user, return_to_rework, skip_with_reason, or block.
  8. For every skip, require an acceptable reason code, impact, and next action.
  9. For every done/Ran claim, require real evidence.
  10. Write or update a sanitized report/log only when the user asked for execution or validation.

Decision States

  • continue: evidence is sufficient or deviation has no material impact.
  • pause_for_user: missing user data, approval, budget, credentials, or production confirmation.
  • return_to_rework: claimed completion lacks evidence or violates the journey contract.
  • skip_with_reason: stage is intentionally skipped with accepted reason and visible impact.
  • block: continuing would compromise quality, privacy, legality, production safety, or journey integrity.

Hard Rules

  • Do not accept model_convenience, implicit_assumption, planned_counted_as_ran, or tool_not_called_but_marked_done.
  • Do not mark planned commands as executed.
  • Do not claim that a full journey is complete when only a demo slice ran.
  • Do not store secrets, tokens, cookies, .env, recovery codes, private screenshots, or raw provider payloads.
  • Optional external tools, crawls, uploads, paid APIs, production deploys, analytics, ads, and account mutations require explicit approval.

Local Validation Commands

bash
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"

Skill package checks:

bash
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

Handoff Shape

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

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
sergekostenchuk
社区

admin-ui-builder

Use when admin/CMS/back-office screens need to be built or specified after admin-ui-orchestrator defines roles, permissions, workflows, and safety gates. Covers tables, forms, editors, moderation queues, dashboards, CRUD surfaces, and state coverage without production destructive actions.

1小时安装量
1
GitHub Stars
35
最近更新
9月13日
sergekostenchuk
社区

admin-ui-orchestrator

Use when a project needs admin/CMS/back-office UI architecture: roles, permissions, content workflows, AI assistant boundaries, audit logs, destructive-action confirmations, and builder handoff. Planning only; do not perform production admin actions or expose secrets.

1小时安装量
1
GitHub Stars
35
最近更新
9月13日
sergekostenchuk
社区

analytics-setup-architect

Use when a website or web app needs privacy-aware analytics architecture: GA4, Yandex Metrica, self-hosted analytics, consent, UTM, event taxonomy, funnels, dashboards, and launch verification. Do not mutate real analytics accounts or store credentials without explicit approval.

1小时安装量
1
GitHub Stars
35
最近更新
9月13日
sergekostenchuk
社区

editorial-quality-gate

Review public site content for editorial quality, source support, prompt residue, duplicate blocks, translation drift, hidden filler, and human usefulness before SEO or LLM-friendly publication. Use this skill when the user asks to quality-gate news briefs, longform explainers, blog posts, topic pages, project pages, translated content, or generated article drafts without changing the live publishing pipeline.

1小时安装量
1
GitHub Stars
35
最近更新
9月13日