prd_agent

识别每日验收、PR 验收、commit 验收、未发布分支验收、缺陷复测、视觉回归和发布前验收等场景，并为 create-visual-test-to-kb 生成测试范围、指差法步骤、预期结果、证据链、截图回读和报告结构。Use when the user asks to optimize or run visual acceptance across different scenarios, asks whether yesterday's changes, a PR, a commit range, or an unpublished branch were really accepted, or needs PR/commit results to map to screenshots and MAP knowledge base reports.

Convert PRs, commits, yesterday's changes, or release scope into a test-minded acceptance design before visual execution. Use when the user asks for daily acceptance, visual acceptance, PR/commit acceptance, proof that code changes really affected product behavior, coverage planning, fusion testing, evidence strength, or when screenshots/reports looked related but failed to prove the assigned task.

工业级功能验收/视觉测试全流水线（MAP 验收标准 v2）——模拟人类的浏览器取证 + 标准化验收报告 + 归档进 CDS 验收中心并出直达深链。职责分离：验收报告永远按项目归 CDS（平台自带、证据链内置），MAP 等系统通过知识库开放协议从 CDS 拉取展示，技能不再分流到 MAP 知识库。一个技能内含三段：标准/模板、模拟人类浏览器取证（点击导航进入、禁地址栏直达、双主题截图、ZZ 照做风画框标序号 stepClick/stepShot）、报告归档（命名结构固定，**每次归档强制输出可达地址**：CDS 直达深链 /reports，匿名对外用 /r/token）。默认报告走 **ZZ 照做风**（全大标题 + 一句话一步 + 逐步配图 `{{IMG:}}` + 文字在上图在下 + 变化处画框 + 分支顺序讲，同岗位照做必复现）。归档前有**强制准入校验**：目标/档位/Verdict/截图数/证据完整性/报告结构不达标直接拒收（入口准则，杜绝"什么都能进"）。项目无关，改 acceptance.config.json 即可跨仓库复用；无 CDS/离线退化为本地 md+截图。触发词："视觉验收"、"验收"、"视觉测试"、"验收归档"、"归档验收报告"、"create visual test"、"/视觉验收"、"/验收"。

CDS (Cloud Dev Space) core skill — hosts the canonical cdscli Python CLI, handles authentication (static AI_ACCESS_KEY / dynamic pairing / project key), manages env vars and project keys, owns CDS service self-update, defines the preview-URL slug formula, and acts as dispatcher when the user's intent is ambiguous between cold-path scanning and hot-path debugging. Activates when the user mentions CDS generically without specifying scan-or-deploy, configures CDS credentials, manages env / keys, updates the CDS service code itself, or asks about preview URL conventions. Does NOT directly perform project scanning (delegates to cds-project-scan, the cold path) or deployment debugging (delegates to cds-deploy-pipeline, the hot path). Trigger phrases include "cds 认证", "AI_ACCESS_KEY", "项目 key", "cds 自更新", "cds self-update", "预览地址公式", "配 cds 环境变量", "/cds", "/cds-auth", and the bare word "cds" when the user has not yet picked a direction.

Generates weekly project reports from git history. Collects commits, PRs, and contributor data, analyzes and categorizes changes, then produces a structured Chinese-language weekly report (overview, completed items, next-week priorities) saved to doc/report.YYYY-WXX.md. Trigger words: "生成周报", "写周报", "weekly report", "本周总结".

从 git 历史生成「今日大事早知道」开发日报，并发布到知识库（文档空间）。按「新增功能多讲 → 优化/修复次之 → 计划/遗留垫底」的固定权重分层叙事。自动 find-or-create「日报知识库」并出分享链。触发词："生成日报"、"写日报"、"今日大事"、"日报"、"daily report"、"/daily"、"今天干了啥"。

Performs a production hotfix release by merging a specific branch or commit into the currently deployed production baseline, building release artifacts, deploying through the existing production script, and verifying live status. Activates only when the user explicitly requests "热发布线上版本", "线上热修", "hotfix production", "把特定分支发到正式环境", or mentions a production SSH host plus a branch/commit to release. Includes strict rules forbidding secrets from being saved in code or exposed in logs.

AI 辅助缺陷修复技能。用于缺陷自动化日常任务：通过 MAP/PrdAgent domain 和长期 AgentApiKey 使用缺陷工作流协议领取单个缺陷，完成轻量修复、提交 commit、回写提交信息，并在必要时兼容缺陷分享 agentLaunch。触发词："修复缺陷"、"解决缺陷"、"缺陷自动修复"、"ai-defect-resolve"。

开发任务完成后自动扫描变更，从导航、文档、规则、工作流、测试、风险、代码质量、后续事项八个维度生成结构化交接报告，让验收者零追问即可核对。触发词："交接"、"验收"、"handoff"、"/handoff"。

Guards document creation and modification in the doc/ directory, enforcing 7 standardized type templates (spec, design, plan, rule, guide, report, debt). Validates file naming, header format, and type compliance. Manually triggered via /doc to show the type quick-reference, or auto-triggered when creating/modifying .md files under doc/. Trigger words: "写文档", "新建文档", "文档模板", "/doc".

文档索引同步技能。扫描 doc/ 目录，自动对齐 index.yml 和 guide.list.directory.md。手动触发 /doc-sync，或由周报技能自动调用。触发词："同步文档索引"、"更新文档目录"、"doc sync"、"/doc-sync"。

Generates a step-by-step user acceptance test (UAT) checklist that a real human executes by hand, with expected results and failure playbooks at every checkpoint. Covers CLI + Web UI scenarios, supports cold-start injection, and is checkbox-driven so the operator can mark progress. Trigger words: "/uat", "验收清单", "真人验收", "acceptance test", "让我验收".

Audits code for post-migration residue and technical debt across 10 dimensions (dead fields, dead branches, compat shims, naming artifacts, redundant params/types, stale comments, migration guards, over-abstraction, near-duplicates, config-code drift). Outputs a structured report with auto-fix plan. Trigger words: "代码卫生", "清理残留", "hygiene", "代码体检", "/hygiene".

PR 前将 main 分支合并进当前特性分支，由 AI 代替开发者分级解决冲突，产出预合并报告并保证零冲突提交。触发词："合并主分支"、"预合并"、"merge main"、"/resolve"。

Creates and evaluates Claude Code SKILL.md files following Anthropic best practices. Generates well-structured skills with correct frontmatter, progressive disclosure, and quality validation. Trigger words: "创建技能", "新建 skill", "create skill", "技能评分", "skill score", "/create-skill".

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Multi-perspective code verification that simulates human review. Combines adversarial debate (Devil's Advocate), reverse verification, boundary testing, and user scenario simulation to catch issues that compilers and linters miss. Trigger words: "/verify", "验证一下", "帮我检查".

老王智能体——米多文化的化身。当用户表达"任务太难"、"卡住了"、"不知道怎么办"、"理不清头绪"、"任务太多搞不定"、"求助老王"、"找老王"、"老王帮我"、"/laowang"等困境信号时主动触发， 用米多解决问题五步法（直面问题 → 抓主要矛盾 → 责任到人 → 备齐资源 → 做好才算做）帮用户拆解任务。 风格强硬直率，奉行"回归常识、以终为始、贡献论英雄"，坚决反对软骨病/玻璃心/巨婴症/侏儒症与"三会"（表态/邀功/甩锅）。 副作用：50% 概率在拆解后追加一项新任务（"顺便把 X 也补一下"），用户可以拒绝。

Provides Remotion knowledge context for video scene code generation. Supplies the LLM Gateway with Remotion API references, animation utilities, reusable component libraries, and scene design principles to generate high-quality Remotion JSX code for video Agent storyboard scenes. Trigger words: "优化场景", "升级动效", "美化视频", "remotion codegen", "scene code", "场景代码生成".

基于 MECE 分析法对功能变更做全维度风险评估，按概率与影响在六个不重叠维度（正确性/兼容性/性能容量/安全合规/运维部署/用户体验）打分，产出可决策的风险矩阵报告。触发词："风险评估"、"风险矩阵"、"risk matrix"、"这样改有什么风险"、"/risk"。

Validates new feature requirements before development begins. Combines requirement smell detection (ambiguity, incompleteness, untestability), deduplication against existing features, and multi-dimensional scoring (RICE + ISO 29148 hybrid) to produce go/no-go decisions with improvement suggestions. Trigger words: "验证需求", "评估需求", "需求评审", "validate requirement", "这个需求靠谱吗", "/validate".

为任意前端项目添加主题切换圆形过渡动效（View Transition API + clip-path 水波纹扩散）。适用于 React/Vanilla/Tauri 等技术栈，含完整 CSS、JS 代码与降级方案。触发词："主题过渡"、"皮肤切换动效"、"theme transition"、"ripple theme"、"/theme-transition"。

UI/UX design intelligence. 67 styles, 96 palettes, 57 font pairings, 25 charts, 13 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

新增 Agent 权限。当需要为新功能添加权限时，自动判断分类并同步修改所有相关文件。触发词："加权限"、"新增权限"、"add permission"、"注册 agent"。

Scans local project structure and generates or uploads CDS compose YAML for project onboarding (the cold path of CDS lifecycle). Activates when the user wants to register a new project to CDS, regenerate the compose contract after structural changes, or push cds-compose.yml to CDS for approval. Detects tech stacks (.NET, Node, Rust, Python, Go), infrastructure services (MongoDB/Redis/Postgres), environment variables and routing prefixes; can submit via --apply-to-cds. Does NOT handle deployed-branch debugging, container logs, deploy failures, smoke tests, or CDS service self-update — those belong to cds-deploy-pipeline (hot path) and cds (core). Trigger phrases include "扫描项目", "接入 CDS", "生成 compose", "上传 cds 配置", "apply to cds", "注册项目到 cds", "register project", "/cds-scan", "--apply-to-cds".

无人值守的日常 issue 维护 Agent。手动触发后扫描仓库 open issue，按分类规则自动答复 / 修复 / 升级人工，绝不反向询问用户。完全跳过视觉测试系列、协议元 issue、其他 Agent 领地。触发词："/issues-autofix"、"自动修复issue"、"日常issue巡检"、"unattended issue triage"。

手动触发创建一个视觉验收子 issue。输入"要测什么"（PR 号 / 页面路径 / 提交 hash），按

24h 视觉测试执行者 Agent 的逻辑。手动触发后从仓库拉取所有 label = visual-test:pending 的 issue，按子 issue body 的矩阵跑用例，回评论失败项 + 截图 + 严重级，或 /visual-pass 通过。完全不创建新 issue。触发词："/issues-visual-run"、"执行视觉验收"、"视觉测试接单"、"visual test run"。

Agent 开发新手引导技能。读取 .agent-workspace/ 下的进度文件，告诉用户当前阶段、下一步操作、推荐技能。 首次使用时引导用户给 Agent 取名并创建工作区。支持全生命周期引导：破冰→需求→设计→建造→验收。 触发词: "/help", "新手引导", "agent引导", "开发引导" 注意: 仅当用户明确请求新手引导时触发。日常对话中的"下一步""进度"等词不应触发此技能。

用 AI Access Key 认证查询 PrdAgent 真实 API 数据，辅助排查问题、核对数据状态、理解系统行为，产出可直接分析的 JSON 响应。触发词："查 API 数据"、"调试接口"、"看真实数据"、"api debug"、"verify data state"。

Agent 与 Agent 之间互相提交、修复、复测 GitHub issue 的自动巡检协议。当一个 agent 用另一个 agent 的产物（cdscli、prd-api、共享 skill 等）发现 bug、阻塞、能力缺口时，用本技能产出标准 issue / tracker / PR 收尾清单 / 复测报告，避免 agent 之间反复确认"修没修、修对没修、复测了没"。触发词："巡检"、"自动巡检"、"反馈给对方 agent"、"复测修复"、"agent 间提 issue"、"/audit"、"/auto-fix-issues"。

全自动接入 CLI Agent 执行器。用户只需说出执行器名称和用途，Claude 自动完成：读取代码 → 生成执行器 → 注册 → 自测 → 完成。触发词：'创建执行器', '接入执行器', 'create executor', '新增执行器', '/create-executor'。

创建「教程小书」的路径式引导演示(DailyTip + 多步 Tour)。**主要触发词**:"帮我创建一个小技巧 XX" / "创建 XX 演示" / "做一个 XX 教程" / "增加教程" / "增加引导" / "/createzzdemo 缺陷管理"。**工作流分 3 阶段**:(1) 枚举 A-F 6 类候选步骤让用户选组合;(2) 按选中输出 DailyTipUpsert JSON + 打断风险分析 + 角色推荐(PM/DEV/QA);(3) POST 入库后立刻引导管理员点「Play 试播」验证效果。内置模板:缺陷管理全链路、更新中心周报、知识库发布、**大全套(showcase-all-features,含预填+多步高亮+撒花,用于回归测试)**。键盘快捷键(Ctrl+B/K)**不适合**此技能,走静态 key-hint。

Performs end-to-end cross-layer data flow tracing for untrusted code changes. Traces data from entry to exit across backend C#, Rust Tauri, and frontend React layers, verifying field names, types, serialization rules, and error handling at every seam. Trigger words: "/deep-trace", "深度追踪", "deep trace".

通用涌现式功能设计技能。面向任意模块（文档空间、CDS 面板、PR 审查、工作流、视觉创作等）—— 扫描目标模块的现有能力、与全局基础设施（LLM Gateway / Bridge / Attachment / Run-Worker）交叉相乘， 浮现出"独有且可落地"的新功能。反对抄袭竞品，强调组合本系统已有砖块。每次调用产出一个可执行方案。 触发词："涌现"、"emerge"、"发散想一下"、"下一个功能"、"/emerge"、"feature emerge"。

对指定功能或模块做全链路追踪（数据流/控制流/错误流），从入口一路追到数据库或 LLM，产出非技术人员也能看懂的端到端路径图（含决策点、数据变换、降级路径）。触发词："/trace"、"路径追踪"、"追踪 XXX"、"这个功能是怎么跑的"、"数据是怎么流转的"、"flow trace"。

排查大模型调用链路问题的方法论。当出现"前端选 A 后端跑 B"、"LLM 日志 model 字段不对"、"自定义模型调度被忽略"类 bug 时触发。强制走"捕获前端真实请求 → DB 真实状态 → 每层 resolve 调用审计 → 对比 LLM 日志实际 body.model"的顺序，禁止靠 DI 装饰器/AsyncLocal 打补丁。触发词："/llm-trace", "模型调用不对", "LLM 日志不符", "选 A 给 B", "trace model".

LLM 交互过程可视化审计。扫描代码中所有 LLM 调用点，检查是否符合「禁止空白等待」原则，生成合规报告并提供修复建议。触发词："可视化审计"、"llm visibility"、"/visibility"。

分支受控检查：分析当前分支所有变更，自动识别开发的 Agent，逐文件分类为 owned/shared/foreign， 检测越界修改和 append-only 违规。用于提交前或交接时的边界审计。 触发词: "/scope-check", "边界检查", "检查边界", "受控检查"

自动生成冒烟测试 curl 命令。扫描目标模块的 Controller 端点，生成链式 curl 命令（前一步的输出 ID 传给后续请求），读取环境变量 AI_ACCESS_KEY 作为认证凭据。触发词："冒烟测试"、"smoke test"、"跑个冒烟"。