用途
Best-Practice Research 是一个有边界的最佳实践研究包装技能(workflow wrapper),用于当任务依赖当前外部最佳实践、版本相关指引、标准、官方建议或上游行为时,路由证据收集与综合。它本身不是新的研究权威,也不替代 researcher。
其目标是产出一个带引用、可复用的最佳实践答案或交接说明,将当前外部证据与仓库本地事实、依赖选择决策区分开来。对于规划前的调查,它是常规的首个研究包装:先收集官方/上游证据,再交给 $ralplan 或调用方作为规划输入。它不应被当作最终架构组件,也不应被当作由验证器把关的研究循环。
主要能力
- 分类问题:概念性最佳实践、实现指引、迁移/版本指引、标准/合规指引,或本地与外部混合指引。
- 在本地使用或约束影响答案时,用 explore 收集仓库本地事实。
- 在当前或版本相关实践影响正确性时,用 researcher 收集外部证据。
- 综合出简洁答案,包含来源质量、版本/日期上下文、注意事项,以及实现或规划交接。
- 遵循来源质量规则:优先官方文档、上游源码、发布说明、变更日志、标准和维护者指引;为主要主张附来源 URL;说明当前最佳实践主张的日期/版本上下文;将第三方摘要标为补充,且不得先于官方/上游来源使用;标记过时、冲突、无文档或版本不匹配的证据;不过度抓取,只收集能支撑决策的最小证据集。
使用方式
默认终端式、只读。它收集证据并产出带引用的建议与交接后即停止。在该技能下不得写或编辑文件、创建或修改提交、运行变更命令,或以其他方式修改仓库状态——即使问题有明确的实现含义。当需要实现时,应停止并交接,而不是继续:指明 $ralplan 用于规划,$ultragoal、$team 或 executor 用于执行,并且只有在用户明确切换到该工作流后才继续。
工作流:
- 分类问题。
- 必要时用 explore 收集仓库本地事实。
- 必要时用 researcher 收集外部证据。
- 综合出简洁答案,含来源质量、版本/日期上下文、注意事项和实现或规划交接。
- 当答案对调用方足够有据时停止;否则报告确切阻塞点或所需专家交接。
专家路由:先用 explore 获取棕地事实(当前代码用法、本地约束、版本、配置、集成点);用 researcher 获取官方/上游文档、发布说明、标准、迁移指南、有来源支撑的示例,以及已选定技术的当前最佳实践证据;仅在采用/升级/替换/比较决策时使用 dependency-expert;带着明确证据、不确定性和任何实现交接约束返回调用方。
输出契约包含:直接建议、所用证据(官方/上游来源 URL 及其确立内容;补充来源及其为何次要)、版本/日期上下文、仓库本地上下文、边界/非目标、交接(规划/执行/测试含义,并指明下一工作流)。
适用场景
- 用户询问最佳实践、推荐做法、当前指引、官方建议、标准或版本相关外部行为。
- $ralplan、$deep-interview、$team 或其他工作流在规划或执行正确之前需要当前外部证据。
- 任务涉及已选定的技术,需要权威使用指引、迁移说明、API 行为、生命周期规则或当前安全指引。
限制
- 不适用于:答案完全在仓库本地(应使用 explore 获取代码库事实);主要问题是是否采用、替换、升级或比较依赖(应使用 dependency-expert);用户只需针对已有据需求进行实现(直接执行,或在需要协调并行工作时使用 $team);任务可依据稳定的本地项目约定回答而无需当前外部查询。
- 该技能从不实现。交付建议和交接后即停止;不修改仓库文件或仓库状态。只有在用户明确切换到交接中指定的规划或实现工作流后才继续。
- 停止规则:当带来源支撑的建议可被调用方复用时停止;当任务变为依赖比较、广泛架构或实现时停止并向上路由;当剩余工作只会润色措辞而不会改变建议时,不要继续研究。
任务参数:{{ARGUMENTS}}