---
name: brief-proposal
description: 编写简要方案（IT 规划方案/工作方案）。当用户输入"简要方案##"或"简要方案"时触发。提供结构化协作式方案编写流程：背景讨论→现状分析→问题及需求梳理→方案规划→预算概要。最终通过 Python 脚本基于模板 .docx 生成 Word 文档。适用于政府/国企 IT 项目方案、网络安全规划、信息化建设方案等场景。
---

# 简要方案编写

## 概述

本 Skill 提供一套结构化、分阶段协作的简要方案编写流程。用户提供方案背景和现状信息，AI 进行扩展补充和优先级梳理，经用户确认后，通过 Python 脚本基于用户提供的 Word 模板（.docx）生成最终文档。

支持**保存并退出**和**继续编写**功能，可在任意阶段暂停和恢复。

## 触发词

- **新建方案**：`简要方案##` 或 `简要方案`（无已保存方案时）
- **继续编写**：`继续方案编写`、`继续之前的方案`、`继续写方案`、`恢复方案`
- **保存并退出**：在方案编写过程中任意阶段说 `保存并退出`、`暂停`、`先保存`

## 核心原则

- **一次扩展，一次确认**：每阶段 AI 对用户提供的信息做一次扩展补充，提交草稿供用户一次性确认
- **仅关键点提问**：只在信息缺口影响方案完整性时才主动提问
- **优先级驱动**：问题和需求按"首要/主要/次要/其他"四档梳理排序
- **语言风格**：参照政府公文风格（严谨、客观、规范），融合 IT 行业术语，避免口语化表达
- **分期灵活**：不在初始化阶段询问是否分期；在规划阶段根据工作量、成本综合判断后建议分期
- **最终输出为 .docx**：基于用户模板用 Python 生成 Word 文档，而非飞书云文档

---

## 会话管理（保存 & 恢复）

### 保存并退出

用户在任意阶段说 `保存并退出`、`暂停`、`先保存` 等类似表述时：

1. AI 将当前全部进度保存为 JSON 状态文件，存储到 `proposals/<方案简称>.json`
2. 状态文件包含：方案标题、预算形式、当前阶段、各阶段已确认内容、时间戳
3. 保存成功后告知用户：可后续用「继续方案编写」恢复

### 继续编写

用户输入 `继续方案编写`、`继续之前的方案`、`继续写方案`、`恢复方案` 时：

1. AI 扫描 `proposals/` 目录下所有 .json 状态文件
2. 如果**只有 1 个**已保存方案：直接加载并恢复
3. 如果**有多个**已保存方案：列出所有方案（标题、进度、最后更新时间），请用户选择一个
4. 如果**没有**已保存方案：提示用户无已保存方案，询问是否新建
5. 加载后告知用户当前进度（已完成哪些阶段、当前处于哪个阶段），继续执行

### 状态文件格式

```json
{
  "title": "方案全称",
  "budget_type": "文字概要 | 详细表格",
  "current_phase": 2,
  "phases": {
    "0": { "confirmed": true, "title": "...", "budget_type": "..." },
    "1": { "confirmed": true, "content": "..." },
    "2": { "confirmed": false, "user_input": "用户提供的现状信息原文" }
  },
  "template_path": "用户提供的模板文件路径（可选）",
  "folder_token": "飞书云盘文件夹 token（可选）",
  "created_at": "ISO 8601",
  "updated_at": "ISO 8601"
}
```

### 同名方案覆盖

如果用户新建方案时，状态文件已存在同名（同标题）的方案：

1. 提示用户：已存在同名已保存方案
2. 选项：继续之前的方案 或 覆盖（覆盖后旧文件被替换）

---

## 工作流程

### 阶段 0：初始化

用户输入"简要方案##"后（且不是继续已保存方案时），向用户确认：

1. **方案标题**：询问方案名称
2. **预算形式**：文字概要还是详细表格？

⚠️ **不要在此阶段询问是否分期**——分期决策在阶段 3 根据工作量与成本综合判断。

确认后告知用户进入阶段 1。

### 阶段 1：项目背景

1. 请用户提供项目/工作的背景信息
2. AI 扩展补充（行业背景、政策依据、紧迫性等），撰写草稿
3. 提交用户一次确认
4. 确认后进入下一阶段

### 阶段 2：现状分析与问题需求

1. 请用户提供现状信息（拓扑图、设备清单、文字描述等，种类和数量不限）
2. AI 汇总后：
   - 先写**现状分析**章节（纯描述，2-3 段，不分小标题，不分析问题）
   - 再从现状中识别问题，按优先级分类（首要/主要/次要/其他）
   - 从问题导出需求，问题与需求一一对应
3. 提交"现状分析 + 问题及需求分析"草稿供用户一次确认

**优先级标注规范**：
- **首要需求**：与业务连续性、安全合规、核心系统稳定直接相关，不解决存在重大风险
- **主要需求**：影响效率或合规但优先级稍次于首要需求
- **次要需求**：存在隐患但短期内可暂缓
- **其他需求**：锦上添花，长期优化方向

同级需求并列时用"主要需求一""主要需求二""次要需求一""次要需求二"区分，必须写序号。

**格式要求**：
- 各需求标题统一为"标题 → 问题（≤3 句）→ 需求（以'需……'起头）"
- 标题需体现方案核心动作，如"首要需求：建设推广智能渗透，降低检测成本，提升覆盖率"

### 阶段 3：方案规划

1. AI 基于确认后的需求，按需求逐项规划方案
2. 每项方案包含：**工作目标 → 详细工作内容（含预计工期、验收标准融入正文）→ 预期收益**
3. 工期和验收标准**融入正文**，不单独列"验收标准"小节
4. **分期决策**：在本阶段根据总工作量、建设成本等综合判断是否需要分期
   - 一般原则：总投入超百万可建议分期，一期聚焦首要需求
5. 提交草稿供用户一次确认

**方案规划章节格式**：
```
（一）[方案项标题]

工作目标
[1 段话]

详细工作内容
1. [子项名称]（预计 X 个月）。[具体内容，验收标准融入]。

预期收益
- [收益 1]
- [收益 2]
```

### 阶段 4：预算概要

1. 按"优先建设 / 逐步推进 / 可选模块"三级分类
2. 每项包含：工作内容简述 + 预算金额（XX 万元）
3. 预算金额先用"XX 万元"占位，用户后续自行填写
4. 允许在括号中添加内部成本核算备注供报价参考
5. 提交确认

### 阶段 5：生成文档

1. 全部内容确认完毕后，AI 通过 Python 脚本基于用户模板 .docx 生成最终文档
2. 文档生成后上传至用户指定的飞书云盘文件夹
3. 告知用户文档链接，提示用户打开后右键目录区域选择"更新域"以刷新目录

### 阶段 6：人工检查修订

1. 用户将文档下载到本地，在 Word 中做最后的编辑修订工作
2. 包括但不限于：最终措辞调整、格式微调、页码检查、敏感信息脱敏
3. 修订完成后重新上传至飞书云盘

### 阶段 7：AI 复查

1. 用户告知修订后的文档文件名
2. AI 下载文档，进行全文病词、病句检查
3. ⚠️ **重要**：最终输出物不得包含高敏感性内容（如人名、内部成本核算细节、竞品名称等），AI 检查时需提示用户移除
4. AI 反馈检查结果，用户最终确认

#### Python 脚本生成规范

见 `references/template.md` 中的脚本编写说明。

## 文档操作规范

### 模板文档

- 模板文件为用户提供的 .docx 文件，**不可覆盖或修改原模板**
- 模板中的自动目录控件（SDT）**必须保留**，不可删除或替换
- 生成的新文档统一存储到用户指定的文件夹

### 生成文档时的关键注意事项

1. **不添加静态目录**：模板有 Word 自动目录（SDT），生成时不要额外插入静态目录文本
2. **分页符位置**：分页符放在章节标题**之前**的空白段落上，不要放在标题段落内部
3. **标题样式**：Heading 2 设为小三号（15pt），Heading 3 设为 14pt
4. **标题编号**：确保章节标题之间的空白段不使用 Heading 样式（用 Normal），否则会导致 Word 自动编号错误
5. **封面格式**：标题行居中、22pt、加粗、#1E386B；日期居中、16pt、加粗
6. **序号规范**：并列的多项内容必须写序号，如"主要需求一""主要需求二""次要需求一""次要需求二"

## 交互节奏规则

1. **合并提问**：同一阶段的多个问题合并为一条消息
2. **先补后问**：优先基于经验补充，确实无法判断的才提问
3. **草稿制**：每阶段提交草稿，用户一次性审核
4. **进度可见**：每完成一个阶段告知用户进度
5. **可回溯**：允许用户在任何阶段要求修改前一阶段内容
