ai-helper-agent 1.4.0 → 1.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-helper-agent",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "AI Helper 代理服务 - 为 Chrome 扩展提供本地文件读写和系统命令执行能力",
   "type": "module",
   "main": "./src/server.js",

package/src/security.js

@@ -81,9 +81,24 @@ function checkPath(pathStr) {
       realPath = realpathSync(resolved);
     } catch (err) {
       if (err.code === 'ENOENT') {
-        // 文件不存在时，检查父目录
-        const parentDir = resolve(resolved, '..');
-        realPath = realpathSync(parentDir) + sep + normalized.split(sep).pop();
+        // 文件/目录不存在时，向上查找直到找到存在的父目录
+        let existing = resolved;
+        while (existing !== sep && existing !== '' && existing !== '/') {
+          const parent = resolve(existing, '..');
+          try {
+            realPath = realpathSync(parent) + sep + normalized.slice(resolve(parent).length).replace(/^[/\\]/, '');
+            break;
+          } catch (parentErr) {
+            if (parentErr.code === 'ENOENT') {
+              existing = parent;
+              continue;
+            }
+            return { allowed: false, reason: `无法解析路径: ${parentErr.message}` };
+          }
+        }
+        if (!realPath) {
+          return { allowed: false, reason: `路径检查异常: ${err.message}` };
+        }
       } else {
         return { allowed: false, reason: `无法解析路径: ${err.message}` };
       }

package/src/server.js

@@ -1,10 +1,11 @@
 // agent/src/server.js - HTTP Router + WebSocket 服务器
 import http from 'http';
 import { WebSocketServer } from 'ws';
-import { readFileSync, writeFileSync, readdirSync, statSync, unlinkSync, rmdirSync, existsSync, chmodSync } from 'fs';
+import { readFileSync, writeFileSync, readdirSync, statSync, unlinkSync, rmdirSync, existsSync, chmodSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
+import { spawn } from 'child_process';
 import os from 'os';
 import { loadConfig } from './config.js';
 import { verifyToken, getCurrentPairCode, startPairCodeRotation, stopPairCodeRotation, handlePairRequest } from './auth.js';
@@ -303,6 +304,8 @@ export function startServer() {
         const rawContent = 'content' in body ? String(body.content) : '';
         const buf = Buffer.from(rawContent, 'utf-8');
         if (buf.length > maxSize) return jsonResponse(res, 400, { success: false, error: `内容过大 (${buf.length} > ${maxSize})` });
+        // 确保父目录存在
+        mkdirSync(dirname(check.resolved), { recursive: true });
         writeFileSync(check.resolved, rawContent, 'utf-8');
 
         // 如果写入的是脚本文件，剥离执行权限防止直接运行
@@ -360,6 +363,44 @@ export function startServer() {
         return jsonResponse(res, 200, { success: true, path: check.resolved });
       }
 
+      // 在本地浏览器中打开文件
+      if (pathname === '/api/browser/open') {
+        const targetPath = body.path;
+        if (!targetPath || typeof targetPath !== 'string') {
+          return jsonResponse(res, 400, { success: false, error: '缺少 path 参数' });
+        }
+        const check = checkPath(targetPath);
+        if (!check.allowed) {
+          logSecurity('browser_open_blocked', { path: targetPath, reason: check.reason });
+          return jsonResponse(res, 403, { success: false, error: check.reason });
+        }
+        if (!existsSync(check.resolved)) {
+          return jsonResponse(res, 404, { success: false, error: '文件不存在' });
+        }
+
+        const fileUrl = `file://${check.resolved}`;
+        const platform = os.platform();
+        let cmd, args, spawnOpts;
+        if (platform === 'darwin') {
+          cmd = 'open';
+          args = [fileUrl];
+          spawnOpts = { detached: true, stdio: 'ignore' };
+        } else if (platform === 'win32') {
+          cmd = 'start';
+          args = ['""', `"${fileUrl}"`];
+          spawnOpts = { detached: true, stdio: 'ignore', shell: true, windowsHide: true };
+        } else {
+          cmd = 'xdg-open';
+          args = [fileUrl];
+          spawnOpts = { detached: true, stdio: 'ignore' };
+        }
+
+        spawn(cmd, args, spawnOpts).unref();
+
+        logFs('browser_open', { path: check.resolved, platform });
+        return jsonResponse(res, 200, { success: true, path: check.resolved, platform });
+      }
+
       // === 命令执行 ===
 
       if (pathname === '/api/exec') {

package/src/skill/loader.js

@@ -5,6 +5,7 @@ import { readFileSync, readdirSync, existsSync, statSync, unlinkSync, mkdirSync,
 import { join, extname } from 'path';
 import { homedir } from 'os';
 import { loadAllMarkdownSkills, saveMarkdownSkill, deleteMarkdownSkillDir, importMarkdownSkillFromZip, importMarkdownSkillFromUrl } from './markdown-loader.js';
+import { SKILL_CREATOR_SEED_MD, SKILL_CREATOR_DIR } from './skill-creator-seed.js';
 
 const SKILLS_DIR = join(homedir(), '.ai-helper-agent', 'skills');
 
@@ -255,292 +256,52 @@ export function deleteSkillFile(name, type) {
 }
 
 /**
- * 获取代码内置技能列表
- * 这些技能不存储在文件系统中，而是硬编码在代码里。
- * 内置技能的特点：
- * - 随代码发布，无需用户手动导入
- * - 不可编辑、不可删除，但可以停用
- * - 最终用户通过 skill-creator 生成的技能仍存放在 SKILLS_DIR 中
- * @returns {Object[]}
+ * 种子 skill-creator 内置技能到文件系统
+ * 首次运行时将 skill-creator 的 SKILL.md 写入 ~/.ai-helper-agent/skills/skill-creator/
+ * 之后用户可在工具箱中编辑、优化此技能（如调整为 Windows cmd 兼容）
+ * @returns {boolean} 是否执行了种子写入
  */
-export function getBuiltinSkills() {
-  return [
-    {
-      type: 'agent',
-      name: 'skill-creator',
-      description: '创建新技能的元技能。当用户要求创建技能、沉淀技能、新增技能、或任何创建/添加技能的意图时，必须立即调用此技能。',
-      version: '1.0.0',
-      enabled: true,
-      builtin: true,
-      editable: false,
-      deletable: false,
-      resources: [],
-      dirPath: null,
-      skillMdPath: null,
-      _filePath: null,
-      prompt: `## When to Use
-
-**必须在以下情况立即调用此技能：**
-- 用户说"创建技能"、"沉淀技能"、"新增技能"、"添加技能"
-- 用户说"把这个模式保存为技能"、"把这个流程沉淀为技能"
-- 用户说"我想以后也能用这个流程"
-- 用户要求将某个操作规范化为可复用的技能
-- 用户说"更新技能"、"完善技能"、"改进技能"、"优化技能"、"增强技能"
-- 用户说"更新 XX 技能"（XX 是已有技能名称）
-- 用户在对话中完善了已有技能的操作流程后说"更新这个技能"
-- 用户发现已有技能的缺陷并提供了改进方案
-
-**不要做：**
-- 仅解释如何创建技能而不实际创建
-- 在未调用此技能的情况下手动指导创建
-- 推迟技能创建到后续步骤
-
-**重要安全约束**：\`~/.ai-helper-agent/\` 根目录是受限目录，AI 不能访问。唯一允许操作的是 \`~/.ai-helper-agent/skills/\` 子目录。禁止先探索父目录再找子目录。
-
-## 技能目录结构
-
-所有用户创建的技能存放在 \`~/.ai-helper-agent/skills/\` 目录下（SKILLS_DIR）：
-
-\`\`\`
-~/.ai-helper-agent/skills/<skill-name>/
-├── SKILL.md          # 技能定义文件（必需）
-└── _meta.json        # 元数据（可选）
-\`\`\`
-
-**禁止**：不要用 ls/readdir 探索 ~/.ai-helper-agent/ 或 ~/.ai-helper-agent/skills/。直接到目标目录操作。
-
-## SKILL.md 标准格式
-
-\`\`\`markdown
----
-name: <skill-name>
-description: "<简明描述，包含：(1) 技能做什么，(2) 何时触发调用。控制在200字符以内>"
-enabled: true
----
-
-# <技能标题>
-
-## When to Use This Skill
-
-- 触发条件1
-- 触发条件2
-
-## Core Capabilities
-
-- 能力1
-- 能力2
-
-## Usage
-
-### Step-by-Step
-
-1. 步骤1
-2. 步骤2
-
-## Examples
-
-[具体示例]
-
-## Source
-
-从对话中沉淀，创建日期：YYYY-MM-DD
-\`\`\`
-
-## 创建流程
-
-**重要安全约束**：\`~/.ai-helper-agent/\` 根目录是受限目录，AI 不能访问。唯一允许操作的是 \`~/.ai-helper-agent/skills/\` 子目录。禁止先探索父目录再找子目录。
-
-1. **确认意图**：与用户简短确认技能名称和核心用途
-   - 技能名称：小写字母 + 连字符（如 code-reviewer、api-error-handler）
-   - 一句话描述这个技能解决什么问题
-
-2. **生成 description**：description 是触发匹配的关键，必须包含：
-   - 技能做什么（功能描述）
-   - 什么时候触发调用（触发条件/场景关键词）
-   - 示例格式："Does X. Invoke when Y happens or user asks for Z."
-
-3. **收集内容**：基于当前对话上下文，提取核心内容：
-   - 触发条件（什么时候该用这个技能）
-   - 核心能力（这个技能提供什么）
-   - 操作步骤（具体怎么做）
-   - 示例（正例和反例）
-   - 注意事项（容易踩的坑）
-
-4. **直接创建文件**：一步到位，直接在 \`~/.ai-helper-agent/skills/<skill-name>/\` 下操作。
-   - **禁止**先 \`ls\` 查看 \`~/.ai-helper-agent/\` 或 \`~/.ai-helper-agent/skills/\` 目录（前者无权限，后者不必要）
-   - 直接 \`mkdir -p ~/.ai-helper-agent/skills/<skill-name>/\` 创建子目录
-   - 直接写入 \`~/.ai-helper-agent/skills/<skill-name>/SKILL.md\`
-   - 创建完成后，告知用户在工具箱页面点击「重新加载」使技能生效
-
-5. **告知用户**：创建完成后，告知用户技能已就绪，说明触发关键词
-
-## 更新流程（已有技能）
-
-当用户要求更新/完善已有技能时：
-1. 确认技能名称
-2. 直接读取 ~/.ai-helper-agent/skills/<skill-name>/SKILL.md
-3. 分析对话上下文，识别需要更新的部分（新增触发条件、修改步骤、添加示例等）
-4. 合并内容，保留核心结构，融入新内容
-5. 更新 frontmatter 中的 description（如有必要）
-6. 覆盖写入 SKILL.md
-7. 告知用户更新完成，建议重新加载
-
-## 技能质量标准
-
-创建技能前验证：
-
-- [ ] 解决方案经过验证且有效
-- [ ] 内容脱离原始对话上下文后依然清晰可理解
-- [ ] 触发条件明确，模型能准确识别
-- [ ] description 包含功能描述和触发场景两部分
-- [ ] 名称符合小写+连字符规范
-- [ ] 代码示例完整且可独立运行
-- [ ] 如有参考文档，在文中提供链接`,
-      fullPrompt: `# Skill Creator
-
-此技能用于在对话过程中即时创建和沉淀新技能。当用户在对话中发现有价值的操作模式、最佳实践或知识时，通过此技能将其固化为可复用的 SKILL.md 文件。
-
-## When to Use
-
-**必须在以下情况立即调用此技能：**
-- 用户说"创建技能"、"沉淀技能"、"新增技能"、"添加技能"
-- 用户说"把这个模式保存为技能"、"把这个流程沉淀为技能"
-- 用户说"我想以后也能用这个流程"
-- 用户要求将某个操作规范化为可复用的技能
-- 用户说"更新技能"、"完善技能"、"改进技能"、"优化技能"、"增强技能"
-- 用户说"更新 XX 技能"（XX 是已有技能名称）
-- 用户在对话中完善了已有技能的操作流程后说"更新这个技能"
-- 用户发现已有技能的缺陷并提供了改进方案
-
-**不要做：**
-- 仅解释如何创建技能而不实际创建
-- 在未调用此技能的情况下手动指导创建
-- 推迟技能创建到后续步骤
-
-**重要安全约束**：~/.ai-helper-agent/ 根目录是受限目录，AI 不能访问。唯一允许操作的是 ~/.ai-helper-agent/skills/ 子目录。禁止先探索父目录再找子目录。
-
-## 技能目录结构
-
-所有用户创建的技能存放在 ~/.ai-helper-agent/skills/ 目录下：
-
-\`\`\`
-~/.ai-helper-agent/skills/<skill-name>/
-├── SKILL.md
-└── _meta.json
-\`\`\`
-
-**禁止**：不要用 ls/readdir 探索 ~/.ai-helper-agent/ 或 ~/.ai-helper-agent/skills/。直接到目标目录操作。
+export function seedSkillCreator() {
+  const skillDir = join(SKILLS_DIR, SKILL_CREATOR_DIR);
+  const skillMdPath = join(skillDir, 'SKILL.md');
 
-## SKILL.md 标准格式
+  console.log(`[Skill Loader] seedSkillCreator: 检查路径 ${skillMdPath}`);
+  console.log(`[Skill Loader] seedSkillCreator: 文件存在? ${existsSync(skillMdPath)}`);
 
-\`\`\`markdown
----
-name: <skill-name>
-description: "<简明描述，包含：(1) 技能做什么，(2) 何时触发调用。控制在200字符以内>"
-enabled: true
----
-
-# <技能标题>
-
-## When to Use This Skill
-
-- 触发条件1
-- 触发条件2
-
-## Core Capabilities
-
-- 能力1
-- 能力2
-
-## Usage
-
-### Step-by-Step
-
-1. 步骤1
-2. 步骤2
-
-## Examples
-
-[具体示例]
-
-## Source
-
-从对话中沉淀，创建日期：YYYY-MM-DD
-\`\`\`
-
-## 创建流程
-
-1. **确认意图**：与用户简短确认技能名称和核心用途
-   - 技能名称：小写字母 + 连字符（如 code-reviewer、api-error-handler）
-   - 一句话描述这个技能解决什么问题
-
-2. **生成 description**：description 是触发匹配的关键，必须包含：
-   - 技能做什么（功能描述）
-   - 什么时候触发调用（触发条件/场景关键词）
-   - 示例格式："Does X. Invoke when Y happens or user asks for Z."
-
-3. **收集内容**：基于当前对话上下文，提取核心内容：
-   - 触发条件（什么时候该用这个技能）
-   - 核心能力（这个技能提供什么）
-   - 操作步骤（具体怎么做）
-   - 示例（正例和反例）
-   - 注意事项（容易踩的坑）
-
-4. **直接创建文件**：一步到位，直接在 ~/.ai-helper-agent/skills/<skill-name>/ 下操作。
-   - **禁止**先 ls 查看 ~/.ai-helper-agent/ 或 ~/.ai-helper-agent/skills/ 目录（前者无权限，后者不必要）
-   - 直接 mkdir -p ~/.ai-helper-agent/skills/<skill-name>/ 创建子目录
-   - 直接写入 ~/.ai-helper-agent/skills/<skill-name>/SKILL.md
-   - 创建完成后，告知用户在工具箱页面点击「重新加载」使技能生效
-
-5. **告知用户**：创建完成后，告知用户技能已就绪，说明触发关键词
-
-## 更新流程（已有技能）
-
-当用户要求更新/完善已有技能时：
-
-1. **确认技能名称**：与用户确认要更新的技能名称（如 "code-reviewer"）
-
-2. **读取现有内容**：直接读取 ~/.ai-helper-agent/skills/<skill-name>/SKILL.md 文件
-
-3. **分析更新需求**：结合当前对话上下文，识别需要更新的部分：
-   - 新增触发条件
-   - 修改操作步骤
-   - 添加新示例
-   - 修复错误或改进流程
-   - 更新 description 使其更准确
-
-4. **合并内容**：保留原技能的核心结构，将新内容融入适当位置：
-   - 将新的触发条件追加到 "When to Use This Skill" 部分
-   - 将改进的步骤更新到 "Usage" 部分
-   - 将新示例添加到 "Examples" 部分
-   - 如果流程有重大变化，重新组织整个技能结构
-
-5. **更新 description**：如果触发条件或核心能力有变化，更新 frontmatter 中的 description
-
-6. **直接写入文件**：覆盖写入 ~/.ai-helper-agent/skills/<skill-name>/SKILL.md
-
-7. **告知用户**：告知用户技能已更新，说明更新了哪些内容，并建议点击「重新加载」使更新生效
-
-## 更新注意事项
-
-- 保留原技能的名称（frontmatter 中的 name 字段不变）
-- 保留原技能的核心结构，只在必要时重构
-- 更新后技能的触发条件应比以前更完善，不应遗漏原有条件
-- 每次更新都应使技能质量提升，而不是倒退
-
-## 技能质量标准
-
-创建技能前验证：
+  if (existsSync(skillMdPath)) {
+    // 已存在，检查是否需要升级（版本号不同则覆盖）
+    try {
+      const content = readFileSync(skillMdPath, 'utf-8');
+      const versionMatch = content.match(/^version:\s*([\d.]+)/m);
+      const currentVersion = versionMatch ? versionMatch[1] : '0.0.0';
+      console.log(`[Skill Loader] seedSkillCreator: 已有文件版本=${currentVersion}, 目标版本=1.1.0`);
+      if (currentVersion === '1.1.0') {
+        console.log('[Skill Loader] seedSkillCreator: 版本匹配，跳过写入');
+        return false;
+      }
+    } catch { /* 读取失败则覆盖 */ }
+  }
 
-- [ ] 解决方案经过验证且有效
-- [ ] 内容脱离原始对话上下文后依然清晰可理解
-- [ ] 触发条件明确，模型能准确识别
-- [ ] description 包含功能描述和触发场景两部分
-- [ ] 名称符合小写+连字符规范
-- [ ] 代码示例完整且可独立运行
-- [ ] 如有参考文档，在文中提供链接`
+  try {
+    if (!existsSync(skillDir)) {
+      mkdirSync(skillDir, { recursive: true });
     }
-  ];
+    writeFileSync(skillMdPath, SKILL_CREATOR_SEED_MD, 'utf-8');
+    console.log('[Skill Loader] 已种子写入 skill-creator SKILL.md (v1.1.0)');
+    return true;
+  } catch (err) {
+    console.warn('[Skill Loader] 种子写入 skill-creator 失败:', err.message);
+    return false;
+  }
+}
+
+/**
+ * 获取代码内置技能列表（已废弃，改用 seedSkillCreator 写入磁盘）
+ * 保留此函数为空以兼容旧代码调用
+ * @returns {Object[]}
+ */
+export function getBuiltinSkills() {
+  return [];
 }
 
 export { SKILLS_DIR };

package/src/skill/registry.js

@@ -1,6 +1,6 @@
 // skill/registry.js - Skill 注册表
 // 管理所有已加载的 Skill（Workflow + Agent），提供查询和执行接口
-import { loadAllSkills, saveSkillFile, deleteSkillFile, getBuiltinSkills, deleteMarkdownSkillDir } from './loader.js';
+import { loadAllSkills, saveSkillFile, deleteSkillFile, getBuiltinSkills, seedSkillCreator, deleteMarkdownSkillDir } from './loader.js';
 import { executeSkill } from './executor.js';
 import { SKILLS_DIR } from './loader.js';
 import { readFileSync, writeFileSync, existsSync } from 'fs';
@@ -45,8 +45,13 @@ function saveBuiltinState(state) {
 export function initializeSkillRegistry() {
   skills.clear();
 
+  // 0. 种子写入 skill-creator 到文件系统（首次运行或版本升级时）
+  const seeded = seedSkillCreator();
+  console.log(`[Skill Registry] seedSkillCreator 返回: ${seeded}`);
+
   // 1. 加载文件系统中的技能
   const loaded = loadAllSkills();
+  console.log(`[Skill Registry] loadAllSkills 返回 ${loaded.length} 个技能: ${loaded.map(s => s.name).join(', ') || '(无)'}`);
 
   for (const skill of loaded) {
     skills.set(skill.name, skill);

package/src/skill/skill-creator-seed.js

@@ -0,0 +1,144 @@
+// skill/skill-creator-seed.js
+// skill-creator 技能的种子 SKILL.md 内容
+// 当 ~/.ai-helper-agent/skills/skill-creator/ 目录不存在时自动写入
+
+export const SKILL_CREATOR_DIR = 'skill-creator';
+
+export const SKILL_CREATOR_SEED_MD = `---
+name: skill-creator
+description: "创建新技能的元技能。当用户要求创建技能、沉淀技能、新增技能、或任何创建/添加技能的意图时，必须立即调用此技能。"
+enabled: true
+version: 1.1.0
+---
+
+# Skill Creator
+
+此技能用于在对话过程中即时创建和沉淀新技能。当用户在对话中发现有价值的操作模式、最佳实践或知识时，通过此技能将其固化为可复用的 SKILL.md 文件。
+
+## When to Use
+
+**必须在以下情况立即调用此技能：**
+- 用户说"创建技能"、"沉淀技能"、"新增技能"、"添加技能"
+- 用户说"把这个模式保存为技能"、"把这个流程沉淀为技能"
+- 用户说"我想以后也能用这个流程"
+- 用户要求将某个操作规范化为可复用的技能
+- 用户说"更新技能"、"完善技能"、"改进技能"、"优化技能"、"增强技能"
+- 用户说"更新 XX 技能"（XX 是已有技能名称）
+- 用户在对话中完善了已有技能的操作流程后说"更新这个技能"
+- 用户发现已有技能的缺陷并提供了改进方案
+
+**不要做：**
+- 仅解释如何创建技能而不实际创建
+- 在未调用此技能的情况下手动指导创建
+- 推迟技能创建到后续步骤
+
+**重要安全约束**：不探索或列举 ~/.ai-helper-agent/ 根目录的内容。唯一允许操作的是 ~/.ai-helper-agent/skills/ 子目录中的目标技能目录。
+
+## 技能目录结构
+
+所有用户创建的技能存放在 ~/.ai-helper-agent/skills/ 目录下：
+
+\`\`\`
+~/.ai-helper-agent/skills/<skill-name>/
+├── SKILL.md          # 技能定义文件（必需）
+└── _meta.json        # 元数据（可选）
+\`\`\`
+
+## SKILL.md 标准格式
+
+\`\`\`markdown
+---
+name: <skill-name>
+description: "<简明描述，包含：(1) 技能做什么，(2) 何时触发调用。控制在200字符以内>"
+enabled: true
+---
+
+# <技能标题>
+
+## When to Use This Skill
+
+- 触发条件1
+- 触发条件2
+
+## Core Capabilities
+
+- 能力1
+- 能力2
+
+## Usage
+
+### Step-by-Step
+
+1. 步骤1
+2. 步骤2
+
+## Examples
+
+[具体示例]
+
+## Source
+
+从对话中沉淀，创建日期：YYYY-MM-DD
+\`\`\`
+
+## 创建流程
+
+1. **确认意图**：与用户简短确认技能名称和核心用途
+   - 技能名称：小写字母 + 连字符（如 code-reviewer、api-error-handler）
+   - 一句话描述这个技能解决什么问题
+
+2. **生成 description**：description 是触发匹配的关键，必须包含：
+   - 技能做什么（功能描述）
+   - 什么时候触发调用（触发条件/场景关键词）
+   - 示例格式："Does X. Invoke when Y happens or user asks for Z."
+
+3. **收集内容**：基于当前对话上下文，提取核心内容：
+   - 触发条件（什么时候该用这个技能）
+   - 核心能力（这个技能提供什么）
+   - 操作步骤（具体怎么做）
+   - 示例（正例和反例）
+   - 注意事项（容易踩的坑）
+
+4. **创建技能目录**：
+   - 使用 \`agent_exec_command\` 创建技能子目录。
+   - **macOS/Linux**：\`mkdir -p ~/.ai-helper-agent/skills/<skill-name>\`
+   - **Windows (cmd)**：\`mkdir %USERPROFILE%\\.ai-helper-agent\\skills\\<skill-name>\`
+   - **Windows (PowerShell)**：\`New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\\.ai-helper-agent\\skills\\<skill-name>"\`
+   - 如果 \`mkdir\` 报错，尝试不带参数或使用 \`agent_write_file\` 工具在目标路径写入一个临时文件，让系统自动创建父目录。
+
+5. **写入 SKILL.md**：使用 \`agent_write_file\` 工具将内容写入：
+   - 路径：\`~/.ai-helper-agent/skills/<skill-name>/SKILL.md\`
+   - Windows 上路径中的 \`~\` 会自动解析为用户主目录
+
+6. **告知用户**：创建完成后，告知用户技能已就绪，说明触发关键词。建议用户在工具箱页面点击「重新加载」使技能生效。
+
+## 更新流程（已有技能）
+
+当用户要求更新/完善已有技能时：
+
+1. **确认技能名称**：与用户确认要更新的技能名称
+2. **读取现有内容**：使用 \`agent_read_file\` 读取目标 SKILL.md
+3. **分析更新需求**：结合当前对话上下文，识别需要更新的部分
+4. **合并内容**：保留原技能的核心结构，将新内容融入适当位置
+5. **覆盖写入**：使用 \`agent_write_file\` 覆盖写入 SKILL.md
+6. **告知用户**：告知更新内容，建议重新加载
+
+## 更新注意事项
+
+- 保留原技能的名称（frontmatter 中的 name 字段不变）
+- 保留原技能的核心结构，只在必要时重构
+- 更新后技能的触发条件应比以前更完善
+- 每次更新都应使技能质量提升
+
+## 技能质量标准
+
+创建技能前验证：
+
+- [ ] 解决方案经过验证且有效
+- [ ] 内容脱离原始对话上下文后依然清晰可理解
+- [ ] 触发条件明确，模型能准确识别
+- [ ] description 包含功能描述和触发场景两部分
+- [ ] 名称符合小写+连字符规范
+- [ ] 代码示例完整且可独立运行
+- [ ] 如有参考文档，在文中提供链接
+`;