zengtianli ZDWP 目录结构与整理规范
目录架构
zdwp/
├── projects/ # 业务项目（10 个）
├── archives/ # 已完成项目
├── workspace/ # 收文暂存（inbox/drafts）
├── docs/ # 使用指南
├── scripts/ # 工具脚本
└── .claude/ # skills + agents + commands
共享资源已独立：~/Dev/Work/shared/resources/（GIS、参考资料、基础数据）
项目标准结构
projects/{project-name}/
├── _project.yaml # 项目元数据
├── _index.md # 数据目录卡片（供 auggie 索引）
├── docs/ # 文档
├── data/ # 数据
├── code/ # 代码/脚本（或 symlink 到 ~/Dev/）
├── deliverables/ # 交付成果
└── references/ # 参考资料
县市子项目：projects/{project-name}/{city}-{county}/
文件归属规则
| 文件特征 | 应放位置 |
|---|---|
| 全省/多县市共享 GIS | ~/Dev/Work/shared/resources/gis/ |
| 规范、政策、模板 | ~/Dev/Work/shared/resources/references/ |
| 脚本、工具、代码 | ~/Dev/ 下对应仓库 |
| 历史版本 | archives/ |
| 归属不明的新文件 | workspace/inbox/ |
项目关键词映射
| 关键词 | zdwp 项目 | 独立项目 |
|---|---|---|
| 再生水 | projects/reclaim/ |
— |
| 水库调度 | projects/dispatch/ |
— |
| 供水管网 | projects/supply-net/ |
— |
| 可用水量 | projects/avail-water/ |
— |
| 分质供水、千岛湖 | projects/qual-supply/ |
— |
| 纳污能力 | projects/poll-cap/ |
— |
| 农业水价 | projects/agri-price/ |
— |
| 用水权、水权 | projects/rights/ |
— |
| 漏损 | projects/leak/ |
— |
| 钱塘江监测 | projects/qiantang-monitoring/ |
— |
| 生态流量 | — | ~/Dev/Work/projects/eco-flow/ |
| 风险图、洪水 | — | ~/Dev/Work/projects/risk-map/ |
| 浙东、引水 | — | ~/Dev/Work/projects/zdys/ |
| 水源地 | — | ~/Dev/Work/projects/water-src/ |
| 岸线 | — | ~/Dev/Work/projects/shoreline/ |
| 建模竞赛 | — | ~/Dev/Work/projects/modeling/ |
按地区归类
景宁/缙云/青田... → lishui-xxx/ 婺城/金东/兰溪... → jinhua-xxx/ 温岭/仙居... → taizhou-xxx/
完整映射：references/region-mapping.yaml
按文件类型
| 类型 | 子目录 |
|---|---|
| .shp/.gdb/.geojson | data/ |
| .xlsx/.xls | data/ |
| .docx/.doc/.pdf | docs/ |
| .py/.sh/.js | 提示用户放 ~/Dev/ |
| .png/.jpg/.tif | references/ |
命名规范
文件：[日期]_[业务]_[内容]_[版本].[后缀]
示例：2024-03-04_风险图_成果报告_v1.docx
自动整理
当用户说"整理文件"时：
- 先试运行：
python3 .claude/skills/zdwp-structure/scripts/auto-organize.py --dry-run - 显示结果：展示将要移动的文件列表
- 确认后执行：
python3 .claude/skills/zdwp-structure/scripts/auto-organize.py
创建新项目
- 在
projects/下创建目录（英文短名） - 创建
_project.yaml（参考 references/template-meta.yaml） - 创建
_index.md（数据目录卡片） - 创建标准子目录（按需）