用途
case-bootstrap 是新案例研究的第一入口,用于搭建案例文件夹骨架、整理入场信息并初始化状态文件,然后把流程交给下游技能。它既可由用户直接调用,也可由其他智能体调用。
触发与跳过条件
触发场景:从头开始撰写新的商业案例研究;用户说“我想写一个关于 X 的案例”或“新案例”;重新打开一个 internal/state.json 缺失或过期的已有案例。
跳过场景:案例文件夹已有当前入场信息且 internal/state.json 已填充(应直接使用 next_skill 指向的下游技能);用户只想修改已有案例的元数据而不重新搭建(手动处理);任务是对已初始化案例进行研究、起草或测试。
工作流程
- 开始时读取现有的 internal/state.json,若存在适用的阻塞项则记录一条 blocked 历史并停止。
- 入场信息采集:读取作者已提供的内容和已有 internal/intake.yaml,遵循 references/intake-questions.md,存储所有无歧义的值。存在阻塞性事实未定时,只询问该一个事实并结束本轮;真实选择题使用 harness 的提问工具,开放性问题(如公司或主角)使用普通文本。使用作者的语言提问,不罗列其他字段。没有阻塞项时在同一轮继续。teaching_tension 与 contrast_set 在作者已明确说明时存储,否则保持 null,并传递给研究阶段;二者不作为阻塞问题。
- 生成 slug:确定主题后派生 kebab-case 的 case-<slug>/,仅 ASCII、不带重音符号。
- 搭建骨架:在阻塞问题已回答或明确推迟后,创建 case-<slug>/internal/ 与 case-<slug>/research/sources/public/、research/sources/private/。不创建占位文档。
- 状态写入:按 references/state-schema.md 写入 internal/state.json,新案例设置 stage: "bootstrap"、work_target: null,并写入一条 bootstrap 历史记录;重跑时保留已有的成功 stage、work_target 和历史。从路由表选择 next_skill。未采集的 audience、location、journal 保持为 null。
- 路由:尚无清晰想法 → case-research;已有想法且有访谈/记录 → case-research;内容已写完准备发表 → case-peer-review(期刊未确定时先询问);已有草稿或案例需要改编/匿名化(包括首次试点前)→ case-disguise。
- 幂等性:对同一 slug 重跑不得重复创建文件,仅在需要时更新 state.json 与 intake.yaml,不改动案例成品文件。
- 报告并继续:搭建完成后打印案例文件夹路径与一行入场摘要,说明下一步即将开始,并在同一轮执行 next_skill。不得报告未创建的文件夹,也不得在仅报告后结束本轮。
- 披露:把本次运行的输入、输出、AI 贡献、人工贡献、检查项和待检查项追加到 internal/disclosure.md,不渲染该内部审计文件。
输入与输出
输入:作者已给出的入场事实;若为幂等重跑,则包含已有的 case-<slug>/。
输出:case-<slug>/internal/state.json(schema_version: 2、stage: "bootstrap"、work_target: null、一条历史记录);case-<slug>/internal/intake.yaml;case-<slug>/internal/disclosure.md;case-<slug>/research/sources/public/ 与 research/sources/private/。
参考文件
references/taxonomy.md(面向读者的术语与语言)、references/pipeline-flow.md(如何进入下一技能、何时停止、结束每轮的问题)、references/case-folder-convention.md(文件夹与 state.json 规范)、references/intake-questions.md(标准问题措辞与校验规则)、references/state-schema.md(state.json 完整模式)、references/reader-formats.md(Markdown、HTML、PDF 副本及主交付物)。
限制
不收集案例内容;不运行 case-research;不分析一手材料;不编辑 AGENTS.md、INDICE.md、governanca/decisoes-sobre-skills.md 等全局文件;不推送、合并或发布;不创建占位文档;不渲染 internal/(渲染由后续技能在写入 Markdown 时完成)。
常见错误
在非空 case-<slug>/ 上未检查现有状态即重跑(有覆盖风险);slug 含重音或大写字母;初始化后把 next_skill 设为 null 导致流程停滞;未写入 bootstrap 历史记录破坏审计链;把整个入场问卷当成编号列表一次问完;搭建完成后只报告不提问即结束本轮(应继续 next_skill,若确实停止则以 harness 提问工具附“继续”选项结束)。