Version Management Skill

版本管理

执行方式： 版本管理完全由本 Skill + send_file 实现；前后端不维护 Git、不记版本流水。Agent 在云机项目目录执行 git 与文件操作。下文 git 均为完整可执行命令；后期封装为 tool 后替换指令段落，决策逻辑与流程顺序不变。

对用户沟通规则： 版本管理的技术细节（git 命令、meta.json 更新、版本号计算等）是内部执行过程，禁止在对话中向用户展示或提及。用户只需看到：生成结果 + send_file 吐出的版本卡片。如需告知版本信息，只说"已保存为 V{n}"，不解释底层操作。

---

⚠️ 路径硬规则（最高优先级，写任何文件之前先执行本节）

本 Skill 必须在写出第一个入口文件之前介入，而不是产出之后补救。 任何入口文件（.html / .jsx / .tsx / .vue）第一次写入磁盘时，目标路径就必须位于 我的项目/{项目名}/ 内。

基准路径

「我的项目」固定位于工作区根目录，与 send_file 的 file_path 写法 /我的项目/{项目名}/... 一一对应。执行任何 mkdir / cd / 写文件操作之前，必须先回到工作区根目录（或使用从根目录起算的完整路径）；禁止在未确认 pwd 的情况下使用相对路径 我的项目/...——这是「我的项目」文件夹长在错误位置的常见原因。

写文件前的固定顺序（不可调换）

# 1. 确定项目名（生成规则见 §1.2）
# 2. 回到工作区根目录，创建项目目录
cd {工作区根目录}
mkdir -p "我的项目/{项目名}/assets"
# 3. 进入项目目录，之后所有文件【直接】在此目录内创建
cd "我的项目/{项目名}"
# 4. 写入 index.html / prototype.html 等入口文件与代码文件
# 5. 再进入 §1 的 git / meta.json / send_file 流程

违例清单（以下任何一种都算流程错误，即使事后移动也算）

• 先把文件写到工作区根目录、~/Desktop、/tmp 或当前任意目录，再移动进项目目录
• 只在对话中贴代码块，不落盘
• 在项目目录之外执行写文件命令

写文件前自检（最后一道闸）

调用任何写文件命令之前，自问一句：「我即将写入的目标路径，是否位于 我的项目/{项目名}/ 之内？」 答案不是 → 停止，先执行上面的固定顺序建目录，再写文件。

---

0. 与 Design Skill 的衔接（必读）

本 Skill 与 Design Skill 并列协作（二者由同一个 Design Agent 同时承载）：Design Skill 负责设计产出，本 Skill 负责落盘与版本管理。本节描述二者在 HTML 交付场景下的协同过程。

触发不依赖 Design Skill。 本 Skill 按文件类型触发：只要产出或修改入口文件（.html / .jsx / .tsx / .vue）就必须走本 Skill，与该任务是否经过 Design Skill 路由无关——包括未走任何设计流程、直接裸改已有 HTML 文字/颜色的情况（此时跳过 quality-gate，直接 资源校验 → git → meta.json → send_file）。

触发顺序（与 Design Skill 协同时）

Design Skill 路由 → 场景 skill（portfolio / deck / prototype 等）
→ 【写文件前】按本 Skill 顶部「路径硬规则」先建 我的项目/{项目名}/
→ 产出 .html / .jsx / .tsx / .vue → 文件【直接写入】我的项目/{项目名}/（不是事后移动）
→ quality-gate.md 通过
→ 本 Skill（资源校验 → git → meta.json → send_file）

禁止经 Design Skill 的产出在 quality gate 未通过时 commit 或 send_file。 禁止 Design Skill 在未经本 Skill 完成的情况下，将 HTML 网页项目视为已交付（仅贴代码块、不落盘、不写 我的项目/ 均不算交付）。

Design Skill 负责 / 本 Skill 负责

维度	Design Skill	本 Skill
场景、风格、版式、文案语言	✅	—
quality-gate、Design Compliance 注释	✅	—
项目目录、assets 落盘、git 版本	—	✅
meta.json、send_file 版本卡片	—	✅
对用户表述	设计结果说明	仅「已保存为 V{n}」