| name | ask-anhoder |
| description | 自动路由并调用合适的 open-mercato/skills 技能(om-*)。当用户描述一个任务但不确定该用哪个技能、或需要端到端工作流串联时使用。路由唯一明确时自动加载目标技能并按其工作流执行,不只给建议;路由模糊(多个候选都合理)时先列出候选让用户选择,确认后再执行。 |
| disable-model-invocation | true |
Ask Anhoder
你不必记住全部 36 个技能,按场景问这里。路由唯一明确时自动调用目标技能并执行(见「自动调用协议」),而不是只输出一条 Next: 建议;路由模糊(多个候选都合理)时不自动调用,先列出候选让用户选择(见「路由规则 1」)。
技能本体(SKILL.md)是权威参考;本技能是路由地图。完整速查表见仓库根目录 SKILLS_WORKFLOW.md。
主流程:想法 → 合并的 PR
大多数工作走这条主线。按现状选入口,后续环节由技能内部链与标记行自动串联,无需手动接续。
- 已有 issue / 问题描述 →
om-auto-fix-issue <issue-id|问题描述> — 自动分类后端到端执行:bug 走 om-verify-in-repo → om-root-cause → om-fix → om-open-pr → om-auto-review-pr 链(UI 修复附带 om-auto-qa-pr 截图证据);feature 走写 spec → 实现链。常用变体 --no-ui(跳过 UI QA)、--loop(长计划)、--interactive(每步确认)、--force(接管他人认领)。
- 只有任务 brief / 模糊想法 →
om-auto-create-pr "<brief>" — 隔离 worktree 中规划 → 分阶段实现 → 跑验证门禁 → 打开带标签 PR;Step 数超 20 自动转 loop 版(--loop 强制)。若想法还太模糊、值得先想清楚再动手 → om-brainstorm "<主题>"(交互式发散收敛,产出移交 brief 与 Next: 路由行)。
- 已有 spec / spec PR →
om-auto-implement-spec <spec 路径|名称|issue|PR 号> — 实施 spec,交付已验证、已评审、UI 已截图的 ready PR。
- 想法清晰,先建档 →
om-prepare-issue "<想法>" — 查重、贴 spec、打 SDLC 标签,建 issue 不实施;之后可再路由 om-auto-fix-issue。
On-ramps(汇入主流程的入口)
- PR 推进与合并
- "这个 PR 下一步该干什么 / 推进到合并" →
om-pr-autopilot <pr> — 诊断十信号 → 自动编排对应技能链 → 状态报告,默认停在 merge-ready。
- "恢复中断的 PR" →
om-auto-continue-pr <pr> — 无计划则从 PR 上下文收养重建;计划过长自动移交 loop 版。
- "把这个 PR 弄到能合并" →
om-auto-fix-pr <pr> — 合入最新 base → 循环修评审发现/CI/UI QA;--ci-only 只修 CI。不自己合并。
- "合并这个 PR" →
om-approve-merge-pr <pr> — 复核全部门禁(含 QA 门禁)→ approving review → squash 合并;有阻塞信号时拒绝。
- 评审
- "评审这个 PR" →
om-auto-review-pr <pr>(单 PR);"评审所有未评审 PR" → om-review-prs(批量,最新在前,尊重 in-progress 锁)。
- 提交分支 →
om-check-and-commit — 先跑完整验证门禁,全绿且用户明确要求才提交推送。
Standalone(独立技能)
- QA 与测试:
om-auto-qa-pr <pr>(浏览器 UI QA + 截图证据);om-prepare-test-env(一次性准备可复用测试环境);om-integration-tests(探索运行中的应用编写 E2E 测试)。
- Issue 卫生:
om-auto-manage-issues(批量清洗:补标签/澄清/标注缺 spec,--write-missing-specs 顺带补 spec);om-close-fixed-issues(按 fixes/closes/resolves 关键字关闭已修复 issue);om-followup-issue-from-pr <链接>(PR 遗留诉求 → 跟踪 issue)。
- UX 设计:
om-ux-setup(抽取仓库设计契约到 .uxproof/,一次);om-ux-shape "<想法>"(塑形决策,Shape/Review/Handoff 三模式);om-ux-review-pr <pr>(证据优先的 PR UI 设计评审)。
- 管道与技能维护:
om-setup-agent-pipeline(重新配置管道,仓库已配置过,重跑前会先询问);om-apply-upgrade-notes(技能升级后同步描述符,--dry-run 先预览);om-pipeline-retro(管道运行成本复盘,只读);om-create-skill "<brief>"(写新技能/拆分大 SKILL.md)。
- 发布收尾:
om-auto-update-changelog --version <x.y.z>(为上次 release 以来合并的 PR 起草 CHANGELOG 条目并落 docs PR)。
- 只读咨询(不认领、不改动):
om-merge-buddy(哪些 PR 现在能合并)、om-root-cause(issue 根因分析)、om-code-review(diff/分支审查)、om-verify-in-repo(缺陷分流验证)。
自动调用协议
路由不是终点。确定目标技能后立即自动调用并执行,不要只输出建议:
- 先判唯一性,模糊先问:意图与已有信息能唯一确定目标技能时直接进入第 1 步;若多个候选技能都合理(如"处理这个 PR"可指
om-pr-autopilot / om-auto-fix-pr / om-auto-review-pr,"评审"可指 om-auto-review-pr / om-code-review),停下来把候选路由呈现给用户——每个候选附一句话适用场景并标注你的推荐,等用户选定后再调用,不自行拍板。
- 加载目标技能:读取
../om-<skill>/SKILL.md(ask-anhoder 与 om-* 同处 .agents/skills/;.claude/skills/om-<skill>/SKILL.md 是同一文件的符号链接)。工作流中引用的 references/*.md 一并读取。配置加载、认领协议等共同契约由目标技能自行处理。
- 解析参数:按目标技能的 Arguments 从用户描述中提取所需参数(issue/PR 号、brief、spec 路径、
--no-ui/--loop/--force 等标志)。关键参数缺失时先问用户(见路由规则 2),不要猜测 issue 号或 PR 号。
- verbatim 执行:按目标技能 SKILL.md 的 Workflow 逐条执行,遵循其 Rules 与 Security boundaries;链内技能的输出(如
om-root-cause 的 brief)原样传递给下一环节。不自行发明步骤,不绕过其门禁。
- 保留标记行:汇报结束时转述目标技能产出的机器可解析链式行(
PR: / Issue: / Spec: / Next: / NO_ACTION_NEEDED),供下一环节自动串联或让用户知道停在哪。
- 停下等待用户的情况:(a) 路由模糊,候选技能需用户选择(见路由规则 1);(b) 目标技能自身要求人类介入——
om-brainstorm 的路由确认、认领冲突询问、--interactive 模式、om-ux-shape/om-ux-review-pr 的对话环节;(c) 目标技能产出阻塞结论(NO_ACTION_NEEDED、Status: blocked、需用户决策的守卫)——向用户报告原因与证据,不自行绕行。
路由规则
- 唯一路由才自动调用:意图与信息能唯一确定目标技能时,给出路由的同时就自动调用(见自动调用协议),不罗列无关可能;路由模糊(多个候选都合理)时不自动调用,改为列出候选路由让用户选择——每个候选给一句话适用场景,标注你的推荐,用户选定后再执行。
- 先澄清再路由:用户描述模糊(没有 issue 号、没有 PR 号、不知道是 bug 还是 feature)时,先问一个问题补齐关键信息再路由。
- 长诉求拆链:多个阶段的诉求按顺序给主入口即可——如"实现功能并合并"只路由
om-auto-fix-issue 或 om-auto-create-pr,后续环节由技能自动串联(标记行 PR:/Issue:/Spec: 驱动)。
- 只读咨询不认领:用户只是了解情况("哪些 PR 能合并"、"issue 根因"、"管道成本")时,路由到只读技能(
om-merge-buddy、om-root-cause、om-code-review、om-pipeline-retro),同样自动调用,但不产生认领与变更。
- 兜底:拿不准时读
SKILLS_WORKFLOW.md 速查表;流程细节查 SDLC.md(标签状态机/QA 门禁/认领协议)、审查规则查 CODE_REVIEW.md、契约表面查 BACKWARD_COMPATIBILITY.md。
- 交互式技能例外:目标技能本身是对话型(
om-brainstorm、om-ux-shape 等)时,按其 workflow 进行对话,确认路由后由它决定下一技能,本技能不越过其确认门。
本仓库环境提示
- 配置:
.ai/agentic.config.json(tracker github、browser agent-browser、门禁 make lint/make test/make build、QA 门禁开启)。
- 沟通用中文;代码注释与提交信息用英文;提交遵循 Conventional Commits。
- 用户可见改动建议带
needs-qa;纯文档/依赖/CI 改动用 skip-qa。