moesin-lab

pre-decision-analysis

当用户提出需要人类拍板但必须先做结构化分析的问题（评估、对比、讨论、值不值得、该不该、拆不拆、要不要起 ADR）时触发。本文件是该 skill 在 Claude Code 下的执行器；通用入口在 `../../SKILL.md`，规则权威源在 skill 顶层 `process/` 与 `standards/`（symlink 到 docs/dev/）。关键词：决策分析、多方案对比、argue subagent、codex review、PR diff review、AskUserQuestion、scratch 协作。

self-refinement

当用户显式说"沉淀 / 反思 / refine / 复盘 / 记下来 / reflect / /reflect"时触发；被纠正后 agent 可隐式自检是否值得沉淀。本文件是 harness-neutral 通用入口；规则权威源在 skill 本目录下 `process/README.md`（symlink 到 docs/dev/）。关键词：经验沉淀、反馈闭环、rule promotion、分流矩阵、跨层判据、本地记忆。

dependency-change

当 agent-nexus 任务要求新增、升级、降级或移除外部依赖，修改或审计 workspace package 依赖关系、跨 package import / API 边界时触发；即使用户只说“装个库”“升级 SDK”“把这个包引进 daemon”或“检查跨包依赖是否违规”也应触发。不用于仅安装现有 lockfile、同 package 内普通 import 整理或未授权的顺手升级。

development-workflow

当用户要求在 agent-nexus 仓库实现功能、修复缺陷、修改代码或文档、调整配置或契约时触发。这是 development-workflow 在 Claude Code 下的薄入口，负责加载项目开发主路径并按节点进入需求澄清、文档判定、TDD、分支提交与 code review；不用于纯只读解释、状态查询或 code review。

documentation-workflow

当 agent-nexus 的改动需要判定是否新增或更新仓库文档，或用户要求起草、修改 ADR、spec、架构、流程、标准、测试或 docs/product 下的产品文档时触发。这是 documentation-workflow 的 Claude Code 薄入口；纯错别字、断链、仓库外公告文案或已确认不改变契约和可观察行为的内部实现不触发。

release-workflow

当用户要求 agent-nexus 发版、发布 npm 包、创建或推送发布 tag、验证 release candidate / CLI tarball，或修改发布 workflow 与 package 发布元数据后执行发布验证时触发。不用于普通 build/test、PR ready/merge、仅写 GitHub Release 文案，或版本与渠道仍待决策的讨论。

ci-recovery

当 agent-nexus PR 的 GitHub Actions 或 GitHub 展示的 required check 已失败、取消或报红，用户要求在 Claude Code 中查看日志、定位根因或修复 CI 门禁时触发。Checks 仍 pending、只需整体 readiness 判断，或本地测试失败但没有 PR check 时不触发。

eval-workflow

当用户要求在 agent-nexus 中编写、修改或运行 agent 对话质量 eval，或评估 prompt、系统指令、skill name / description、工具集、Claude Code / 模型升级及普通测试无法覆盖的概率性行为回归时触发。本文件仅提供 Claude Code 的工具映射，不用于普通确定性测试。

issue-intake

当用户要求在 agent-nexus 仓库通过 Claude Code 起草、创建或更新 GitHub Issue，把 bug、观察、想法、设计讨论或 review 发现转成 issue，或把 can-defer 项加入长期跟踪时触发。仅讨论、诊断或实现但未要求落 issue，以及关闭、重开、删除等 issue 生命周期操作不触发。

pr-feedback

当用户要求在 Claude Code 中检查、分类、处理或回复 agent-nexus PR 的 review comments、unresolved threads、requested changes、inline comments 或 reviewer 反馈时触发。独立 code review、创建或更新 PR、整体 readiness 检查、明确的 CI failure，以及只汇总已 resolved 评论时不触发。

pr-readiness

当本仓库改动准备在 Claude Code 中创建或更新 PR、声明 ready、交付、合并，或检查 PR 描述、review 证据、反馈闭环与整体门禁时触发；即使用户只说“提 PR”“可以交了”“看看能不能合”也应触发。不负责实现阶段 TDD，也不替代处理具体 unresolved comments 或明确 CI failure 的专用 skill。

requirement-clarification

当 agent-nexus 需求涉及多用户或公开面、授权访问控制、跨 package 契约、新增对外 API、修改既有 API 签名或 spec 字段、持久化、状态开关、配置 schema、改名或兼容性边界时，在 ADR、spec、测试或实现之前触发。这是 requirement-clarification 在 Claude Code 下的薄入口；用于补齐遗漏维度，不用于已明确方案之间的选型。

skill-setup

当用户通过 Claude Code 要求在 agent-nexus 仓库新增、修改、删除或重命名协作性 skill，调整 skills.manifest，或维护任一 harness 的仓库 skill 执行器与挂接时触发。本文件提供 Claude Code 的工具映射；个人或全局 skill 不走仓库流程。

subagent-usage

当用户明确要求派发多个、若干或并行 subagent，或任务涉及跨文件探索、长日志/长输出分析、独立可验证子任务、独立 review / 第二意见、批量同质操作或研究类问题时触发。本文件是 subagent-usage 在 Claude Code 下的薄执行器，仅提供 Agent 能力映射。

tdd-workflow

当本仓库任务将新增功能、修复 bug、修改契约或改变可观察行为，并准备在 Claude Code 中编写或修改实现与测试时触发；即使用户只说“实现”“修一下”或“补代码”也应触发。仅做 TDD owner 路由，不用于纯探索、只读 review、无行为变化的文案修改或 PR readiness 门禁检查。