初始化项目版本

.agents/skills/prototype-comments/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: prototype-comments
+description: 批注、微调、编辑原型时使用：读取本地原型批注并定位页面元素，修改文案、样式、布局或交互，完成后删除已处理批注任务。
+---
+
+# 原型批注处理
+
+当页面上存在原型批注，或 `/editor-todo` 要求处理当前项目的批注时使用本技能。
+
+术语边界：
+
+- 批注 / comment：Commentary 里的原型改稿意见，本技能只处理这类内容。
+- 标注 / annotation：AnnotationViewer 的原型说明层，例如 `annotation-source.json` 和 `@axhub/annotation`，不属于本技能处理范围。
+
+## 默认读取顺序
+
+1. 先定位目标原型目录：`src/prototypes/<prototype-id>/`。
+2. 读取本地文件：`src/prototypes/<prototype-id>/.spec/prototype-comments.json`。
+3. 若文件不存在，结合用户上下文和当前代码判断目标；不调用 CLI/API，也不依赖浏览器运行中的页面。
+
+## 本地文件结构
+
+批注记录固定在 `.spec/prototype-comments.json`，核心字段是 `comments/tasks/images`：
+
+- `comments`：批注和修改记录，包含 locator、comment、marker，以及 text/style/tweak 的修改前后。
+- `tasks`：按 `elementKey` 保存待处理任务信息。
+- `images`：只记录 metadata 和 `images[].assetPath`。图片文件位于 `.spec/prototype-comment-assets/`。
+
+读取图片时只使用本地 `images[].assetPath`，基于 `.spec/prototype-comment-assets/` 查找文件。不要把新的 base64 图片内容写回 JSON；需要新增图片素材时放入 assets 目录，并在 `images[].assetPath` 里引用。
+
+## 处理流程
+
+1. 读取 `.spec/prototype-comments.json`，按 `comments` 理解修改意图和定位信息。
+2. 如有批注图片，按 `images[].assetPath` 读取本地文件辅助理解。
+3. 修改 `src/prototypes/<prototype-id>/` 下的实现文件，保持改动范围聚焦。
+4. 完成一个批注任务后，只清理本地批注文档：删除对应批注记录和任务记录，不写任务进度字段。
+5. 按项目规则完成预览验证；无法验证时说明原因。
+
+## 删除规则
+
+- 用 `comments[].elementKey` 作为主键删除已完成批注。
+- 删除同 key 的 `tasks[elementKey]`。
+- 删除 `elementKey` 匹配且不再被其他剩余批注引用的 `images[]` 记录。
+- 对 `.spec/prototype-comment-assets/`，只删除与被移除 `images[].assetPath` 对应、且不再被 JSON 引用的文件。
+- 如果某条批注没有 `elementKey`，用 `locator`/`label` 辅助人工匹配；匹配不确定时保留，不误删。
+
+清理规则示例：完成 `elementKey=hero` 后，移除 `comments` 中的 `hero` 批注、移除 `tasks.hero`、移除只属于 `hero` 的 `images` 记录及 `hero-only.png`；如果 `shared.png` 仍被其他剩余批注引用，则保留该图片记录和本地文件。
+
+## 完成回复
+
+面向用户用自然语言说明：
+
+- 哪些批注对应的界面修改已完成。
+- 是否还有未处理或异常批注。
+- 做了哪些验证。
+
+不要把回复写成 CLI 日志；技术细节只在确实影响用户理解时简短说明。

.agents/skills/prototype-comments/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "原型批注"
+  short_description: "批注、微调或编辑原型时，定位元素并修改文案、样式、布局或交互"
+  default_prompt: "使用 $prototype-comments 读取并处理当前原型批注。"