用途:GSD Path 工作流中的研究阶段。它按项目意图(INTENT.md,或程序流程中的 CHARTER.md)拆解研究问题,为每个维度派发独立研究员,收集带来源引用的证据,但不在本阶段做综合结论。
主要能力:维护 .project/research/RESEARCH.md 调度清单,记录维度为「已派发」或「跳过(附原因)」;支持四个标准维度——domain(先例、领域规则、术语)、stack(两三种可行技术栈)、pitfalls(安全、扩展、可靠性、UX 失败模式)、similar(同类产品与可复用经验),输出对应 evidence-*.md;可加自定义维度,总数上限五个。程序范围下可加 domain-decomposition、capability-map 等维度。每个维度先派发至子容量上限,随后有空位再派发;纠正后的重新派发优先于排队维度。
使用方式:先运行 pipeline_state.py validate --repo <absolute root> [--project-dir .project/next] 校验前置条件,合法入口为 define/done 或 research/active|blocked,需先确认具备实时搜索或网页阅读能力。进入时用 pipeline_state.py transition 设 phase/status 为 research/active,不得直接编辑 STATE。完成后运行 python3 <absolute check_handoffs.py> research --repo <absolute repo root> 校验证据文件,再 transition 到 research/done。前瞻模式以 .project/next/ 为根评估所有状态与产物前置条件。
限制:每个维度派发前须有分配到的研究问题,否则跳过,不派研究员凑文件;每条 finding 需含 Claim、Source、Confidence、Why it matters,并回答该维度全部分配问题;缺失或无效应在同一逻辑任务名下重新派发一次,仍失败则置 blocked,不得带着部分研究推进;冲突来源只记录不在本阶段解决;不作证据综合。每条主张须有实际核查的来源并回扣项目意图。