feat(skills): 实现完整的技能管理系统

- 新增技能注册表，支持用户级、项目级和内置技能
- 添加技能创建工具 skill-creator
- 支持通过斜杠命令调用用户可调用的技能
- 扩展技能元数据以兼容 Claude Code 规范
- 改进技能管理界面显示详细信息
- 优化斜杠命令建议和补全逻辑

Author: huzijie.sea

.blade/settings.local.json

@@ -5,7 +5,26 @@
       "Bash(git status)",
       "Bash(git diff *)",
       "Bash(ls -l)",
-      "Write(**/*.md)"
+      "Write(**/*.md)",
+      "Bash(ls -la *)",
+      "Bash(bun install *)",
+      "Skill",
+      "Write(**/*.py)",
+      "Bash(python test_echovic_website.py)",
+      "Bash(pip install *)",
+      "Bash(playwright install *)",
+      "Bash(python test_echovic_comprehensive.py)",
+      "Bash(curl -s *)",
+      "Bash(curl -I *)",
+      "Edit(**/*.py)",
+      "Bash(python -c *)",
+      "Bash(python test_echovic_debug.py)",
+      "Bash(python test_echovic_fixed.py)",
+      "Bash(python test_echovic_wait.py)",
+      "Bash(python test_echovic_basic.py)",
+      "Bash(python test_echovic_individual.py)",
+      "Bash(python test_echovic_analysis.py)",
+      "Bash(python3 -c *)"
     ],
     "ask": [],
     "deny": []

.claude/settings.local.json

@@ -74,7 +74,8 @@
       "Bash(gtimeout 3 npm run start:*)",
       "WebFetch(domain:leehanchung.github.io)",
       "WebFetch(domain:simonwillison.net)",
-      "WebFetch(domain:scottspence.com)"
+      "WebFetch(domain:scottspence.com)",
+      "WebFetch(domain:docs.anthropic.com)"
     ],
     "deny": [],
     "ask": [],

src/skills/SkillLoader.ts

@@ -21,12 +21,23 @@ const MAX_DESCRIPTION_LENGTH = 1024;
 
 /**
  * 解析 SKILL.md 的 YAML 前置数据
+ * 完全对齐 Claude Code Skills 规范
  */
 interface RawFrontmatter {
   name?: string;
   description?: string;
   'allowed-tools'?: string | string[];
   version?: string;
+  /** 参数提示，如 '<file_path>' */
+  'argument-hint'?: string;
+  /** 是否支持 /skill-name 调用 */
+  'user-invocable'?: boolean | string;
+  /** 是否禁止 AI 自动调用 */
+  'disable-model-invocation'?: boolean | string;
+  /** 指定模型 */
+  model?: string;
+  /** 额外触发条件 */
+  when_to_use?: string;
 }
 
 /**
@@ -50,6 +61,20 @@ function parseAllowedTools(raw: string | string[] | undefined): string[] | undef
   return undefined;
 }
 
+/**
+ * 解析布尔值字段（支持 true/false 字符串）
+ */
+function parseBoolean(value: boolean | string | undefined): boolean | undefined {
+  if (value === undefined) return undefined;
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') {
+    const lower = value.toLowerCase().trim();
+    if (lower === 'true' || lower === 'yes' || lower === '1') return true;
+    if (lower === 'false' || lower === 'no' || lower === '0') return false;
+  }
+  return undefined;
+}
+
 /**
  * 验证 Skill 元数据
  */
@@ -79,13 +104,26 @@ function validateMetadata(
     };
   }
 
+  // 解析 model 字段
+  let model: string | undefined;
+  if (frontmatter.model) {
+    // 'inherit' 表示继承当前模型，其他值为具体模型名
+    model = frontmatter.model === 'inherit' ? 'inherit' : frontmatter.model;
+  }
+
   return {
     valid: true,
     metadata: {
       name: frontmatter.name,
       description: frontmatter.description.trim(),
       allowedTools: parseAllowedTools(frontmatter['allowed-tools']),
       version: frontmatter.version,
+      // 新增字段
+      argumentHint: frontmatter['argument-hint']?.trim(),
+      userInvocable: parseBoolean(frontmatter['user-invocable']),
+      disableModelInvocation: parseBoolean(frontmatter['disable-model-invocation']),
+      model,
+      whenToUse: frontmatter.when_to_use?.trim(),
     },
   };
 }
@@ -96,7 +134,7 @@ function validateMetadata(
 export function parseSkillContent(
   content: string,
   filePath: string,
-  source: 'user' | 'project'
+  source: 'user' | 'project' | 'builtin'
 ): SkillParseResult {
   // 匹配 YAML 前置数据
   const match = content.match(FRONTMATTER_REGEX);
@@ -150,7 +188,7 @@ export function parseSkillContent(
  */
 export async function loadSkillMetadata(
   filePath: string,
-  source: 'user' | 'project'
+  source: 'user' | 'project' | 'builtin'
 ): Promise<SkillParseResult> {
   try {
     const content = await fs.readFile(filePath, 'utf-8');

src/skills/SkillRegistry.ts

@@ -8,6 +8,7 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { homedir } from 'node:os';
+import { getSkillCreatorContent, skillCreatorMetadata } from './builtin/skill-creator.js';
 import { hasSkillFile, loadSkillContent, loadSkillMetadata } from './SkillLoader.js';
 import type {
   SkillContent,
@@ -22,6 +23,9 @@ import type {
 const DEFAULT_CONFIG: Required<SkillRegistryConfig> = {
   userSkillsDir: path.join(homedir(), '.blade', 'skills'),
   projectSkillsDir: '.blade/skills',
+  // Claude Code 兼容路径
+  claudeUserSkillsDir: path.join(homedir(), '.claude', 'skills'),
+  claudeProjectSkillsDir: '.claude/skills',
   cwd: process.cwd(),
 };
 
@@ -61,6 +65,13 @@ export class SkillRegistry {
 
   /**
    * 初始化注册表，扫描所有 skills 目录
+   *
+   * 优先级（后加载的覆盖先加载的）：
+   * 1. 内置 Skills（builtin）
+   * 2. Claude Code 用户级 Skills（~/.claude/skills/）
+   * 3. Blade 用户级 Skills（~/.blade/skills/）
+   * 4. Claude Code 项目级 Skills（.claude/skills/）
+   * 5. Blade 项目级 Skills（.blade/skills/）- 优先级最高
    */
   async initialize(): Promise<SkillDiscoveryResult> {
     if (this.initialized) {
@@ -73,12 +84,28 @@ export class SkillRegistry {
     const errors: SkillDiscoveryResult['errors'] = [];
     const discoveredSkills: SkillMetadata[] = [];
 
-    // 扫描用户级 skills（优先级 1）
+    // 1. 加载内置 Skills（优先级最低，可被覆盖）
+    this.loadBuiltinSkills();
+
+    // 2. 扫描 Claude Code 用户级 skills（~/.claude/skills/）
+    const claudeUserResult = await this.scanDirectory(this.config.claudeUserSkillsDir, 'user');
+    discoveredSkills.push(...claudeUserResult.skills);
+    errors.push(...claudeUserResult.errors);
+
+    // 3. 扫描 Blade 用户级 skills（~/.blade/skills/）
     const userResult = await this.scanDirectory(this.config.userSkillsDir, 'user');
     discoveredSkills.push(...userResult.skills);
     errors.push(...userResult.errors);
 
-    // 扫描项目级 skills（优先级 2，可覆盖用户级同名 skill）
+    // 4. 扫描 Claude Code 项目级 skills（.claude/skills/）
+    const claudeProjectDir = path.isAbsolute(this.config.claudeProjectSkillsDir)
+      ? this.config.claudeProjectSkillsDir
+      : path.join(this.config.cwd, this.config.claudeProjectSkillsDir);
+    const claudeProjectResult = await this.scanDirectory(claudeProjectDir, 'project');
+    discoveredSkills.push(...claudeProjectResult.skills);
+    errors.push(...claudeProjectResult.errors);
+
+    // 5. 扫描 Blade 项目级 skills（.blade/skills/）- 优先级最高
     const projectDir = path.isAbsolute(this.config.projectSkillsDir)
       ? this.config.projectSkillsDir
       : path.join(this.config.cwd, this.config.projectSkillsDir);
@@ -99,6 +126,14 @@ export class SkillRegistry {
     };
   }
 
+  /**
+   * 加载内置 Skills
+   */
+  private loadBuiltinSkills(): void {
+    // 注册 skill-creator
+    this.skills.set(skillCreatorMetadata.name, skillCreatorMetadata);
+  }
+
   /**
    * 扫描指定目录下的所有 skills
    */
@@ -177,24 +212,71 @@ export class SkillRegistry {
   async loadContent(name: string): Promise<SkillContent | null> {
     const metadata = this.skills.get(name);
     if (!metadata) return null;
+
+    // 内置 Skill 直接返回内容
+    if (metadata.source === 'builtin') {
+      return this.loadBuiltinContent(name);
+    }
+
+    // 文件系统 Skill 从文件加载
     return loadSkillContent(metadata);
   }
 
+  /**
+   * 加载内置 Skill 的完整内容
+   */
+  private loadBuiltinContent(name: string): SkillContent | null {
+    switch (name) {
+      case 'skill-creator':
+        return getSkillCreatorContent();
+      default:
+        return null;
+    }
+  }
+
+  /**
+   * 获取可被 AI 自动调用的 Skills（Model-invoked）
+   * 排除设置了 disable-model-invocation: true 的 Skills
+   */
+  getModelInvocableSkills(): SkillMetadata[] {
+    return Array.from(this.skills.values()).filter(
+      (skill) => !skill.disableModelInvocation
+    );
+  }
+
+  /**
+   * 获取可通过 /skill-name 命令调用的 Skills（User-invoked）
+   * 仅包含设置了 user-invocable: true 的 Skills
+   */
+  getUserInvocableSkills(): SkillMetadata[] {
+    return Array.from(this.skills.values()).filter(
+      (skill) => skill.userInvocable === true
+    );
+  }
+
   /**
    * 生成 <available_skills> 列表内容
-   * 格式：每个 skill 一行 `- name: description`
+   * 格式：每个 skill 一行 `- name [argument-hint]: description`
+   * 仅包含可被 AI 自动调用的 Skills
    */
   generateAvailableSkillsList(): string {
-    if (this.skills.size === 0) {
+    const modelInvocableSkills = this.getModelInvocableSkills();
+    if (modelInvocableSkills.length === 0) {
       return '';
     }
 
     const lines: string[] = [];
-    for (const skill of this.skills.values()) {
+    for (const skill of modelInvocableSkills) {
       // 截断过长的描述，保持列表简洁
       const desc =
         skill.description.length > 100 ? `${skill.description.substring(0, 97)}...` : skill.description;
-      lines.push(`- ${skill.name}: ${desc}`);
+
+      // 如果有 argument-hint，添加到名称后面
+      const nameWithHint = skill.argumentHint
+        ? `${skill.name} ${skill.argumentHint}`
+        : skill.name;
+
+      lines.push(`- ${nameWithHint}: ${desc}`);
     }
 
     return lines.join('\n');