Files

2.1 KiB
Raw Permalink Blame History

W1 内容生产型工作区模板

来源:三端统一目录规范(README.md)2.1 节 适用:连续生产 PPT/文档/图表,管理多个项目,沉淀跨项目方法。完整采用 v2。

结构

<workspace>/
├── README.md                    # 工作区总览,必建
├── .workspace.yaml              # 类型和路径登记,新建必建
├── methods/                     # 跨项目复用的方法层
│   ├── skills/                  # skill 链接或说明
│   ├── scripts/                 # 参数化通用脚本
│   ├── docs/                    # 流程、规范、风格和方法说明
│   ├── templates/               # PPT、文档、表格模板
│   ├── assets/                  # 本工作区通用素材
│   ├── charts/                  # 通用图表定义
│   └── data/                    # 可复用的小型公共数据
├── projects/                    # 项目层
│   ├── <project-name>/          # 套用 W5/v1 项目模板
│   └── _archive/                # 已冻结项目,只读
├── deliverables/                # 最终交付层
│   ├── <project-name>/
│   │   ├── final/               # 正式交付版本
│   │   └── manifest.md          # 版本、日期、来源项目、校验信息
│   └── _archive/                # 过期交付物
└── logs/                        # 工作区级自动化日志,按需创建

命名

  • 固定层:英文小写(methods/projects/deliverables)
  • 项目根:中文或英文均可
  • 交付物:<项目>-<内容>-YYYYMMDD-vN.ext
  • methods/scripts/ 脚本:动词_对象.py,必须支持 --help,不得写死个人绝对路径

方法提取门槛(v2 纪律)

  • 脚本 >50 行 或 被 ≥2 项目引用 或 预计未来复用 → 提取到方法层
  • 提取流程:复制 → 参数化 → 重命名 → 补 --help → 验证 → 写文档 → 更新引用 → 原文件软删归档
  • 跨层移动执行 A/B/C 三档确认 + 备份 + 引用更新 + 验证