菜单
无人值守的日常 issue 维护 Agent。手动触发后扫描仓库 open issue，按分类规则自动答复 / 修复 / 升级人工，绝不反向询问用户。完全跳过视觉测试系列、协议元 issue、其他 Agent 领地。触发词："/issues-autofix"、"自动修复issue"、"日常issue巡检"、"unattended issue triage"。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | issues-autofix |
| description | 无人值守的日常 issue 维护 Agent。手动触发后扫描仓库 open issue，按分类规则自动答复 / 修复 / 升级人工，绝不反向询问用户。完全跳过视觉测试系列、协议元 issue、其他 Agent 领地。触发词："/issues-autofix"、"自动修复issue"、"日常issue巡检"、"unattended issue triage"。 |
版本：v2.0.0 | 状态：已落地 | 触发：
/issues-autofix、"日常issue巡检"、"自动修复issue" | SSOT：doc/rule.skill.issues-system.md| 领地：open issue 巡检（避让visual-test:*与其他 Agent）
手动触发的"批量过 issue"技能。一轮跑完输出处理报告。不和用户来回，模糊场景按默认分支走，宁可跳过不要卡住。
完整 label 协议、跳过清单、配色等系统说明见
doc/rule.skill.issues-system.md。本文件只写"执行逻辑"。
用本技能：
别用：
/audit（auto-fix-issues 技能，语义不同）/verify/uatSSOT：
doc/design.defect-agent.automation-autonomy.md（缺陷自动化自治体系）。本技能与ai-defect-resolve同属无人值守 Agent，共用其自治模型。本技能监督层已强（§2 跳过 / §7 边界 / §12 兜底 / §13 禁止），这里把五层补齐成可辨的逐 issue 自检。
每个 issue 处理前按序自检：
needs-info / cannot-reproduce，不照过时描述改。max_diff_lines，也心算成功率 / 影响面 / 回滚代价；没把握 → 降档 proposed-fix（评论思路、不开 PR）。needs-human；开 PR 前本地校验全绿（§7）。doc/guide.faq.* 与历史同类 issue，复用既有答复 / 沉淀，不重复造轮子。protected_paths / 安全敏感 → needs-human（§5 / §13）；② 不确定性预警：拿不准 → 跳过或 proposed-fix 而非硬改（§12「跳过 > 卡住」）；③ 紧急熔断：超时 agent-timeout、复现失败 cannot-reproduce、同日幂等指纹防反复处理（§12 + §2 #6）。project_name: prd_agent
single_run_max: 30 # 单轮处理 issue 上限
max_diff_lines: 200 # 自动开 PR 的改动行数上限
max_minutes_per_issue: 10 # 单 issue 超时阈值
max_reproduce_retries: 3
protected_paths:
- prd-api/src/PrdAgent.Core/**
- prd-api/src/PrdAgent.Infrastructure/Auth/**
- .env*
- .github/workflows/**
- docker-compose*.yml
- Dockerfile*
- "**/package.json"
- "**/pnpm-lock.yaml"
faq_dir: doc
faq_prefix: guide.faq.
reply_language: match_issue
commit_pr_language: zh-CN
forbid_emoji: true
known_bots: ["*[bot]", "dependabot", "renovate", "github-actions", "claude-code-app"]
凡命中以下任一，直接 next：
known_bots 任一匹配或 user.type == "Bot"）visual-test:*（视觉测试 Agent 领地，见 #605）discussion / protocol / meta / rfctracking / epic / umbrellawip / wontfix / invalid / on-holdagent-timeout / needs-human / cannot-reproduce / duplicatehuman-onlyneeds-info 条件跳过：
needs-info，按 §5 重新分类agent-replied / agent-fixed / proposed-fix 条件升级：
needs-human + 评论"已转人工"，保留原终态 label，本轮跳过[visual-test*] / [protocol] / [rfc] / [tracking] / [meta]<!-- agent-handled:*:{今日日期 YYYY-MM-DD} -->（指纹写在评论里，不是 issue body —— body 是用户写的不该改）：扫所有评论，发现今日已处理过 → 跳过；跨日不算please-fix/bug 类 label完整跳过清单与"为什么这样设计"在
doc/rule.skill.issues-system.md§3。
single_run_maxcreated_at desc，超出排队下轮前置假设：本技能由用户手动触发，每天最多一次，同时刻只有一个实例运行。在这个假设下不需要分布式锁、claim-verify、reaper 等机制。详见
doc/rule.skill.issues-system.md§0。如果未来扩展为自动 cron / 多实例并发，需要重新设计协议（git history 里有一版 v1.0 的完整并发协议可参考）。
单 issue 的完整处理流程：
<!-- agent-handled:{run_id}:{今日日期 YYYY-MM-DD} -->agent-replied / agent-fixed / proposed-fix / needs-info / needs-human / duplicate / cannot-reproduce）失败处理（per issue）：
max_minutes_per_issue 分钟 → 加 agent-timeout + 评论"超时跳过"max_reproduce_retries 次 → 加 cannot-reproduce + 评论needs-human + 评论"已上报"，跳过修复protected_paths 涉及、跨服务接口、DB schema、依赖大版本）：needs-humanneeds-info，只问一次格式硬约束：
reply_language<!-- agent-handled:{run_id}:{今日日期 YYYY-MM-DD} -->（同日重跑时 §2 #6 跳过；跨日不算）max_diff_lines 行protected_pathsdotnet build / pnpm tsc --noEmit + pnpm lint / 关联 test任一不满足：评论修复思路（不开 PR），打 proposed-fix 等人工。
1 - editDistance/maxLen，越大越像；用 distance 度量则要求 < 0.2）或 错误信息 token 重合 ≥ 70%duplicate + 关闭分支：agent/fix-issue-{number}-{slug} 或 agent/docs-issue-{number}-{slug}（避免和 claude/、cursor/ 抢预览域名）
Commit 中文（CLAUDE.md §5.1）：fix(scope): 修复 XX 问题 (#issue)
PR 描述模板（CLAUDE.md §5.4 必含"改动 diff"）：
## 摘要
1-3 句话：解决什么 / 用什么方案。
## 改动 diff
- `path/to/file.ts`：一句话说明
- `changelogs/YYYY-MM-DD_xxx.md`：新增碎片
## 测试
- [x] tsc / build 通过
- [x] lint 零新增告警
- [x] 关联单测全绿
- [ ] 真人通过预览域名验收
## 风险评估
影响面 / 回滚方案 / 已知边界
Fixes #{issue_number}
PR 创建后回 issue 评论："修复方案已提交 #PR编号，待 review"
绝不 self-merge / force push / --no-verify
沉淀位置：doc/guide.faq.{slug}.md（doc-naming 规则要求）
结构：现象 / 原因 / 解决 / 预防
同步：更新 doc/index.yml + doc/guide.list.directory.md
完整定义见 doc/rule.skill.issues-system.md §2。
max_minutes_per_issue 分钟 → agent-timeoutmax_reproduce_retries 次 → cannot-reproduceneeds-human）duplicate 的 issueprotected_paths--no-verify / --no-gpg-signrun_id，与评论指纹对齐/cds-deploy（issue 修复后部署）/handoff（修复完通知人工）/audit（auto-fix-issues：agent-to-agent 反馈，语义不同，别混）/issues-visual-create + /issues-visual-run（本 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"、"今天干了啥"。