kit初版，模型引入,agent优化

.cursor/skills/dev-changelog/SKILL.md

@@ -15,7 +15,7 @@ description: >-
 | 层级 | 文件 | 信息密度 | 条目数量 | 注入方式 |
 |------|------|---------|---------|---------|
 | L1 完整版 | `changelog-full.md` | 高（5-15 行/条） | 无上限，只追加 | 用户手动唤醒 |
-| L2 中期版 | `changelog-recent.md` | 中（3-5 行/条） | 滚动窗口 ~10 条 | 检测到关联时自动读取 |
+| L2 中期版 | `changelog-recent.md` | 中（3-5 行/条） | 滚动窗口 ~20 条 | 检测到关联时自动读取 |
 | L3 概要版 | `changelog-headlines.md` | 低（1 行/条） | 滚动窗口 ~50 条 | 每次会话自动注入 |
 
 所有数据文件存放在 `.cursor/changelog/` 目录下。
@@ -182,12 +182,12 @@ Agent 完成了一个涉及**代码或配置文件实质性改动**的任务后
 
 ## 滚动窗口维护
 
-### L2 窗口（~10 条）
+### L2 窗口（~20 条）
 
 ```
 写入新条目后，检查总条目数：
-- <= 10 条：不做处理
-- > 10 条：移除文件底部（最旧的）条目，直到恰好 10 条
+- <= 20 条：不做处理
+- > 20 条：移除文件底部（最旧的）条目，直到恰好 20 条
 ```
 
 ### L3 窗口（~50 条）
@@ -246,4 +246,4 @@ Agent 完成了一个涉及**代码或配置文件实质性改动**的任务后
 
 ### 已知必要检查
 
-（暂无）
+1. **大任务收尾遗漏风险** — 当单次任务涉及 5+ 个文件改动时，Agent 容易在输出总结回复后遗漏被动写入流程。应在生成最终回复前，先执行 `changelog-recall.mdc` 中的"任务完成 Checklist"，确认三层日志已写入后再输出回复。绝不能"先回复再补写"。

.cursor/skills/epee-orchestrator/SKILL.md

@@ -122,4 +122,4 @@ description: >-
 
 ### 已知必要检查
 
-（暂无）
+1. **收尾动作级联遗漏** — 当 Agent 遗漏了一个收尾动作（如 changelog 写入）后，后续的收尾动作（自迭代、Registry 同步）也会被一并遗漏，因为它们都在同一个"收尾阶段"。`changelog-recall.mdc` 中的 Checklist 化设计可以打断这种级联——每项独立检查，不依赖前一项的执行记忆。

.cursor/skills/epee-orchestrator/registry.md

@@ -39,4 +39,20 @@
 - **触发场景**: "开发日志"、"changelog"、"最近改了什么"、"回顾改动"、"查看开发记录"、代码改动后自动写入
 - **输出**: .cursor/changelog/ 下的 changelog-full.md、changelog-recent.md、changelog-headlines.md
 - **路径**: .cursor/skills/dev-changelog/SKILL.md
-- **备注**: 写入由 changelog-recall Rule 的被动写入提醒触发；L3 概要每次会话自动注入上下文
+- **备注**: 写入由 changelog-recall Rule 的"任务完成 Checklist"触发（原被动写入提醒已升级为强制 checklist）；L3 概要每次会话自动注入上下文；stop Hook 双保险兜底
+
+### pitfall-journal
+- **类型**: 基础设施
+- **能力**: 记录开发中踩过的坑（非显而易见的问题），在遇到同类问题时自动检索匹配已有经验
+- **触发场景**: debug 完成后、"踩坑"、"之前遇到过"、"坑"、进入 Debug mode、同类错误反复出现
+- **输出**: .cursor/pitfalls/pitfalls.md 条目
+- **路径**: .cursor/skills/pitfall-journal/SKILL.md
+- **备注**: 与 dev-changelog 互补——changelog 记事实，pitfall 记经验；由 pitfall-recall Rule 触发自动检索
+
+### project-launcher
+- **类型**: 项目级
+- **能力**: 一键在独立可见终端窗口中启动 Art Agent 前端和后端服务
+- **触发场景**: "启动项目"、"运行项目"、"跑起来"、"打开前端和后端"、"启动服务"、"start"、"launch"、"run dev"、"启动前端"、"启动后端"
+- **输出**: 两个独立的终端窗口（前端 Next.js + 后端 FastAPI）
+- **路径**: .cursor/skills/project-launcher/SKILL.md
+- **备注**: 项目专属 Skill；窗口必须可见，用户可直接查看日志和手动关闭

.cursor/skills/pitfall-journal/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: pitfall-journal
+description: >-
+  踩坑经验记录系统。在调试完成或发现非显而易见的坑后记录根因和解决方式，
+  后续遇到同类问题时自动检索匹配，避免重复踩坑。
+  当 debug 完成、问题反复出现、或用户提到"踩坑"、"之前遇到过"、"坑"时触发。
+---
+
+# Pitfall Journal
+
+记录开发过程中遇到的"坑"——那些不看代码逻辑觉得应该没问题、但实际运行时才暴露的问题。
+与 dev-changelog 互补：changelog 记"做了什么"，pitfall-journal 记"踩了什么坑、怎么爬出来的"。
+
+## 数据文件
+
+所有记录存放在 `.cursor/pitfalls/pitfalls.md`。
+
+## 条目格式
+
+```markdown
+### [PF-YYYYMMDD-HHMM] 一句话标题
+- **症状**: 用户/系统看到的错误表现
+- **根因**: 技术层面的真正原因
+- **解法**: 具体怎么修的
+- **防御**: 以后如何避免（可选，如果有通用性的话）
+- **关联**: 相关文件、模块、技术栈标签
+```
+
+## 操作 A：写入记录
+
+### 触发条件
+
+以下任一场景触发：
+
+1. **调试完成后** — 经历了 debug 过程并找到了非显而易见的根因
+2. **用户主动提及** — "记录一下这个坑"、"以后别再犯"
+3. **Agent 识别到经验价值** — 问题涉及框架/库的隐式行为、配置陷阱、环境差异等
+
+以下情况**不触发**：
+- 纯拼写错误、简单语法错误
+- 问题原因一目了然（如变量名打错）
+- 纯业务逻辑调整（不涉及"坑"的语义）
+
+### 流程
+
+```
+1. 生成条目 ID：PF-YYYYMMDD-HHMM
+2. 从调试过程中提取：症状、根因、解法
+3. 归纳防御措施（如果有通用性）
+4. 读取 pitfalls.md，在顶部追加新条目
+5. 在回复末尾附：[已记录到踩坑日志]
+```
+
+### 静默写入原则
+
+与 dev-changelog 一致——Agent 自己调试出来的问题，不需要用户确认就可以记录。
+
+## 操作 B：自动匹配检索
+
+### 触发条件
+
+当 Agent 在当前任务中遇到以下情况时，应主动检索 pitfalls.md：
+
+1. **进入 Debug mode** — 读取 pitfalls.md，扫描是否有与当前错误症状匹配的记录
+2. **同类错误再现** — 错误信息关键词与已有条目的"症状"匹配
+3. **涉及已知高危区域** — 当前操作涉及的模块/技术栈在已有条目的"关联"中出现
+
+### 匹配策略
+
+```
+1. 提取当前问题的关键信号：
+   - 错误信息关键词
+   - 涉及的文件/模块
+   - 涉及的技术栈/框架
+
+2. 在 pitfalls.md 中匹配：
+   - 硬匹配：错误信息关键词出现在条目的"症状"中
+   - 软匹配：涉及的模块/技术栈出现在条目的"关联"中
+
+3. 命中时，在分析中优先考虑已有经验：
+   > 注意：之前遇到过类似问题 [PF-xxx]：[一句话描述]。
+   > 上次的根因是 [xxx]，先排查这个方向。
+```
+
+## 操作 C：手动检索
+
+### 触发条件
+
+用户主动要求回顾踩坑记录。典型话语：
+- "之前那个坑是什么来着"
+- "看看踩坑日志"
+- "有遇到过类似的问题吗"
+
+### 流程
+
+```
+1. 读取 pitfalls.md
+2. 根据用户描述匹配相关条目
+3. 展示匹配结果
+```
+
+## 与其他系统的协作
+
+| 系统 | 关系 | 说明 |
+|------|------|------|
+| `dev-changelog` | 互补 | changelog 记改动事实，pitfall 记经验教训 |
+| `pitfall-recall` Rule | 下游消费者 | 进入 Debug mode 或遇到错误时自动触发检索 |
+| `epee-orchestrator` | 注册 | 在 registry.md 中注册本 Skill |
+
+## 自迭代日志
+
+本节记录使用本 Skill 过程中发现的必要检查项。
+
+### 已知必要检查
+
+（暂无）

.cursor/skills/project-launcher/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: project-launcher
+description: >-
+  Art Agent 项目一键启动。当用户说"启动项目"、"运行项目"、"打开前端和后端"等时触发，
+  自动在独立的可见终端窗口中启动前端（Next.js）和后端（FastAPI），方便用户随时查看和关闭。
+---
+
+# Project Launcher
+
+一键启动 Art Agent 的前端和后端服务，在**独立可见的终端窗口**中运行，
+用户可以随时查看日志或手动关闭。
+
+## 触发条件
+
+当用户表达以下意图时触发：
+- "启动项目"、"运行项目"、"跑起来"
+- "打开前端和后端"、"启动服务"
+- "start"、"launch"、"run dev"
+- "启动后端"、"启动前端"（可单独启动其中一个）
+
+## 项目路径
+
+| 组件 | 路径 | 启动命令 |
+|------|------|---------|
+| 后端 | `art-agent/backend` | `uvicorn app.main:app --reload --host 0.0.0.0 --port 8000` |
+| 前端 | `art-agent/frontend` | `npm run dev` |
+
+## 前置条件
+
+后端需要激活 Python 虚拟环境（`art-agent/backend/venv`）。
+前端需要 Node.js >= 18。
+
+## 环境 PATH 须知
+
+本机 Node.js 安装在 `C:\Program Files\nodejs\` 但**未加入系统 PATH**。
+新开的终端窗口默认找不到 `node` / `npm` 命令。
+
+**解决方式**：在启动前端的命令中，先将 Node.js 路径注入到当前会话的 `$env:PATH` 中。
+
+> 如果后续 Node.js 路径发生变化（如用户重新安装或使用 nvm），需要更新此处。
+
+## 核心操作：启动服务
+
+### 流程
+
+```
+1. 确定项目根目录（workspace 根目录下的 art-agent/）
+
+2. 确定操作系统和 Shell 类型（Windows / macOS / Linux）
+
+3. 启动后端（在独立可见终端窗口中）：
+   - Windows（PowerShell 或 CMD 均适用）：
+     使用 `Start-Process` 或 `start cmd` 打开新的终端窗口
+   - macOS/Linux：
+     使用对应的终端打开方式
+
+4. 启动前端（在另一个独立可见终端窗口中）：
+   - 同样在新的终端窗口中启动
+
+5. 确认两个服务正在运行，告知用户访问地址
+```
+
+### Windows 启动命令
+
+**关键要求**：必须在**新的、可见的终端窗口**中启动，不能在 Cursor 内置终端后台运行。
+
+#### PowerShell 环境
+
+启动后端：
+```powershell
+Start-Process powershell -ArgumentList '-NoExit', '-Command', "cd 'BACKEND_PATH'; .\venv\Scripts\Activate.ps1; uvicorn app.main:app --reload --host 0.0.0.0 --port 8000" -WindowStyle Normal
+```
+
+启动前端（注意注入 Node.js PATH）：
+```powershell
+Start-Process powershell -ArgumentList '-NoExit', '-Command', "& { `$env:PATH = 'C:\Program Files\nodejs;' + `$env:PATH; `$Host.UI.RawUI.WindowTitle = 'Art Agent Frontend'; cd 'FRONTEND_PATH'; npm run dev }" -WindowStyle Normal
+```
+
+#### CMD 环境
+
+启动后端：
+```cmd
+start "Art Agent Backend" cmd /k "cd /d BACKEND_PATH && venv\Scripts\activate && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000"
+```
+
+启动前端（注意注入 Node.js PATH）：
+```cmd
+start "Art Agent Frontend" cmd /k "set PATH=C:\Program Files\nodejs;%PATH% && cd /d FRONTEND_PATH && npm run dev"
+```
+
+### macOS / Linux 启动命令
+
+根据用户终端环境选择：
+
+```bash
+# 后端
+osascript -e 'tell application "Terminal" to do script "cd BACKEND_PATH && source venv/bin/activate && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000"'
+
+# 前端
+osascript -e 'tell application "Terminal" to do script "cd FRONTEND_PATH && npm run dev"'
+```
+
+### 执行注意事项
+
+1. **路径拼接**：`BACKEND_PATH` 和 `FRONTEND_PATH` 必须替换为实际的绝对路径
+2. **venv 存在性检查**：启动后端前先确认 `art-agent/backend/venv` 目录存在，
+   不存在时提醒用户先创建虚拟环境
+3. **依赖检查**：如果 `node_modules` 不存在，先提醒用户执行 `npm install`
+4. **窗口标题**：尽量为窗口设置有意义的标题（如 "Art Agent Backend"、"Art Agent Frontend"），
+   方便用户在任务栏中识别
+5. **不使用 `block_until_ms: 0`**：不要用 Cursor 的后台命令方式，
+   那样窗口不可见，用户无法直接查看和关闭
+
+## 单独启动
+
+如果用户只说"启动前端"或"启动后端"，只启动对应的服务即可，不需要全部启动。
+
+## 访问信息
+
+启动完成后告知用户：
+- 后端 API：http://localhost:8000
+- 后端文档：http://localhost:8000/docs
+- 前端页面：http://localhost:3000
+
+## 自迭代日志
+
+本节记录使用本 Skill 过程中发现的必要检查项。
+
+### 已知必要检查
+
+1. **Node.js PATH 注入** — 本机 Node.js (`C:\Program Files\nodejs\`) 未加入系统 PATH，新开的终端窗口默认找不到 `npm`。启动前端时必须先将此路径注入到会话 PATH 中。