---
name: project-proposal-report
description: This skill should be used when the user asks to draft, generate, or produce a Chinese project proposal / feasibility report (立项报告 / 项目立项书 / 可研报告) using a fixed 12-chapter + 3-appendix structure with Microsoft YaHei bold typography (Title 25pt / Heading 1 15pt / Heading 2 12.5pt / Body 10.5pt). Triggered by requests like "生成立项报告", "写一份立项书", "按XX样本起草立项报告", "输出可研报告". Produces a .docx with the exact format and outline of the reference sample 《城市社区智慧养老服务平台立项报告.docx》.
agent_created: true
---

# project-proposal-report（立项报告自动生成 Skill）

## Overview

按样本《城市社区智慧养老服务平台立项报告.docx》的格式与框架，自动生成中文立项报告 .docx。固定结构 12 章 + 3 附录；字体统一微软雅黑粗体；段落组织遵循"标题 → 引出段 → 项目列表"模式。

## When to Use This Skill

当用户提出以下意图时触发：
- "帮我写一份立项报告 / 立项书 / 可研报告"
- "按《城市社区智慧养老服务平台立项报告.docx》的格式生成一份关于XXX的报告"
- "生成立项报告骨架 / 结构"
- "用项目立项模板起草"

不要在以下场景触发：
- 用户只要 Word/PPT/Excel 的通用编辑 → 走 `tencent-docs-routing`
- 用户要做投标响应 / 合同审查 → 走 `bid-document-assistant` 或 `contract-review-docx-clean`

## Workflow

### Step 1：澄清输入范围

在动手前明确以下信息（若用户未提供，按合理假设给出，并在最终文件中标注"演示假设"）：

| 必填项 | 说明 |
|--------|------|
| 项目名称 | 封面 Title 文字 |
| 项目副标题 | 封面副标题（如"以社区为入口，连接家庭、服务机构与基层治理"） |
| 申报单位 / 负责人 | 封面署名 |
| 各章节具体内容 | 若用户未提供，走"骨架模式"只生成结构 |

如果用户说"按样本格式生成立项报告骨架"或"先出个结构"，直接进入 Step 2 的骨架模式。

### Step 2：选择生成模式

#### 模式 A：骨架模式（默认）

仅生成章节标题、目录、子节占位段落，用户后续手工填写内容。命令：

```bash
python .workbuddy/skills/project-proposal-report/scripts/generate_report.py \
  --output "立项报告_骨架.docx"
```

#### 模式 B：内容模式

用户提供完整内容 JSON 时使用。先与用户对齐内容来源（用户口述 / 既有材料 / AI 起草），然后按以下结构准备 JSON：

```json
{
  "title": "项目主标题",
  "subtitle": "封面副标题",
  "signature": "项目筹备组 / 申报单位",
  "reading_note": "阅读提示段落（可省略，自动用默认文本）",
  "chapters": {
    "1.1": {
      "intro": "本节引出主题段落（120-180 字）",
      "bullets": ["要点 1", "要点 2", "要点 3"]
    },
    "1.2": { "intro": "...", "bullets": [...] }
  },
  "tail_note": "结尾说明（可省略）"
}
```

未在 `chapters` 中出现的子节将自动用骨架占位。生成命令：

```bash
python .workbuddy/skills/project-proposal-report/scripts/generate_report.py \
  --content content.json \
  --output "立项报告_XXX项目.docx"
```

### Step 3：验证输出

执行以下视觉校验（与 `references/style-spec.md` 第六节清单对应）：

1. 打开生成的 docx，确认封面 Title 是 25pt 微软雅黑粗体
2. 确认一级标题 15pt、二级标题 12.5pt、正文 10.5pt，均为粗体
3. 确认 12 主章节 + 3 附录顺序与 `outline.md` 完全一致
4. 确认每个子节有「标题 → 引出段 → Bullet 列表」三段式结构

### Step 4：交付

用 `present_files` 工具展示生成的 docx，让用户预览或下载。

---

## Format Specification（摘要）

完整规范见 `references/style-spec.md`。关键点：

| 元素 | Word 样式 | 字号 | 字重 |
|------|----------|------|------|
| 封面主标题 | Title | 25pt | 粗体 |
| 一级标题 | Heading 1 | 15pt | 粗体 |
| 二级标题 | Heading 2 | 12.5pt | 粗体 |
| 正文 | Body Text | 10.5pt | 粗体 |
| 项目列表 | List Bullet | 10.5pt | 粗体 |
| 目录条目 | Normal | 10.5pt | 粗体 |

字体全局统一为 **微软雅黑**，中英文（eastAsia / ascii）均使用同一字体。

---

## Outline（12 章 + 3 附录）

完整大纲见 `references/outline.md`。核心结构：

```
封面 → 目录 → 阅读提示 →
  一 立项结论与项目概述
  二 行业环境与市场机会
  三 目标用户与核心场景
  四 产品与服务方案
  五 技术架构与数据治理
  六 商业模式与增长路径
  七 市场进入与运营体系
  八 组织配置与项目治理
  九 投资预算与财务测算
  十 实施计划与验收标准
  十一 风险、合规与退出机制
  十二 立项决策事项
附录 A 关键指标口径
附录 B 关键假设与待验证清单
附录 C 术语表
→ 结尾说明
```

每章 3-5 个子节（X.Y 编号），子节固定结构：标题 + 引出段（Body Text）+ 项目列表（List Bullet）。

---

## Writing Guidance

每节应回答的核心问题清单见 `references/writing-guide.md`。摘要原则：

1. **判断先于数据**：每节先陈述判断，再给依据
2. **演示口径标注**：市场规模/财务/转化率必须标注"演示"
3. **可审计优先**：每个机制都说明"谁、何时、如何验证"
4. **安全 > 规模 > 效率**：风险与合规放规模与效率之前
5. **避免空话**：用"做什么 / 谁来做 / 怎么验证"的具体句式

---

## Resources

### scripts/
- `generate_report.py`：主生成脚本。基于 `python-docx`，通过直接操作 OOXML（`w:rFonts` + `w:sz` + `w:b`）保证中文 eastAsia 字段字体正确。

### references/
- `outline.md`：12 章 + 3 附录的固定大纲（章节名、子节名、编号规则）
- `style-spec.md`：字体、字号、段落样式、生成技术约束、视觉校验清单
- `writing-guide.md`：每节必须回答的核心问题与写作总原则

### assets/
- `sample_outline.json`：机器可读的样本大纲（脚本读取此文件生成文档）

---

## Notes

- 报告内所有市场规模、财务数据、转化率默认为"演示假设值"，必须在 `reading_note` 中提示读者复核。
- 用户如需更改章节顺序、子节命名或样式规格，需要直接修改 `references/` 与 `assets/sample_outline.json` —— 不要在脚本中硬编码覆盖。
- 生成脚本仅依赖 `python-docx`（≥ 0.8.11），可通过 `pip install python-docx` 安装。