tianxincode 1.0.0

package/dist/modules/session/session.types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Session 模块类型定义
+ */
+export interface Session {
+    id: string;
+    title: string;
+    projectPath: string | null;
+    summaryMessageId: number | null;
+    promptTokens: number;
+    completionTokens: number;
+    cost: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SessionState {
+    currentSessionId: string | null;
+    sessions: Session[];
+}
+export interface CompactionResult {
+    success: boolean;
+    summaryMessageId?: number;
+    tokensBefore: number;
+    tokensAfter: number;
+    error?: string;
+}
+export interface SessionStats {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    threshold: number;
+    percentUsed: number;
+    willCompact: boolean;
+}
+//# sourceMappingURL=session.types.d.ts.map

package/dist/modules/session/session.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.types.d.ts","sourceRoot":"","sources":["../../../src/modules/session/session.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/modules/session/session.types.js

@@ -0,0 +1,5 @@
+/**
+ * Session 模块类型定义
+ */
+export {};
+//# sourceMappingURL=session.types.js.map

package/dist/modules/session/session.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.types.js","sourceRoot":"","sources":["../../../src/modules/session/session.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/modules/skill/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Skill 模块
+ * 按照 skill-guide.md 规范实现
+ */
+export { SkillsManager, skillsManager } from './skills.manager.js';
+export { skillTool, skillHandler, buildAvailableSkillsPrompt } from './skill.tool.js';
+export type { Skill, SkillMetadata, SkillToolParams, SkillToolResult, SkillPermission, SkillsConfig, AvailableSkill, } from './skill.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/skill/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AACtF,YAAY,EACV,KAAK,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/modules/skill/index.js

@@ -0,0 +1,7 @@
+/**
+ * Skill 模块
+ * 按照 skill-guide.md 规范实现
+ */
+export { SkillsManager, skillsManager } from './skills.manager.js';
+export { skillTool, skillHandler, buildAvailableSkillsPrompt } from './skill.tool.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/skill/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/modules/skill/skill.service.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Skill 服务
+ *
+ * 职责：
+ * - Skill 加载和解析
+ * - Skill 管理
+ * - Skill 执行
+ */
+import { Skill } from './skill.types.js';
+export declare class SkillService {
+    private skills;
+    private skillsDir;
+    constructor(skillsDir?: string);
+    /**
+     * 获取默认 Skills 目录
+     */
+    private getDefaultSkillsDir;
+    /**
+     * 加载内置 Skills
+     */
+    private loadBuiltinSkills;
+    /**
+     * 获取内置 Skills
+     */
+    private getBuiltinSkills;
+    /**
+     * 从文件加载 Skill
+     */
+    loadSkillFromFile(filePath: string): Skill | null;
+    /**
+     * 从目录加载 Skills
+     */
+    loadSkillsFromDir(dirPath?: string): number;
+    /**
+     * 解析 Skill
+     */
+    private parseSkill;
+    /**
+     * 获取 Skill
+     */
+    get(name: string): Skill | undefined;
+    /**
+     * 获取所有 Skills
+     */
+    getAll(): Skill[];
+    /**
+     * 注册 Skill
+     */
+    register(skill: Skill): void;
+    /**
+     * 移除 Skill
+     */
+    remove(name: string): boolean;
+    /**
+     * 检查 Skill 是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 获取 Skill 的系统提示
+     */
+    getSystemPrompt(skillName: string): string | undefined;
+    /**
+     * 搜索 Skills
+     */
+    search(query: string): Skill[];
+    /**
+     * 将 Skill 导出为 YAML
+     */
+    exportToYaml(skillName: string): string | undefined;
+}
+export declare const skillService: SkillService;
+//# sourceMappingURL=skill.service.d.ts.map

package/dist/modules/skill/skill.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.service.d.ts","sourceRoot":"","sources":["../../../src/modules/skill/skill.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,KAAK,EAAgB,MAAM,kBAAkB,CAAC;AAEvD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,CAAC,EAAE,MAAM;IAK9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoHxB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAajD;;OAEG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAoB3C;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAatD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE;IAS9B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAwBpD;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/modules/skill/skill.service.js

@@ -0,0 +1,283 @@
+/**
+ * Skill 服务
+ *
+ * 职责：
+ * - Skill 加载和解析
+ * - Skill 管理
+ * - Skill 执行
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+export class SkillService {
+    constructor(skillsDir) {
+        this.skills = new Map();
+        this.skillsDir = skillsDir || this.getDefaultSkillsDir();
+        this.loadBuiltinSkills();
+    }
+    /**
+     * 获取默认 Skills 目录
+     */
+    getDefaultSkillsDir() {
+        const home = process.env.HOME || process.env.USERPROFILE || '.';
+        return path.join(home, '.txcode', 'skills');
+    }
+    /**
+     * 加载内置 Skills
+     */
+    loadBuiltinSkills() {
+        const builtinSkills = this.getBuiltinSkills();
+        for (const skill of builtinSkills) {
+            this.skills.set(skill.name, skill);
+        }
+    }
+    /**
+     * 获取内置 Skills
+     */
+    getBuiltinSkills() {
+        return [
+            {
+                name: 'code_review',
+                description: '代码审查：分析代码质量，找出问题和改进点',
+                instructions: `你是一个代码审查专家。请对提供的代码进行全面审查：
+
+1. **代码质量**：检查命名规范、代码风格、可读性
+2. **潜在问题**：查找 bug、安全漏洞、性能问题
+3. **最佳实践**：检查是否遵循最佳实践
+4. **改进建议**：提供具体的改进建议
+
+请用中文回复，格式清晰，重点突出。`,
+                tools: ['read_file', 'search_content', 'find_files'],
+                examples: [
+                    {
+                        input: '请审查 src/utils.ts 文件',
+                        output: '我将对 src/utils.ts 进行代码审查...',
+                    },
+                ],
+            },
+            {
+                name: 'refactor',
+                description: '代码重构：重构代码以提高质量和可维护性',
+                instructions: `你是一个代码重构专家。请帮助重构代码：
+
+1. **分析现状**：理解代码当前结构和问题
+2. **重构方案**：提出重构方案和理由
+3. **逐步实施**：小步重构，确保每步正确
+4. **验证结果**：确保重构后功能不变
+
+重构原则：
+- 保持小步前进
+- 每步都可测试
+- 遵循 SOLID 原则
+- 提高代码可读性`,
+                tools: ['read_file', 'write_file', 'edit_file', 'search_content'],
+                examples: [
+                    {
+                        input: '重构 src/handler.ts 使其更易维护',
+                        output: '我将分析并重构 src/handler.ts...',
+                    },
+                ],
+            },
+            {
+                name: 'debug',
+                description: '调试问题：分析和修复代码中的问题',
+                instructions: `你是一个调试专家。请帮助定位和修复问题：
+
+1. **复现问题**：理解问题的具体表现
+2. **定位原因**：通过日志、断点、代码分析找到原因
+3. **修复方案**：提出修复方案并实施
+4. **验证修复**：确保问题已解决
+
+调试技巧：
+- 从错误信息入手
+- 检查最近修改的代码
+- 使用二分法定位问题
+- 添加日志输出`,
+                tools: ['read_file', 'search_content', 'execute_bash', 'find_files'],
+                examples: [
+                    {
+                        input: '用户登录时报 500 错误，请帮忙调试',
+                        output: '我来帮你调试这个登录错误...',
+                    },
+                ],
+            },
+            {
+                name: 'write_tests',
+                description: '编写测试：为代码编写单元测试',
+                instructions: `你是一个测试专家。请帮助编写高质量的测试：
+
+1. **分析代码**：理解需要测试的功能
+2. **设计用例**：覆盖正常、边界、异常情况
+3. **编写测试**：使用项目现有的测试框架
+4. **确保覆盖**：测试关键路径和边界条件
+
+测试原则：
+- AAA 模式（Arrange-Act-Assert）
+- 每个测试只测一个场景
+- 测试名称要清晰描述场景
+- 使用 mock 隔离外部依赖`,
+                tools: ['read_file', 'write_file', 'search_content', 'execute_bash'],
+                examples: [
+                    {
+                        input: '为 src/utils.ts 编写测试',
+                        output: '我来为 src/utils.ts 编写测试...',
+                    },
+                ],
+            },
+            {
+                name: 'explain',
+                description: '解释代码：详细解释代码的工作原理',
+                instructions: `你是一个代码解释专家。请详细解释代码：
+
+1. **整体结构**：先概述代码的整体结构
+2. **关键组件**：解释主要函数、类、模块
+3. **执行流程**：描述代码的执行流程
+4. **设计思路**：解释背后的设计思路
+
+解释方式：
+- 从整体到局部
+- 用通俗易懂的语言
+- 配合示例说明
+- 指出关键细节`,
+                tools: ['read_file', 'search_content', 'find_files'],
+                examples: [
+                    {
+                        input: '解释 src/main.ts 的工作原理',
+                        output: '我来解释 src/main.ts 的工作原理...',
+                    },
+                ],
+            },
+        ];
+    }
+    /**
+     * 从文件加载 Skill
+     */
+    loadSkillFromFile(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const skill = this.parseSkill(content);
+            if (skill) {
+                this.skills.set(skill.name, skill);
+            }
+            return skill;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 从目录加载 Skills
+     */
+    loadSkillsFromDir(dirPath) {
+        const targetDir = dirPath || this.skillsDir;
+        if (!fs.existsSync(targetDir)) {
+            return 0;
+        }
+        const files = fs.readdirSync(targetDir);
+        let count = 0;
+        for (const file of files) {
+            if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+                const skill = this.loadSkillFromFile(path.join(targetDir, file));
+                if (skill)
+                    count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 解析 Skill
+     */
+    parseSkill(content) {
+        try {
+            const data = yaml.load(content);
+            if (data && data.name && data.instructions) {
+                return {
+                    name: data.name,
+                    description: data.description || '',
+                    instructions: data.instructions,
+                    tools: data.tools || [],
+                    examples: data.examples || [],
+                    metadata: data.metadata,
+                };
+            }
+        }
+        catch { }
+        return null;
+    }
+    /**
+     * 获取 Skill
+     */
+    get(name) {
+        return this.skills.get(name);
+    }
+    /**
+     * 获取所有 Skills
+     */
+    getAll() {
+        return Array.from(this.skills.values());
+    }
+    /**
+     * 注册 Skill
+     */
+    register(skill) {
+        this.skills.set(skill.name, skill);
+    }
+    /**
+     * 移除 Skill
+     */
+    remove(name) {
+        return this.skills.delete(name);
+    }
+    /**
+     * 检查 Skill 是否存在
+     */
+    has(name) {
+        return this.skills.has(name);
+    }
+    /**
+     * 获取 Skill 的系统提示
+     */
+    getSystemPrompt(skillName) {
+        const skill = this.skills.get(skillName);
+        if (!skill)
+            return undefined;
+        let prompt = skill.instructions;
+        if (skill.tools && skill.tools.length > 0) {
+            prompt += `\n\n可用工具: ${skill.tools.join(', ')}`;
+        }
+        return prompt;
+    }
+    /**
+     * 搜索 Skills
+     */
+    search(query) {
+        const lowerQuery = query.toLowerCase();
+        return this.getAll().filter(skill => skill.name.toLowerCase().includes(lowerQuery) ||
+            skill.description.toLowerCase().includes(lowerQuery));
+    }
+    /**
+     * 将 Skill 导出为 YAML
+     */
+    exportToYaml(skillName) {
+        const skill = this.skills.get(skillName);
+        if (!skill)
+            return undefined;
+        const data = {
+            name: skill.name,
+            description: skill.description,
+            instructions: skill.instructions,
+        };
+        if (skill.tools && skill.tools.length > 0) {
+            data.tools = skill.tools;
+        }
+        if (skill.examples && skill.examples.length > 0) {
+            data.examples = skill.examples;
+        }
+        if (skill.metadata) {
+            data.metadata = skill.metadata;
+        }
+        return yaml.dump(data, { indent: 2 });
+    }
+}
+export const skillService = new SkillService();
+//# sourceMappingURL=skill.service.js.map

package/dist/modules/skill/skill.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.service.js","sourceRoot":"","sources":["../../../src/modules/skill/skill.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/skill/skill.tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Skill 工具
+ * 按照 skill-guide.md 规范实现
+ */
+import { Tool } from '../tools/tool.types.js';
+export declare const skillTool: Tool;
+export declare function buildAvailableSkillsPrompt(): Promise<string>;
+export declare function skillHandler(args: {
+    name: string;
+}): Promise<{
+    success: boolean;
+    data?: {
+        name: string;
+        description: string;
+        content: string;
+    };
+    error?: string;
+}>;
+//# sourceMappingURL=skill.tool.d.ts.map

package/dist/modules/skill/skill.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.tool.d.ts","sourceRoot":"","sources":["../../../src/modules/skill/skill.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,IAAI,EAA2B,MAAM,wBAAwB,CAAA;AAEtE,eAAO,MAAM,SAAS,EAAE,IA8DvB,CAAA;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAalE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAavK"}

package/dist/modules/skill/skill.tool.js

@@ -0,0 +1,92 @@
+/**
+ * Skill 工具
+ * 按照 skill-guide.md 规范实现
+ */
+import path from 'path';
+import { pathToFileURL } from 'url';
+import { skillsManager } from './skills.manager.js';
+export const skillTool = {
+    name: 'skill',
+    description: '',
+    parameters: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Skill 名称'
+            }
+        },
+        required: ['name']
+    },
+    execute: async (params, context) => {
+        await skillsManager.loadAll();
+        const skill = skillsManager.getSkill(params.name);
+        if (!skill) {
+            const available = skillsManager.getAvailableSkills();
+            const availableList = available.length > 0 ? available.map(s => s.name).join(', ') : 'none';
+            return {
+                success: false,
+                output: '',
+                error: `Skill "${params.name}" not found. Available skills: ${availableList}`
+            };
+        }
+        const dir = path.dirname(skill.filePath);
+        const base = pathToFileURL(dir).href;
+        const files = [];
+        try {
+            const entries = await import('fs/promises').then(fs => fs.readdir(dir));
+            for (const entry of entries.slice(0, 10)) {
+                if (entry !== 'SKILL.md') {
+                    files.push(path.resolve(dir, entry));
+                }
+            }
+        }
+        catch { }
+        const output = [
+            `<skill_content name="${skill.name}">`,
+            `# Skill: ${skill.name}`,
+            '',
+            skill.rawContent.trim(),
+            '',
+            `Base directory for this skill: ${base}`,
+            'Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.',
+            'Note: file list is sampled.',
+            '',
+            '<skill_files>',
+            files.map(f => `<file>${f}</file>`).join('\n'),
+            '</skill_files>',
+            '</skill_content>'
+        ].join('\n');
+        return {
+            success: true,
+            output,
+            metadata: { name: skill.name, dir }
+        };
+    }
+};
+export async function buildAvailableSkillsPrompt() {
+    await skillsManager.loadAll();
+    const skills = skillsManager.getAvailableSkills();
+    if (skills.length === 0) {
+        return '<available_skills>\n  (无可用 Skills)\n</available_skills>';
+    }
+    const skillsXml = skills
+        .map(s => `  <skill>\n    <name>${s.name}</name>\n    <description>${s.description}</description>\n  </skill>`)
+        .join('\n');
+    return `<available_skills>\n${skillsXml}\n</available_skills>`;
+}
+export async function skillHandler(args) {
+    const result = await skillTool.execute(args, {});
+    if (!result.success) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            name: args.name,
+            description: '',
+            content: result.output
+        }
+    };
+}
+//# sourceMappingURL=skill.tool.js.map

package/dist/modules/skill/skill.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.tool.js","sourceRoot":"","sources":["../../../src/modules/skill/skill.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/skill/skill.txt

@@ -0,0 +1,18 @@
+加载一个专门的 Skill（技能），该技能提供特定领域的指令和工作流程。
+
+**功能**：
+- 当你识别到任务匹配以下列出的可用技能时，使用此工具加载完整的技能说明
+- Skill 会将详细的指令、工作流程和访问绑定资源（脚本、参考、模板）注入对话上下文
+- 工具输出包含一个 `<skill_content name="...">` 块，其中包含加载的内容
+
+**使用说明**：
+- 当你识别到任务匹配某个可用 Skill 时，使用此工具加载该技能的完整说明
+- 技能会注入详细的指令、工作流程，以及对捆绑资源（脚本、参考、模板）的访问
+- 工具输出包含一个 `<skill_content name="...">` 块，其中包含加载的内容
+- 该技能的相对路径（如 scripts/、reference/）是相对于技能的基础目录
+
+**当前可用的 Skills**：
+Invoke this tool to load a skill when a task matches one of the available skills listed above.
+
+**参数说明**：
+- `name`: Skill 的名称（必需）

package/dist/modules/skill/skill.types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Skill 模块类型定义
+ * 按照 skill-guide.md 规范实现
+ */
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, string>;
+}
+export interface Skill extends SkillMetadata {
+    content: string;
+    rawContent: string;
+    filePath: string;
+}
+export interface SkillToolParams {
+    name: string;
+}
+export interface SkillToolResult {
+    success: boolean;
+    data?: {
+        name: string;
+        description: string;
+        content: string;
+    };
+    error?: string;
+}
+export interface SkillPermission {
+    pattern: string;
+    action: 'allow' | 'deny' | 'ask';
+}
+export interface SkillsConfig {
+    permissions?: Record<string, 'allow' | 'deny' | 'ask'>;
+}
+export interface AvailableSkill {
+    name: string;
+    description: string;
+}
+//# sourceMappingURL=skill.types.d.ts.map

package/dist/modules/skill/skill.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.types.d.ts","sourceRoot":"","sources":["../../../src/modules/skill/skill.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/modules/skill/skill.types.js

@@ -0,0 +1,6 @@
+/**
+ * Skill 模块类型定义
+ * 按照 skill-guide.md 规范实现
+ */
+export {};
+//# sourceMappingURL=skill.types.js.map

package/dist/modules/skill/skill.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.types.js","sourceRoot":"","sources":["../../../src/modules/skill/skill.types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}