SuperAPI AI 工具集

agent-progress-visualizer

办公与效率

查看项目

更新于 10-16 06:52

技能介绍

用途:为 UI/UX Agent Skill System 项目生成面向用户的进度驾驶舱,将规范任务计划状态翻译成非技术用户可读的通俗 HTML 进度页面。

主要能力与模式:bootstrap 在系统接受较大用户请求后、TASK-PLAN.md 存在前立即创建首个可见进度页;init 在 TASK-PLAN.md 存在后创建或替换任务计划派生的进度状态与页面;update 在任务计划、报告、产物、反馈或 wiki 变化后重新生成;review 检查现有进度页是否偏离事实来源、存在虚假状态、隐私泄露或文案混乱;feedback-gate 暴露用户决策与评论并交给 design-feedback-collector;developer-view 显示技术任务 id、技能路由、依赖与产物路径。

事实来源规则:bootstrap 阶段 project-request.json 与 workflow-log.jsonl 仅为启动来源;规划后 TASK-PLAN.md 为规范来源;progress-state.json 是派生的机器可读状态;agent-progress-screen.html 是派生的可视层。若 Markdown、JSON、HTML 不一致,应先修 Markdown 或生成器再重新生成。仅浏览器 localStorage 或剪贴板状态不被接受为决策的唯一记录。

使用方式:先阅读 references/data-source-contract.md、references/decision-framework.md、references/safety-boundaries.md。bootstrap 模式不要等待 TASK-PLAN.md,立即创建文件并渲染页面。本地实现可用 bootstrap_progress_screen.py --open-browser 打开浏览器;init/update 模式定位规范 TASK-PLAN.md,从任务计划字段、报告、产物、反馈状态与经脱敏的 wiki 决策构建 progress-state.json,再渲染 HTML。init 模式创建后立即在浏览器打开;update 模式仅在用户要求或正在审查时打开。用户选择、评论、批准或拒绝须交给 design-feedback-collector;大型多会话项目的已接受决策经脱敏后交给 project-wiki-manager。

默认产物:project-request.json、TASK-PLAN.md、progress-state.json、agent-progress-screen.html、workflow-log.jsonl、feedback/progress-feedback-register.schema.json、reports/progress-validation-summary.txt。可使用 assets/progress-state.template.json 作为起始状态。

限制:该技能不执行项目任务,不拥有规范状态。客户模式使用通俗语言,开发者模式才可显示任务 id、技能路由、依赖与产物路径。绝不显示密钥、令牌、恢复码、cookie、.env 值、私有截图或私有 URL。

必要命令保持原样: python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/bootstrap_progress_screen.py" --project-root "$PROJECT_ROOT" --project-title "$PROJECT_TITLE" --user-request "$USER_REQUEST" --journey-registry "$UIUX_SKILL_SYSTEM_ROOT/data/journey-registry.json" --declared-journey new-premium-site --open-browser python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/check_bootstrap_progress.py" --project-root "$PROJECT_ROOT" python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/generate_progress_state.py" --task-plan "$UIUX_SKILL_SYSTEM_ROOT/TASK-PLAN.md" --out "$UIUX_SKILL_SYSTEM_ROOT/progress-state.json" python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/render_progress_screen.py" --state "$UIUX_SKILL_SYSTEM_ROOT/progress-state.json" --out "$UIUX_SKILL_SYSTEM_ROOT/agent-progress-screen.html" python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/check_progress_consistency.py" --task-plan "$UIUX_SKILL_SYSTEM_ROOT/TASK-PLAN.md" --state "$UIUX_SKILL_SYSTEM_ROOT/progress-state.json" --html "$UIUX_SKILL_SYSTEM_ROOT/agent-progress-screen.html" python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_compliance.py" --fixtures python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/no_secret_scan.py" "$UIUX_SKILL_SYSTEM_ROOT"

适用场景:需要向非技术用户或客户展示项目进展、在规划前立即给出可见进度页、或在任务计划变化后同步更新进度页的项目。