name: research-proposal
description: 进入 Proposal 模式(命令入口 /proposal)- 在单一冻结 Idea 下创建分阶段 Proposal(plan + tasks),并准备执行。
version: 2.0.0
metadata:
phase: proposal
outputs:
- research/proposals/Pxx-/proposal.md
- research/proposals/Pxx-/experiment-plan.md
- research/proposals/Pxx-/tasks.md
- research/proposals/Pxx-/experiment-report.md
- research/proposals/Pxx-*/verify.md
- research/evidence-ledger.md
进入 Proposal 模式(本阶段首先是:创建/维护分阶段 proposal 工件)。
硬前置(默认严格)
- 必须存在:
research/idea.mdresearch/idea.meta.yamlresearch/evidence-ledger.md
- 必须先读取
research/idea.md中的 Proposal Handoff Capsule(若缺失,先回/discover补齐) - 若
research/idea.meta.yaml的state != frozen:- 默认:拒绝进入正式实验执行
- 只能给两个选项:
- 回
/discover补齐并 freeze - 用户明确选择 “继续在 draft 下做探索性实验”(必须在 report 里标注为 exploratory)
- 回
目标(本阶段你必须输出的工件)
对一个 proposal 目录(research/proposals/Pxx-<slug>/)生成/更新:
proposal.md(意图、范围、目标 IDs、成功/停止条件)experiment-plan.md(预注册 + E* 映射,禁止写结果)tasks.md(checkbox 严格格式,apply 追踪)
模板来源:
scholar/schemas/scholar-research/templates/proposal.mdscholar/schemas/scholar-research/templates/experiment-plan.mdscholar/schemas/scholar-research/templates/tasks.md
入口问诊(AskUserQuestion-first)
建议问:
- 选择 proposal:新建 / 继续 Pxx / 查看已有列表
- 本 proposal 的目标:验证哪个 H/F,支持哪个 C
- 本次只做 planning 还是要进入执行(执行建议用
/apply)
Proposal 编号规则(强制)
- 从
research/idea.meta.yaml读取proposal_counter - 新建 proposal 时:
- proposal_counter += 1
- 生成 P01/P02...
- proposal slug 用 kebab-case(简短)
对照规则(不可违反)
- proposal 的 Target IDs 必须来自
research/idea.md的 H/F/C。 - 禁止在 experiment-plan 里改 primary metric / tuning protocol(除非走 amendment)。
- proposal.md 必须显式引用 handoff capsule 的:
- locked metric/tuning
- baseline set
- top risks
- open blockers
输出策略(默认)
- 生成/更新 proposal 三件套后,建议用户运行:
/apply执行 tasks/verify做审计与下一步决策