best-practice-research

最佳实践研究

当任务依赖当前外部最佳实践、版本相关指引、标准、官方建议或上游行为时，使用此技能。这是一个工作流包装器：它负责路由证据收集与综合；它不是新的研究权威，也不替代 researcher。

目的

产出有引用、可复用的最佳实践答案或交接，将当前外部证据与仓库本地事实及依赖选择决策区分开。对于规划前调研，这是常规的首个研究包装器：收集官方/上游证据，然后将其交给 $ralplan 或调用方作为规划输入。不要将 $best-practice-research 呈现为最终架构组件，也不要将其呈现为验证器门控的研究循环。

默认终止

此技能默认是终止型且只读的。它收集证据并产出一份带引用的建议及交接，然后停止。不要在此技能下写入或编辑文件、创建或修改提交、运行变更性命令，或以其他方式修改仓库状态——即使问题具有明确的实现含义。当实现确有必要时，应停止并交接，而不是继续：指定 $ralplan 进行规划，指定 $ultragoal、$team 或 executor 进行执行，并且只有在用户明确切换到该工作流后才继续。

在以下情况激活

• 用户询问最佳实践、推荐方法、当前指引、官方建议、标准或版本相关的外部行为。
• $ralplan、$deep-interview、$team 或其他工作流在规划或执行能够正确进行之前需要当前外部证据。
• 任务涉及已选定的技术，并需要权威的使用指引、迁移说明、API 行为、生命周期规则或当前安全指引。

在以下情况不要激活

• 答案完全属于仓库本地；使用 explore 获取代码库事实。
• 主要问题是是否采用、替换、升级或比较依赖；使用 dependency-expert。
• 用户只需要针对已有充分依据的需求进行实现；直接执行，或在需要协调并行工作时使用 $team。
• 任务可以从稳定的本地项目约定中得到答案，而无需当前外部查找。

专家路由

1. 首先使用 explore 获取棕地事实：当前代码用法、本地约束、版本、配置和集成点。
2. 使用 researcher 获取官方/上游文档、发布说明、标准、迁移指南、有来源支撑的示例，以及针对已选定技术的当前最佳实践证据。
3. 仅将 dependency-expert 用于采用/升级/替换/比较决策。
4. 带着明确的证据、不确定性以及任何实现交接约束返回给调用方。

来源质量规则

• 优先使用官方文档、上游源代码、发布说明、变更日志、标准和维护者指引。
• 为重要主张包含来源 URL。
• 为当前最佳实践主张说明日期/版本背景。
• 将第三方摘要标注为补充；不要在官方/上游来源之前使用它们。
• 标记过时、冲突、无文档或版本不匹配的证据。
• 不要过度获取：收集能够支持决策的最小证据集。

工作流

1. 对问题分类：概念性最佳实践、实现指引、迁移/版本指引、标准/合规指引，或本地 + 外部混合指引。
2. 当本地用法或约束影响答案时，使用 explore 收集仓库本地事实。
3. 当当前或版本相关实践影响正确性时，使用 researcher 收集外部证据。
4. 综合出简洁答案，包含来源质量、版本/日期背景、注意事项，以及实现或规划交接。
5. 当答案对调用方而言已有充分依据时停止；否则报告确切阻塞点或所需的专家交接。

输出契约

## Best-Practice Research: <question>

### Direct Recommendation
<actionable guidance or decision support>

### Evidence Used
- Official/upstream: <source URL> — <what it establishes>
- Supplemental, if any: <source URL> — <why it is secondary>

### Version / Date Context
<versions, dates, release channels, or unknowns>

### Repo-Local Context
<facts from explore, or "not needed">

### Boundaries / Non-goals
<what this research does not decide>

### Handoff
<planning/execution/test implications; name the next workflow — `$ralplan` for planning, `$ultragoal`/`$team`/`executor` for execution — and note that this skill stops here unless the user explicitly switches workflows>

停止规则

• 当基于来源的建议可被调用方复用时，停止。
• 如果任务变为依赖对比、宽泛架构或实现，停止并向上层转交。
• 当剩余工作只会润色措辞而不会改变建议时，不要继续研究。
• 此技能从不进行实现。在交付建议和交接后，停止；不要修改仓库文件或仓库状态。仅当用户明确切换到交接中指定的规划或实现工作流时，才继续。

任务：{{ARGUMENTS}}