aegiscode 3.1.7 → 3.1.10

package/src/skills/SkillRegistry.ts

@@ -0,0 +1,366 @@
+/**
+ * SkillRegistry - Skills 注册中心
+ * 
+ * 
+ * 
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { parseSkillFile, extractMetadataFields } from './SkillLoader.js';
+import type {
+  SkillMetadata,
+  SkillContent,
+  SkillSource,
+  SkillDiscoveryResult,
+} from './types.js';
+
+/**
+ * 
+ */
+const BUILTIN_SKILLS: Map<string, SkillContent> = new Map([
+  // skill-creator 内
+  ['skill-creator', {
+    metadata: {
+      name: 'skill-creator',
+      description: 'Create and manage custom skills. Use when you want to add new SKILL.md files.',
+      userInvocable: true,
+      disableModelInvocation: false,
+      source: 'builtin',
+      sourceDir: 'aegis',
+      path: '',
+      basePath: '',
+    },
+    instructions: `# Skill Creator 指南
+
+你是一个 Skill 创建助手。帮助用户创建新的 SKILL.md 文件。
+
+## SKILL.md 格式
+
+\`\`\`markdown
+---
+name: my-skill
+description: 简短描述这个 Skill 做什么，以及何时使用它。
+allowed-tools:
+  - Read
+  - Grep
+  - Bash(git:*)
+user-invocable: true
+---
+
+# Skill 标题
+
+详细的指令内容...
+\`\`\`
+
+## 必填字段
+
+- **name**: 1-64 字符，小写字母+数字+连字符
+- **description**: ≤1024 字符，描述功能和触发时机
+
+## 可选字段
+
+- **allowed-tools**: 限制可用工具
+- **user-invocable**: 允许 /name 调用
+- **disable-model-invocation**: 禁止 AI 自动调用
+- **argument-hint**: 参数提示，如 \`<file_path>\`
+
+## 存放位置
+
+- 项目级（Git 共享）: \`.aegis/skills/<name>/SKILL.md\`
+- 用户级（全局）: \`~/.aegis/skills/<name>/SKILL.md\`
+
+## 示例
+
+请告诉我你想创建什么类型的 Skill，我会帮你生成完整的 SKILL.md 文件。
+`,
+  }],
+]);
+
+/**
+ * Skills 注册中心（单例）
+ */
+export class SkillRegistry {
+  private static instance: SkillRegistry | null = null;
+  private skills: Map<string, SkillMetadata> = new Map();
+  private initialized = false;
+  private workspaceRoot: string = process.cwd();
+
+  private constructor() {}
+
+  /**
+   * 
+   */
+  static getInstance(): SkillRegistry {
+    if (!SkillRegistry.instance) {
+      SkillRegistry.instance = new SkillRegistry();
+    }
+    return SkillRegistry.instance;
+  }
+
+  /**
+   * 
+   */
+  static resetInstance(): void {
+    SkillRegistry.instance = null;
+  }
+
+  /**
+   * 
+   * 
+   * 
+   * 1. 内置 Skills
+   * 2. ~/.claude/skills
+   * 3. ~/.aegis/skills
+   * 4. .claude/skills
+   * 5. .aegis/skills（最高优先级）
+   */
+  async initialize(workspaceRoot?: string): Promise<SkillDiscoveryResult> {
+    if (workspaceRoot) {
+      this.workspaceRoot = workspaceRoot;
+    }
+
+    const result: SkillDiscoveryResult = {
+      count: 0,
+      bySource: { user: 0, project: 0, builtin: 0 },
+      errors: [],
+    };
+
+    // 1. 加载内置 Skills（优先级最
+    this.loadBuiltinSkills();
+    result.bySource.builtin = BUILTIN_SKILLS.size;
+
+    // 2. 按优先级扫描目录（后加载的覆盖先加载
+    const homeDir = os.homedir();
+
+    // 用户级 - claude 目
+    await this.scanDirectory(
+      path.join(homeDir, '.claude', 'skills'),
+      'user',
+      'claude',
+      result
+    );
+
+    // 用户级 - aegis 目
+    await this.scanDirectory(
+      path.join(homeDir, '.aegis', 'skills'),
+      'user',
+      'aegis',
+      result
+    );
+
+    // 项目级 - claude 目
+    await this.scanDirectory(
+      path.join(this.workspaceRoot, '.claude', 'skills'),
+      'project',
+      'claude',
+      result
+    );
+
+    // 项目级 - aegis 目录（最高优先
+    await this.scanDirectory(
+      path.join(this.workspaceRoot, '.aegis', 'skills'),
+      'project',
+      'aegis',
+      result
+    );
+
+    result.count = this.skills.size;
+    this.initialized = true;
+
+    return result;
+  }
+
+  /**
+   * 
+   */
+  private loadBuiltinSkills(): void {
+    for (const [name, content] of BUILTIN_SKILLS) {
+      this.skills.set(name, content.metadata);
+    }
+  }
+
+  /**
+   * 
+   */
+  private async scanDirectory(
+    dir: string,
+    source: SkillSource,
+    sourceDir: 'claude' | 'aegis',
+    result: SkillDiscoveryResult
+  ): Promise<void> {
+    if (!fs.existsSync(dir)) {
+      return;
+    }
+
+    let entries: fs.Dirent[];
+    try {
+      entries = await fs.promises.readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+
+      const skillDir = path.join(dir, entry.name);
+      const skillPath = path.join(skillDir, 'SKILL.md');
+
+      if (!fs.existsSync(skillPath)) continue;
+
+      try {
+        const metadata = await this.loadMetadata(skillPath, source, sourceDir);
+        this.skills.set(metadata.name, metadata);
+        
+        if (source === 'user') {
+          result.bySource.user++;
+        } else {
+          result.bySource.project++;
+        }
+      } catch (error) {
+        result.errors.push({
+          path: skillPath,
+          error: (error as Error).message,
+        });
+      }
+    }
+  }
+
+  /**
+   * 
+   */
+  private async loadMetadata(
+    skillPath: string,
+    source: SkillSource,
+    sourceDir: 'claude' | 'aegis'
+  ): Promise<SkillMetadata> {
+    const content = await fs.promises.readFile(skillPath, 'utf-8');
+    const { frontmatter } = parseSkillFile(content);
+    const fields = extractMetadataFields(frontmatter);
+
+    return {
+      name: frontmatter.name,
+      description: frontmatter.description,
+      ...fields,
+      source,
+      sourceDir,
+      path: skillPath,
+      basePath: path.dirname(skillPath),
+    };
+  }
+
+  /**
+   * 
+   */
+  async loadContent(name: string): Promise<SkillContent | null> {
+    const metadata = this.skills.get(name);
+    if (!metadata) {
+      return null;
+    }
+
+    // 内置 Skill 直接返
+    if (metadata.source === 'builtin') {
+      return BUILTIN_SKILLS.get(name) || null;
+    }
+
+    // 从文件加
+    try {
+      const content = await fs.promises.readFile(metadata.path, 'utf-8');
+      const { body } = parseSkillFile(content);
+
+      return {
+        metadata,
+        instructions: body,
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * 
+   */
+  getAllSkills(): SkillMetadata[] {
+    return Array.from(this.skills.values());
+  }
+
+  /**
+   * 
+   */
+  getModelInvocableSkills(): SkillMetadata[] {
+    return Array.from(this.skills.values())
+      .filter(skill => !skill.disableModelInvocation);
+  }
+
+  /**
+   * 
+   */
+  getUserInvocableSkills(): SkillMetadata[] {
+    return Array.from(this.skills.values())
+      .filter(skill => skill.userInvocable);
+  }
+
+  /**
+   * 
+   */
+  hasSkill(name: string): boolean {
+    return this.skills.has(name);
+  }
+
+  /**
+   * 
+   */
+  getSkill(name: string): SkillMetadata | undefined {
+    return this.skills.get(name);
+  }
+
+  /**
+   * 
+   */
+  getCount(): number {
+    return this.skills.size;
+  }
+
+  /**
+   * 
+   */
+  async refresh(): Promise<SkillDiscoveryResult> {
+    this.skills.clear();
+    this.initialized = false;
+    return this.initialize(this.workspaceRoot);
+  }
+
+  /**
+   * 
+   * 
+   * 
+   */
+  generateAvailableSkillsList(): string {
+    const skills = this.getModelInvocableSkills();
+    if (skills.length === 0) {
+      return '';
+    }
+
+    const lines = skills.map(skill => {
+      const hint = skill.argumentHint ? ` ${skill.argumentHint}` : '';
+      return `- ${skill.name}${hint}: ${skill.description}`;
+    });
+
+    return `<available_skills>
+${lines.join('\n')}
+</available_skills>`;
+  }
+
+  /**
+   * 
+   */
+  isInitialized(): boolean {
+    return this.initialized;
+  }
+}
+
+// 导出单例获取函
+export function getSkillRegistry(): SkillRegistry {
+  return SkillRegistry.getInstance();
+}

package/src/skills/index.ts

@@ -0,0 +1,48 @@
+/**
+ * Skills 模块
+ * 
+ * Skills 是一种核心扩展机制，允许通过 Markdown 文件（SKILL.md）定义专业能力。
+ * 
+ * 
+ * 
+ * 1. 发现阶段：系统提示仅包含 Skills 名称和描述
+ * 2. 激活阶段：AI 判断需要某个 Skill 时调用 Skill 工具
+ * 3. 加载阶段：按需加载完整 SKILL.md 内容
+ */
+
+export * from './types.js';
+export * from './SkillLoader.js';
+export { SkillRegistry, getSkillRegistry } from './SkillRegistry.js';
+
+// 便捷初始化函
+import { getSkillRegistry } from './SkillRegistry.js';
+
+/**
+ * 
+ * 
+ * @param workspaceRoot - 工作区根目录
+ * @returns 发现结果
+ */
+export async function initializeSkills(workspaceRoot?: string) {
+  const registry = getSkillRegistry();
+  return registry.initialize(workspaceRoot);
+}
+
+/**
+ * 
+ * 
+ * @param name - Skill 名称
+ * @returns Skill 内容，如果不存在返回 null
+ */
+export async function loadSkillContent(name: string) {
+  const registry = getSkillRegistry();
+  return registry.loadContent(name);
+}
+
+/**
+ * 
+ */
+export function generateSkillsPrompt(): string {
+  const registry = getSkillRegistry();
+  return registry.generateAvailableSkillsList();
+}

package/src/skills/types.ts

@@ -0,0 +1,146 @@
+/**
+ * Skills 系统类型定义
+ * 
+ * Skills 是一种核心扩展机制，允许通过 SKILL.md 定义专业能力和最佳实践。
+ * 
+ */
+
+/**
+ * Skill 来源
+ */
+export type SkillSource = 'user' | 'project' | 'builtin';
+
+/**
+ * Skill 元数据（启动时加载，占用少量 Token）
+ * 
+ * 
+ */
+export interface SkillMetadata {
+  /** 唯一标识，小写+数字+连字符，≤64字符 */
+  name: string;
+  
+  /** 激活描述，≤1024字符，包含"什么"和"何时使用" */
+  description: string;
+  
+  /** 工具访问限制，如 ['Read', 'Grep', 'Bash(git:*)'] */
+  allowedTools?: string[];
+  
+  /** 参数提示，如 '<file_path>' */
+  argumentHint?: string;
+  
+  /** 是否支持 /skill-name 调用（默认 false） */
+  userInvocable: boolean;
+  
+  /** 是否禁止 AI 自动调用（默认 false） */
+  disableModelInvocation: boolean;
+  
+  /** 指定执行模型 */
+  model?: string;
+  
+  /** 额外触发条件，补充 description */
+  whenToUse?: string;
+  
+  /** 版本号 */
+  version?: string;
+  
+  /** 来源 */
+  source: SkillSource;
+  
+  /** 来源目录类型 */
+  sourceDir: 'claude' | 'aegis';
+  
+  /** SKILL.md 文件路径 */
+  path: string;
+  
+  /** Skill 目录路径 */
+  basePath: string;
+}
+
+/**
+ * Skill 完整内容（按需加载）
+ * 
+ * 
+ */
+export interface SkillContent {
+  metadata: SkillMetadata;
+  /** Markdown 正文（指令内容） */
+  instructions: string;
+}
+
+/**
+ * SKILL.md Frontmatter 配置
+ */
+export interface SkillFrontmatter {
+  /** 必填：Skill 名称 */
+  name: string;
+  
+  /** 必填：描述（AI 用于判断何时调用） */
+  description: string;
+  
+  /** 可选：允许的工具列表 */
+  'allowed-tools'?: string[];
+  
+  /** 可选：是否允许用户通过 /name 调用 */
+  'user-invocable'?: boolean;
+  
+  /** 可选：是否禁止 AI 自动调用 */
+  'disable-model-invocation'?: boolean;
+  
+  /** 可选：参数提示 */
+  'argument-hint'?: string;
+  
+  /** 可选：指定模型 */
+  model?: string;
+  
+  /** 可选：额外触发条件 */
+  when_to_use?: string;
+  
+  /** 可选：版本号 */
+  version?: string;
+}
+
+/**
+ * 
+ */
+export interface ParsedSkillFile {
+  frontmatter: SkillFrontmatter;
+  body: string;
+}
+
+/**
+ * Skill 发现结果
+ */
+export interface SkillDiscoveryResult {
+  /** 加载的 Skills 数量 */
+  count: number;
+  /** 按来源分类的数量 */
+  bySource: {
+    user: number;
+    project: number;
+    builtin: number;
+  };
+  /** 错误列表 */
+  errors: Array<{
+    path: string;
+    error: string;
+  }>;
+}
+
+/**
+ * Skill 工具参数
+ */
+export interface SkillToolParams {
+  /** Skill 名称 */
+  skill: string;
+  /** 可选：传递给 Skill 的参数 */
+  args?: string;
+}
+
+/**
+ * Skill 工具结果
+ */
+export interface SkillToolResult {
+  success: boolean;
+  content?: string;
+  error?: string;
+}

package/src/slash-commands/billing.ts

@@ -0,0 +1,70 @@
+/**
+ * /billing — AEGIS Billing info
+ */
+import { exec } from 'child_process';
+
+function openUrl(url: string) {
+  const cmd = process.platform === 'darwin' ? `open "${url}"` :
+              process.platform === 'win32'  ? `start "${url}"` :
+              `xdg-open "${url}"`;
+  exec(cmd, () => {});
+}
+
+const PROVIDERS = [
+  {
+    id: 'claude',
+    name: 'Claude (Anthropic)',
+    description: 'Best quality — Claude Sonnet 4.5',
+    pricing: '$3/MTok input · $15/MTok output',
+    url: 'https://console.anthropic.com/settings/billing',
+    recommend: true,
+  },
+  {
+    id: 'deepseek',
+    name: 'DeepSeek',
+    description: 'Best value — fast & affordable',
+    pricing: '$0.14/MTok input · $0.28/MTok output',
+    url: 'https://platform.deepseek.com/usage',
+  },
+  {
+    id: 'groq',
+    name: 'Groq',
+    description: 'Free tier — 100k tokens/day',
+    pricing: 'Free · Dev tier available',
+    url: 'https://console.groq.com/settings/billing',
+  },
+];
+
+export async function runBilling(args: string): Promise<string> {
+  const arg = args.trim().toLowerCase();
+
+  // Direct open
+  const found = PROVIDERS.find(p => p.id === arg);
+  if (found) {
+    openUrl(found.url);
+    return `Opening ${found.name} billing...\n${found.url}`;
+  }
+
+  // Show info
+  const lines: string[] = [
+    '## ⬡ API Billing',
+    '',
+    '> AEGIS CLI uses auto-routing — cheapest provider selected per request.',
+    '> Pricing includes a margin on provider cost.',
+    '',
+  ];
+
+  for (const p of PROVIDERS) {
+    const rec = p.recommend ? ' ★ recommended' : '';
+    lines.push(`**${p.name}**${rec}`);
+    lines.push(`${p.description}`);
+    lines.push(`${p.pricing}`);
+    lines.push(`${p.url}`);
+    lines.push('');
+  }
+
+  lines.push('---');
+  lines.push('Run `/billing claude` · `/billing deepseek` · `/billing groq` to open billing page');
+
+  return lines.join('\n');
+}