| name | workflow-intake |
| description | 接收新需求并默认创建新的 3.0 topic；仅在显式 append/migrate/upgrade 时追加、聚合或升级已有 topic。输出专项骨架 + index 更新。 Use when: 新需求入料、创建新 topic、2.x topic 升级、显式 append、显式 migrate、workflow-intake |
| description_zh | 接收新需求并默认创建新的 3.0 topic；仅在显式 append/migrate/upgrade 时追加、聚合或升级已有 topic。输出专项骨架 + index 更新。 |
| license | MIT |
| metadata | {"author":"ArnoFrost","version":"3.0.0"} |
| visibility | public |
| stability | stable |
| user_invocable | true |
| public_gate | {"reviewed":true,"reviewed_by":"ArnoFrost","reviewed_at":"2026-07-13","rationale":"Prism 3.0 topic 入料与显式路由的正式入口，默认新建且不静默聚合。","rollback":"将 catalog 与 SKILL 镜像恢复为 dev/experimental；topic 工件保持可读。","ssot_id":"workflow-intake"} |
职责边界
| 维度 | 说明 |
|---|
| 是什么 | 把混沌输入收成新的 3.0 topic；显式 append/migrate/upgrade 时才触碰已有 topic |
| 不是什么 | 不定正式 scope，不刷新真实 focus，不做 review，不替代 human decision |
| 读什么 | prism sniff 输出；Phase 1-2 必读 intake-routing-spec.md、intake-templates.md、vocabulary.md |
| 写什么 | references/intake.md + scope/focus/decision.index/review.index 占位骨架 + workspace index.md；README 仅 deprecated 兜底 |
| 结束建议 | → workflow-scope 收敛正式合同 |
专项入料与 Topic 创建 (Workflow Intake)
管线定位：intake → (scope) → review → archive
intake 路由语义遵循 intake-routing-spec.md；术语遵循 vocabulary.md，不在主入口复制定义。
1. 何时使用
| 场景 | 做法 |
|---|
| 新需求，需要收束成 topic | /workflow-intake（默认新建） |
| 明确要创建新 topic | /workflow-intake |
| 明确追加到已有 topic | /workflow-intake --append <topic> |
| 散落任务需要聚合 | /workflow-intake --mode migrate |
| 2.x topic 升级到 3.0 壳 | /workflow-intake --mode upgrade <topic_dir> |
| 已确定 topic 且只是继续执行 | 不需要 intake，直接进入对应 workflow |
2. References 加载策略
不要一次读取全部 references/；按当前阶段渐进加载。
| 阶段 | 必读 | 按需 |
|---|
| 路由 / 分类 | intake-routing-spec.md, intake-templates.md, vocabulary.md | topic-sniff-spec.md |
| 写骨架 / gate out | — | trace-artifacts-spec.md, askquestion-fallback.md |
| 异常 / 维护 | — | intake-fallback.md, obsidian-config.md |
3. Mode 判定
| mode | 输入 | 行为 |
|---|
new | 需求描述 / topic 关键词 | sniff → 默认创建 3.0 topic 骨架 |
append | --append <topic> | 追加 intake 来源，补 scope OQ，刷新 README 兜底 |
migrate | 扫描 topics | 聚类散落任务 → 用户确认 → 迁移 |
upgrade | 单个 topic_dir | 机械补 3.0 壳；不做判断性内容迁移 |
默认 mode = new。
相关 ≠ append；--append <topic> 是 mode=append 的唯一强入口，优先于裸 slash 默认。裸 /workflow-intake 调用永远新建 topic（即使在已有 topic 对话内）；自然语言 append/cohere 只有在无 slash、目标 topic 紧随且可审计时才可进入 append。
4. Happy Path
Phase 0 Sniff
prism sniff --kind intake <project_dir> --topic <描述关键词>
Phase 1 Intake
提取关键词 / 任务类型 / tag / topic-name 候选
Phase 2 Route
按 intake-routing-spec：默认 new topic；append 必须显式目标
Phase 3 Initialize
用 scaffold.py + workspace/templates 创建或补全骨架
Phase 4 Gate Out
输出 intake_gate_out，确认骨架文件齐全
5. Route 规则
| suggestion | 默认动作 |
|---|
new_topic | 展示全新 topic 候选、编号、名称，等待确认 |
cohesion | 不静默追加；把 matched topic 作为可选 append 候选，默认仍新建 |
ask_user | 展示新 topic 默认项 + append 候选，等待用户选择 |
null | 按 intake-fallback.md 降级到 new topic |
必须显式输出：
topic_affinity.suggestion: <value>
route_decision: <new_topic|append|ask_user|null>
user_confirmation: <confirmed|skipped_by_explicit_target|required>
phase3_target: <topic_dir 或 new topic>
6. Safety Gates
F2-low-confidence-route
低置信、cohesion 或 ask_user 路由时：
- 不得默认 append 到
matched_topic
- 不得把候选首项当作已确认目标
- 默认推荐项仍是新 topic
- append 必须来自显式目标或用户确认
只有同时满足「append 路由关键词」+「可审计目标紧随」时，才可跳过 AskQuestion；细则见 intake-routing-spec.md §4 与 askquestion-fallback.md §6.3。
F3-migrate-no-interactive
--mode migrate 是低频高风险路径：
PRISM_NO_INTERACTIVE=1 必须 fail- 模糊回复必须重问
- 明确确认前禁止移动 topic、写入
archive/、修改 workspace index
- 迁移确认细则见 askquestion-fallback.md
intake_gate_out
Phase 3 完成后必须输出：
intake_gate_out:
topic_dir: <topic 目录相对路径>
intake_md_lines: <int>
scope_md_present: true | false
focus_md_present: true | false
readme_md_present: true | false
review_index_present: true | false
intake_size_ok: true | false
字段表和校验规则见 trace-artifacts-spec.md §intake_gate_out。缺少该块 = intake 未完成。
7. Initialize 写盘口径
| 分支 | 写盘 |
|---|
| 新建 topic | 创建完整 3.0 骨架：references/intake.md、scope.md、focus.md、decision.index.md、review.index.md、README 兜底；更新 workspace index.md |
| append 到已有 topic | 只补 topic 根文件、追加 references/intake.md、补 scope 未决问题、刷新 README 兜底；不得创建额外子目录 |
| migrate | 用户确认后迁移任务、清旧引用、刷新 README 兜底 |
| upgrade | 只机械补壳：focus / references intake / README 控制台；不删 plan、不改 scope 合同 |
骨架和编号规则由 intake-templates.md 与 scaffold.py 维护。
8. Upgrade / Fallback
upgrade 底层入口：uv run python {skill_dir}/scripts/upgrade_topic.py <topic_dir> [--dry-run]- 2.x 兼容、
migration: pending、plan 回退读取口径见 focus-derive-spec.md
- archive topic 只读冻结，不升级
- 执行环境受限时见 intake-fallback.md
依赖声明
本 skill 依赖 prism skills/workflow/shared/（外部依赖，不复制进 bundle）：
| 依赖 | 来源 | 不可用时（bundle 缺 shared） |
|---|
references 软链：vocabulary、topic-sniff-spec、trace-artifacts-spec、obsidian-config、askquestion-fallback | ../../shared/、../../shared/references/ | 渐进加载缺失 → 按主入口内联口径降级 |
scripts/sniff_lib.py | ../../shared/sniff_lib.py | 脚本优雅降级：清晰报错 + exit 2 |
scripts/index_update.py（archive_layout） | ../../shared/scripts/archive_layout.py | 同上（已 try/except 包裹） |
- 可解析前提：在 prism monorepo relink 后软链有效。
- 安装前提 / 版本：需 prism SDK（仓库路径由本地
prism.local.yaml 配置解析，非硬编码；bin/relink 分发软链、prism CLI 装入 PATH）+ Python ≥3.11 + uv（脚本经 uv run 调用）；缺任一项时按上表「不可用时」列降级，不裸崩。
- 独立 bundle：越界 import 缺失时须附带 shared 只读依赖后再评估，不把依赖缺失误判为 skill 主路径缺陷。
few-shot 示例
对应 evals 三类（evals/cases.yaml），示范入口路由与 mode 边界：
- 正常触发（默认新建）：用户「有个新需求，建个专项」→ 默认新建 3.0 topic 骨架 + 更新 index，产物遵循 intake_gate_out 契约。
- 边界（显式 append/migrate/upgrade）：用户「把这个并进已有 topic / 升级这个 2.x topic」→ 仅在显式指令下追加/聚合/升级，非默认；升级 2.x 走
--mode upgrade。
- 错误（隐式改存量）：未给显式 append/migrate 却想改动已有 topic → 不擅自聚合，按新建处理或提示改用对应 mode，避免误伤存量合同。
失败回退 / 完工 checklist
