Actant

QA 测试工程师 SubAgent。模拟真实用户通过命令行与 Actant 交互，智能判断输出和产物是否合理，黑盒为主白盒为辅，发现问题自动创建 Issue。触发方式：用户提及 "/qa"、"QA run"、"QA test"、"运行测试场景" 等关键词时激活。

用于执行 `/qa-loop` 风格的 QA 循环验证编排技能。适合用户要求“qa-loop”、“循环回归直到通过”、“测试→报错→修复→再测”、“把某个 scope/issue 跑到 100% PASS”时使用。它负责在项目内编排完整的测试、报告、Issue 去重与创建、修复、全量回归和收敛控制；不适用于一次性的小型 QA 检查，也不适用于持续轮询监测（那应使用 `qa-monitor` / `qa-watch`）。

QA 持续监测 SubAgent。监听 git HEAD 变化，每有新 ship（commit）自动触发完整回归测试，无变化时进入可配置间隔的休眠轮询。触发方式：用户提及 "/qa-watch"、"QA 监测"、"continuous QA"、"watch ship" 等关键词时激活。

持续审查项目进度、代码质量与 Roadmap 合理性的只读 SubAgent。不直接修改任何源码或文档，仅通过创建 Issue 和添加 Comment 输出审查意见。触发方式：用户提及 "/review"、"审查项目"、"review progress" 等关键词时自动激活。

GitHub-first Issue 管理 SubAgent。Issue 编号和内容以 GitHub Issues 为准，本地 .trellis/issues/ 为 Obsidian 兼容缓存。触发方式：用户提及 "/issue"、"创建 issue"、"create issue"、"新建问题"、"提 bug" 等关键词时激活。

编辑范围冻结技能。用于把当前任务限制在指定路径、模块或责任边界内，越界时必须停下并报告。触发方式：用户提及 "freeze"、"只改这个模块"、"不要动别的文件"、"锁定范围" 等关键词时激活。

高风险会话护栏技能。用于约束危险操作、提醒 destructive command 风险、限制在无验证或无依据时继续推进。触发方式：用户提及 "guard"、"安全模式"、"高风险修改"、"谨慎处理"、"不要乱改" 等关键词时激活。

根因调查技能。处理失败、异常、回归或未知行为时，先收集证据、形成并验证假设，再给出根因、修复建议与回归验证。触发方式：用户提及 "investigate"、"调查问题"、"排查异常"、"分析回归"、"root cause" 等关键词时激活。

PR Gatekeeper SubAgent。自动化处理 Multi-Agent Pipeline 产出的 Draft PR：验证代码质量 → 本地合并 → 更新 Spec → Ship 交付。触发方式：用户提及 "/handle-pr"、"处理 PR"、"review pr"、"合并 PR" 等关键词时激活。

智能 Wiki 文档更新 SubAgent。在每次 stage / ship 后分析变更内容，自动同步 changelog、生成新 feature 文档页面、修复过时内容。触发方式：用户提及 "/wiki-update"、"更新 wiki"、"sync wiki"、"wiki refresh" 等关键词时激活。

用于启动或续跑 `.trellis/scripts/multi-agent/codex-loop.sh` 的执行技能。适合需要在独立 worktree 中让 Codex 按 implement/check 多轮循环推进任务，直到通过校验门。触发方式：用户提及 "codex-loop"、"Ralph Loop"、"loop 修复"、"继续 loop"、"多轮修到通过"、"在 worktree 里反复实现和检查" 等关键词时激活。

子分支交付技能。用于用户要求“ship sub”、“子分支提 PR 再由主分支合并”、“feature branch ship”、“先创建 PR 再 handle-pr 交付”等场景。流程是在当前非主分支执行 finish-work/ship 级检查，提交并推送子分支，创建或复用 PR，然后切回主分支按 pr-handler 流程完成 handle-pr 交付。

中转执行 `.cursor/commands` 里的 trellis 系列命令。用户输入 `/trellis-*`、短别名（如 `/ship` `/start` `/qa-fix`）或要求“执行 trellis 命令”时使用。职责是解析命令名、定位对应命令文件、把参数映射为 `{{input}}`，并按原命令规范执行。

PR 轮询守护 SubAgent。持续监控 GitHub 上的 Open PR，自动调用 pr-handler 逐一处理，连续 N 轮无新可处理 PR 后退出。触发方式：用户提及 "/watch-prs"、"轮询 PR"、"watch prs" 等关键词时激活。

Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping