uppet
diff --git a/‎src/skills/conversation-state.js‎
Lines changed: 130 additions & 0 deletions b/‎src/skills/conversation-state.js‎
Lines changed: 130 additions & 0 deletions
diff --git a/‎src/skills/index.js‎
Lines changed: 10 additions & 0 deletions b/‎src/skills/index.js‎
Lines changed: 10 additions & 0 deletions
diff --git a/‎src/skills/parser.js‎
Lines changed: 144 additions & 0 deletions b/‎src/skills/parser.js‎
Lines changed: 144 additions & 0 deletions
@@ -0,0 +1,130 @@
+/**
+ * Conversation State - 会话状态管理
+ *
+ * 管理已加载的技能并更新 System Prompt
+ */
+
+/**
+ * 会话状态类
+ */
+export class ConversationState {
+  constructor() {
+    // 已加载的技能（按加载顺序）
+    this.activeSkills = [];
+  }
+
+  /**
+   * 添加技能到会话
+   * @param {Object} skill - 技能对象
+   */
+  addSkill(skill) {
+    // 检查是否已加载
+    const exists = this.activeSkills.some(s => s.name === skill.name);
+    if (exists) {
+      console.log(`[Skills] Skill "${skill.name}" already loaded, skipping.`);
+      return false;
+    }
+
+    // 添加到列表
+    this.activeSkills.push(skill);
+    console.log(`[Skills] Loaded skill: ${skill.name}`);
+    return true;
+  }
+
+  /**
+   * 移除技能
+   * @param {string} name - 技能名称
+   */
+  removeSkill(name) {
+    const index = this.activeSkills.findIndex(s => s.name === name);
+    if (index === -1) {
+      return false;
+    }
+
+    this.activeSkills.splice(index, 1);
+    console.log(`[Skills] Removed skill: ${name}`);
+    return true;
+  }
+
+  /**
+   * 获取所有已加载的技能
+   * @returns {Array} 技能列表
+   */
+  getActiveSkills() {
+    return [...this.activeSkills];
+  }
+
+  /**
+   * 检查是否有已加载的技能
+   * @returns {boolean}
+   */
+  hasActiveSkills() {
+    return this.activeSkills.length > 0;
+  }
+
+  /**
+   * 检查特定技能是否已加载
+   * @param {string} name - 技能名称
+   * @returns {boolean}
+   */
+  hasSkill(name) {
+    return this.activeSkills.some(s => s.name === name);
+  }
+
+  /**
+   * 清除所有已加载的技能
+   */
+  clearSkills() {
+    this.activeSkills = [];
+    console.log('[Skills] Cleared all active skills');
+  }
+
+  /**
+   * 获取技能摘要（用于调试）
+   * @returns {Array} 技能名称列表
+   */
+  getSkillsSummary() {
+    return this.activeSkills.map(s => ({
+      name: s.name,
+      description: s.description.substring(0, 100) + '...',
+      path: s.path
+    }));
+  }
+}
+
+/**
+ * 构建包含技能的 System Prompt
+ * @param {string} basePrompt - 基础 System Prompt
+ * @param {Array} activeSkills - 已加载的技能列表
+ * @returns {string} 更新后的 System Prompt
+ */
+export function buildSystemPromptWithSkills(basePrompt, activeSkills) {
+  if (!activeSkills || activeSkills.length === 0) {
+    return basePrompt;
+  }
+
+  let prompt = basePrompt;
+
+  // 添加技能部分
+  prompt += '\n\n## 🎯 Loaded Skills\n\n';
+  prompt += 'The following skills are available for use in this conversation:\n\n';
+
+  for (const skill of activeSkills) {
+    prompt += `### ${skill.name}\n\n`;
+    prompt += `${skill.description}\n\n`;
+    prompt += `${skill.content}\n\n`;
+    prompt += '---\n\n';
+  }
+
+  prompt += 'You can use these skills to help the user. Please carefully read the skill documentation, understand their capabilities and usage, then assist the user with their tasks.\n';
+
+  return prompt;
+}
+
+/**
+ * 创建全局会话状态实例
+ * @returns {ConversationState} 会话状态实例
+ */
+export function createConversationState() {
+  return new ConversationState();
+}
@@ -0,0 +1,10 @@
+/**
+ * Skills Module - 技能系统入口
+ *
+ * 导出所有技能相关的类和函数
+ */
+
+export * from './parser.js';
+export * from './registry.js';
+export * from './conversation-state.js';
+export * from './tools.js';
@@ -0,0 +1,144 @@
+/**
+ * Skill Parser - 技能解析器
+ *
+ * 最小化解析原则：
+ * - 只解析必需字段：name 和 description
+ * - 保留完整 content 传递给 AI
+ * - 使用简单的 YAML front-matter 解析
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+
+/**
+ * 解析技能文件
+ * @param {string} skillPath - 技能文件路径
+ * @returns {Promise<Object>} 解析后的技能对象
+ */
+export async function parseSkill(skillPath) {
+  try {
+    // 读取文件内容
+    const content = await fs.readFile(skillPath, 'utf-8');
+
+    // 提取 YAML front-matter
+    const frontmatter = extractFrontmatter(content);
+
+    // 移除 front-matter，保留完整内容
+    const contentWithoutFrontmatter = removeFrontmatter(content);
+
+    // 验证必需字段
+    if (!frontmatter.name) {
+      throw new Error('Missing required field: name');
+    }
+    if (!frontmatter.description) {
+      throw new Error('Missing required field: description');
+    }
+
+    return {
+      // 只解析这两个字段
+      name: frontmatter.name,
+      description: frontmatter.description,
+
+      // 完整内容（AI 理解）
+      content: contentWithoutFrontmatter,
+
+      // 文件信息
+      path: skillPath,
+      directory: path.dirname(skillPath)
+    };
+  } catch (error) {
+    throw new Error(`Failed to parse skill file "${skillPath}": ${error.message}`);
+  }
+}
+
+/**
+ * 提取 YAML front-matter（--- ... ---）
+ * @param {string} content - 文件内容
+ * @returns {Object} 解析后的 front-matter 对象
+ */
+function extractFrontmatter(content) {
+  // 匹配 --- ... --- 格式
+  const match = content.match(/^---\r?\n([\s\S]+?)\r?\n---/);
+  if (!match) {
+    throw new Error('Invalid skill format: missing frontmatter');
+  }
+
+  try {
+    // 简单解析：只提取 name 和 description
+    const yaml = match[1];
+    const lines = yaml.split('\n');
+    const result = {};
+
+    for (const line of lines) {
+      // 跳过空行和注释
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith('#')) {
+        continue;
+      }
+
+      // 匹配 key: value 格式（支持带引号和不带引号）
+      const match = line.match(/^(\w+):\s*(.+)$/);
+      if (match) {
+        const [, key, value] = match;
+        // 移除引号（单引或双引）
+        result[key] = value
+          .replace(/^"|"$/g, '')
+          .replace(/^'|'$/g, '')
+          .trim();
+      }
+    }
+
+    return result;
+  } catch (error) {
+    throw new Error(`Failed to parse frontmatter: ${error.message}`);
+  }
+}
+
+/**
+ * 移除 front-matter
+ * @param {string} content - 文件内容
+ * @returns {string} 移除 front-matter 后的内容
+ */
+function removeFrontmatter(content) {
+  return content.replace(/^---\r?\n[\s\S]+?\r?\n---\r?\n?/, '');
+}
+
+/**
+ * 快速解析：只读取 front-matter（用于发现技能）
+ * @param {string} skillPath - 技能文件路径
+ * @returns {Promise<Object>} { name, description } 或 null
+ */
+export async function parseSkillFrontmatter(skillPath) {
+  try {
+    const content = await fs.readFile(skillPath, 'utf-8');
+    const frontmatter = extractFrontmatter(content);
+
+    // 验证必需字段
+    if (!frontmatter.name || !frontmatter.description) {
+      return null;
+    }
+
+    return {
+      name: frontmatter.name,
+      description: frontmatter.description,
+      path: skillPath
+    };
+  } catch (error) {
+    // 快速解析失败不抛出错误，返回 null
+    return null;
+  }
+}
+
+/**
+ * 验证技能文件格式
+ * @param {string} skillPath - 技能文件路径
+ * @returns {Promise<boolean>} 是否有效
+ */
+export async function validateSkillFile(skillPath) {
+  try {
+    const result = await parseSkillFrontmatter(skillPath);
+    return result !== null;
+  } catch {
+    return false;
+  }
+}