房地产市场调查报告撰写工作流

5 步精简流程 | 全局 14 条底线原则 | 6 章 56 条专项原则 适用：住宅/商业/办公/工业类型（含 REITs 专项）

---

环境自检（首次使用必执行）

使用本技能前，助手必须执行以下自检：

必要工具

| 工具 | 用途 | 检查方式 | |------|------|---------| | web_search | 联网搜索市场数据、政策、竞品信息 | 尝试搜索"深圳 2025 GDP" | | web_fetch | 抓取具体网页内容 | 尝试抓取任一新闻页面 | | write / edit | 保存报告 Part 文件 | 直接调用 | | exec (python3) | 运行 L1/L2 检查脚本 | python3 --version | | exec (node) | 生成 Word 文档 | node --version |

必要 Python 包

pip3 install python-docx  # Word 文档生成

自检脚本

# 运行此脚本确认环境就绪
python3 -c "import docx; print('python-docx OK')" && \
node -e "require('docx'); console.log('docx-js OK')" && \
echo "环境就绪，可以开始使用工作流"

自检失败处理

| 缺失项 | 处理方式 | |--------|---------| | web_search / web_fetch | 提醒用户：当前环境缺少搜索工具，报告中的市场数据将依赖用户提供或 AI 训练数据，无法实时验证 | | node / docx 包 | 提醒用户：npm install docx 以支持 Word 导出 | | python3 / python-docx | 提醒用户：pip3 install python-docx 以支持文档样式清理 |

---

流程总览

用户需求
    ↓
Step 0  项目定义 ─── 7维度一次性确认
    ↓
Step 1  框架设计 ─── 主框架→二/三级标题→内容要求
    ↓
Step 2  报告撰写 ─── 边写边搜，内嵌检查点，卡死自检
    ↓
Step 3  质量审核 ─── L1+L2自动化，L3抽检
    ↓
Step 4  排版导出 ─── Markdown→Word
    ↓
Step 5  项目收尾 ─── 交付、复盘、归档

详细工作流见 references/core_workflow.md。

---

写作原则体系

全局 14 条（底线）  ←  所有章节必须满足
        +
章节专项 56 条（增量） ←  各章追加
        │
冲突时：专项优先

全局原则速查

| 类别 | # | 核心 | |------|---|------| | 数据 | 1-4 | 来源标注、缺失处理（区间>定性>标记）、用户数据优先、近5年时效 | | 格式 | 5-8 | 单节300-800字、超1万字拆分、时序表格化、禁emoji | | 文风 | 9-14 | 三段式论证、禁反问句、叙事连贯、句式多样、段落式叙述、深度分析 |

详细见 references/writing_principles.md。

章节专项原则

| 章 | 文件 | 项数 | |----|------|------| | 一 宏观背景分析 | references/section_rules/01_宏观背景分析.md | 10 | | 二 中观市场分析 | references/section_rules/02_中观市场分析.md | 9 | | 三 微观市场分析 | references/section_rules/03_微观市场分析.md | 10 | | 四 竞品对比 | references/section_rules/04_竞品对比.md | 8 | | 五 SWOT 分析 | references/section_rules/05_SWOT分析.md | 10 | | 六 运营预测 | references/section_rules/06_运营预测.md | 10 |

⚠️ 撰写每章前必须用 read 工具显式读取对应章节专项原则文件。

---

快速启动

助手收到报告撰写需求后：

1. 读取完整工作流：references/core_workflow.md
2. 执行环境自检：运行上述自检脚本
3. 从 Step 0 开始：确认项目 7 维度（物业类型/体量/阶段/基准日期 + 应用场景/立场/读者）
4. 严格按 Step 顺序执行，不跳跃，每步结束等待确认

---

关键协议

• 执行护栏：references/protocol.md
• 生成前强制回顾：每章开始前回顾全部原则 + 读取对应 section_rules/ 文件
• 内嵌检查点：每章完成后自动对照 Step 1 框架验证标题和内容
• 卡死检测：同一操作≥3次无进展 → 强制中断 → 报告用户
• 增量保存：每三级标题后立即保存，禁止依赖对话历史

---

---

脚本

| 脚本 | 用途 | |------|------| | scripts/generate_report_docx.js | Markdown → Word 排版导出 | | scripts/l1_check.py | L1 基础层自动化检查 | | scripts/l2_check.py | L2 逻辑层检查 |