# 项目进入与建档流程

## 1. 什么时候使用

当出现以下情况时，先执行本流程：

- 新 IP 授权项目开始。
- 用户说“分析新 IP”“做某个 IP 授权分析”。
- 用户说“继续之前那个 IP”。
- 用户给了旧链接、旧文件、旧项目名或旧阶段产物。
- 阶段二、三、四开始前需要确认上一阶段成果在哪里。

## 2. 目标

建立一条干净、可交接的项目主线：明确当前 IP、阶段、输入、状态和下一步动作，避免散落文件、重复做、覆盖确认版或把候选版当最终版。安装配置已在 `INSTALL.md` 层完成，本流程只读取已安装能力。

## 3. 安装前置假设

本流程默认 `INSTALL.md` 已完成。项目存储、案例库、参考素材库、联系二维码、图像 Skill、发布 Skill 和凭据 profile 已经由安装层映射为可读取的配置。

项目流程不重新列安装变量，也不重复询问整套配置。若运行时发现必需能力缺失，只询问缺失项，并提示回到安装配置补齐。

## 4. Step 1：判断任务入口

### SOP

1. 识别用户意图属于：新项目、继续项目、重做候选、阶段补做、最终交付或资料接收。
2. 判断当前阶段：阶段一、阶段二、阶段三、阶段四或最终交付。
3. 如果用户只是陆续发资料，且没有说“开始做 / 资料发完 / 可以处理”，只记录和整理，不进入正式制作。
4. 如果用户说“重做 / 推翻旧版 / 不要复刻”，旧版只作为资料基线，不作为版式模板。

### 输出

- `current_stage`
- `project_intent`
- `start_confirmed: true/false`
- `rerun_mode: none/candidate/rebuild`

### 禁忌

- 不在用户没说完时边听边改。
- 不把“分析新 IP”当成孤立文件；默认进入四阶段主线。
- 不把旧版确认版直接覆盖成新候选。

## 5. Step 2：恢复上下文和已有资产

### SOP

1. 优先读取当前项目上下文、manifest、阶段状态记录。
2. 如果配置了案例库或项目资料库，只读检索相关 IP 或同名项目。
3. 区分：可复用事实、可复用素材、旧版确认文件、候选文件、淘汰文件、过程记录。
4. 记录所有不确定项，标记 `needs_review`。

### 输出

- 已知项目名称、IP 名称、机构名称。
- 当前确认版文件或链接。
- 候选版 / 淘汰版 / 过程稿状态。
- 缺失输入清单。

### QA

- 是否找到了上一阶段确认产物。
- 是否把候选版和确认版区分清楚。
- 是否没有使用外部路径作为 SOP 内容。

## 6. Step 3：创建或更新项目结构

### SOP

具体存储由安装配置决定，但项目内部建议保持逻辑结构：

```text
project/
├── PROJECT_CONTEXT.md
├── research/
├── gallery_generation/
├── product_mockups/
├── presentation/
└── workflow_docs/
```

必备文件：

- `PROJECT_CONTEXT.md`
- 阶段状态 manifest
- 来源记录或 source index
- 每阶段 README / handoff note

### 输出

- 项目 ID 或逻辑 URI。
- 项目上下文文件。
- 当前阶段入口说明。

### 禁忌

- 不写死具体平台、机器路径或账号。
- 不把临时缓存、调试文件、完整 prompt、临时授权链接写进长期 manifest。

## 7. Step 4：确认阶段入口

### SOP

根据当前状态进入对应 workflow：

- 资料和 IP 价值不足：阶段一。
- 已有 IP 分析和视觉机会地图：阶段二。
- 已有 confirmed / selected 图库：阶段三。
- 已有阶段一结论、阶段二 final_selected 单张图库、阶段三 selected/final 产品图：阶段四。
- 要发送、导出、发布、打包：最终交付 QA。

### 输出

- 下一步 workflow。
- 需要加载的模块。
- 当前阶段最低输入门槛。

## 8. 项目进入 QA

- [ ] 用户是否明确可以开始。
- [ ] 当前阶段是否判断清楚。
- [ ] 是否已有上一阶段确认产物。
- [ ] 是否存在已保留、已淘汰或已否定版本。
- [ ] 是否已区分候选版和确认版。
- [ ] 安装前置是否已完成；如发现必需能力缺失，是否只询问缺失项而非重复整套配置。
- [ ] 是否没有把外部路径、内部资料库名称写入 SOP 或客户可见材料。