skill-any-code 1.0.0 → 1.0.1

package/dist/infrastructure/index.service.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexService = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const utils_1 = require("../common/utils");
+// V2.6 起不再在主流程生成/依赖 analysis-index.json。
+// 为兼容历史代码/测试，此类暂保留，但不再实现 IIndexService 接口。
+class IndexService {
+    getIndexFilePath(storageRoot) {
+        return path.join(storageRoot, 'analysis-index.json');
+    }
+    async buildIndex(projectRoot, storageRoot, fileEntries, dirEntries) {
+        const entries = {};
+        for (const entry of fileEntries) {
+            entries[(0, utils_1.normalizePath)(entry.sourcePath)] = {
+                resultPath: (0, utils_1.normalizePath)(entry.resultPath),
+                type: 'file',
+            };
+        }
+        for (const entry of dirEntries) {
+            entries[(0, utils_1.normalizePath)(entry.sourcePath)] = {
+                resultPath: (0, utils_1.normalizePath)(entry.resultPath),
+                type: 'directory',
+            };
+        }
+        const indexData = {
+            version: '1.0',
+            projectRoot: (0, utils_1.normalizePath)(projectRoot),
+            storageRoot: (0, utils_1.normalizePath)(storageRoot),
+            generatedAt: new Date().toISOString(),
+            entries,
+        };
+        const indexPath = this.getIndexFilePath(storageRoot);
+        await fs.ensureDir(path.dirname(indexPath));
+        await fs.writeJson(indexPath, indexData, { spaces: 2 });
+    }
+    async updateIndex(storageRoot, updatedEntries, removedPaths) {
+        const existing = (await this.readIndex(storageRoot)) ?? {
+            version: '1.0',
+            projectRoot: '',
+            storageRoot,
+            generatedAt: new Date().toISOString(),
+            entries: {},
+        };
+        for (const removedPath of removedPaths) {
+            delete existing.entries[(0, utils_1.normalizePath)(removedPath)];
+        }
+        for (const entry of updatedEntries) {
+            existing.entries[(0, utils_1.normalizePath)(entry.sourcePath)] = {
+                resultPath: (0, utils_1.normalizePath)(entry.resultPath),
+                type: entry.type,
+            };
+        }
+        existing.generatedAt = new Date().toISOString();
+        const indexPath = this.getIndexFilePath(storageRoot);
+        await fs.writeJson(indexPath, existing, { spaces: 2 });
+    }
+    async readIndex(storageRoot) {
+        const indexPath = this.getIndexFilePath(storageRoot);
+        if (await fs.pathExists(indexPath)) {
+            return await fs.readJson(indexPath);
+        }
+        return null;
+    }
+    async resolve(storageRoot, absolutePath) {
+        const indexData = await this.readIndex(storageRoot);
+        if (!indexData)
+            return null;
+        const normalized = (0, utils_1.normalizePath)(absolutePath);
+        const entry = indexData.entries[normalized];
+        return entry ? entry.resultPath : null;
+    }
+}
+exports.IndexService = IndexService;

package/dist/infrastructure/llm/llm.usage.tracker.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMUsageTracker = void 0;
+/**
+ * 单次解析周期内的 LLM Token 使用统计器。
+ *
+ * - 对所有调用做累计统计；
+ * - 通过 onSnapshot 回调向上层（如 CLI 渲染器）推送最新快照；
+ * - 不直接向 stdout 打印 Token 行，由 CLI 统一渲染「Tokens: ...」。
+ */
+class LLMUsageTracker {
+    onSnapshot;
+    stats = {
+        totalPromptTokens: 0,
+        totalCompletionTokens: 0,
+        totalTokens: 0,
+        totalCalls: 0,
+    };
+    constructor(onSnapshot) {
+        this.onSnapshot = onSnapshot;
+    }
+    addUsage(usage) {
+        this.stats.totalPromptTokens += usage.promptTokens ?? 0;
+        this.stats.totalCompletionTokens += usage.completionTokens ?? 0;
+        this.stats.totalTokens += usage.totalTokens ?? 0;
+        this.stats.totalCalls += 1;
+        const snapshot = this.getStats();
+        if (this.onSnapshot) {
+            this.onSnapshot(snapshot);
+        }
+    }
+    /**
+     * 将外部汇总（例如 worker 线程返回的本任务 usage delta）累加到总量中。
+     * 注意：这里的 totalCalls 表示调用次数增量，而不是“任务数”。
+     */
+    addTotals(delta) {
+        this.stats.totalPromptTokens += delta.totalPromptTokens ?? 0;
+        this.stats.totalCompletionTokens += delta.totalCompletionTokens ?? 0;
+        this.stats.totalTokens += delta.totalTokens ?? 0;
+        this.stats.totalCalls += delta.totalCalls ?? 0;
+        const snapshot = this.getStats();
+        if (this.onSnapshot) {
+            this.onSnapshot(snapshot);
+        }
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    reset() {
+        this.stats = {
+            totalPromptTokens: 0,
+            totalCompletionTokens: 0,
+            totalTokens: 0,
+            totalCalls: 0,
+        };
+    }
+}
+exports.LLMUsageTracker = LLMUsageTracker;

package/dist/infrastructure/llm/openai.client.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIClient = void 0;
+const openai_1 = __importDefault(require("openai"));
+const errors_1 = require("../../common/errors");
+const logger_1 = require("../../common/logger");
+class OpenAIClient {
+    client;
+    config;
+    tracker;
+    constructor(config, tracker) {
+        this.config = config;
+        this.tracker = tracker;
+        this.client = new openai_1.default({
+            apiKey: config.api_key,
+            baseURL: config.base_url,
+            timeout: config.timeout,
+            dangerouslyAllowBrowser: true,
+        });
+    }
+    /**
+     * 连接可用性校验（V2.5）
+     * - 在进入任何解析流程前调用；
+     * - 配置不完整或服务不可用时抛出带有明确 ErrorCode 的 AppError。
+     */
+    async testConnection(config) {
+        // 保持与最新配置一致（允许运行时通过 CLI/环境变量覆盖）
+        this.config = config;
+        // 基本配置校验：base_url / api_key / model 不能为空
+        if (!this.config.base_url || !this.config.api_key || !this.config.model) {
+            throw new errors_1.AppError(errors_1.ErrorCode.LLM_INVALID_CONFIG, 'Incomplete LLM config. Please set base_url/api_key/model via config file, env vars, or CLI options.', {
+                missing: {
+                    base_url: !this.config.base_url,
+                    api_key: !this.config.api_key,
+                    model: !this.config.model,
+                },
+            });
+        }
+        try {
+            const res = await this.client.chat.completions.create({
+                model: this.config.model,
+                temperature: 0,
+                max_tokens: 1,
+                messages: [{ role: 'system', content: 'health-check' }],
+            });
+            const status = res.status ?? 200;
+            if (status === 401) {
+                throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, 'LLM authentication failed (401)', { status });
+            }
+            if (status === 404) {
+                throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, 'LLM model not found (404)', { status });
+            }
+            if (status < 200 || status >= 300) {
+                throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, `LLM connectivity check returned non-2xx status: ${status}`, { status });
+            }
+        }
+        catch (e) {
+            if (e instanceof errors_1.AppError) {
+                throw e;
+            }
+            const code = e?.code || e?.status;
+            if (code === 'ETIMEDOUT') {
+                throw new errors_1.AppError(errors_1.ErrorCode.LLM_TIMEOUT, 'LLM connectivity check timed out', e);
+            }
+            if (code === 'ENOTFOUND' || code === 'ECONNREFUSED' || code === 'ECONNRESET') {
+                throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, 'Unable to reach LLM service. Check network or base_url.', e);
+            }
+            throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, `LLM connectivity check failed: ${e?.message || String(e)}`, e);
+        }
+    }
+    /**
+     * 向后兼容旧版本/测试中使用的 connectTest 名称。
+     * 内部直接代理到 V2.5 的 testConnection。
+     */
+    async connectTest() {
+        await this.testConnection(this.config);
+    }
+    async call(prompt, options) {
+        const startTime = Date.now();
+        const retries = options?.retries ?? this.config.max_retries;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const response = await this.client.chat.completions.create({
+                    model: options?.model ?? this.config.model,
+                    temperature: options?.temperature ?? this.config.temperature,
+                    max_tokens: options?.maxTokens ?? this.config.max_tokens,
+                    messages: [
+                        { role: 'user', content: prompt }
+                    ]
+                });
+                const content = response.choices[0].message.content || '';
+                const usage = response.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+                const normalizedUsage = {
+                    promptTokens: usage.prompt_tokens ?? 0,
+                    completionTokens: usage.completion_tokens ?? 0,
+                    totalTokens: usage.total_tokens ?? 0,
+                };
+                if (this.tracker) {
+                    this.tracker.addUsage(normalizedUsage);
+                }
+                return {
+                    content,
+                    usage: normalizedUsage,
+                    model: response.model,
+                    responseTime: Date.now() - startTime,
+                };
+            }
+            catch (error) {
+                const errorMessage = error?.message || 'Unknown LLM call error';
+                logger_1.logger.debug(`LLM call attempt ${attempt + 1} failed: ${errorMessage}`);
+                if (attempt === retries) {
+                    if (error?.status === 429) {
+                        throw new errors_1.AppError(errors_1.ErrorCode.LLM_RATE_LIMITED, 'LLM service rate limited', error);
+                    }
+                    else if (error?.code === 'ETIMEDOUT') {
+                        throw new errors_1.AppError(errors_1.ErrorCode.LLM_TIMEOUT, 'LLM call timeout', error);
+                    }
+                    else {
+                        throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, `LLM call failed: ${errorMessage}`, error);
+                    }
+                }
+                await this.sleep(this.config.retry_delay * Math.pow(2, attempt));
+            }
+        }
+        throw new errors_1.AppError(errors_1.ErrorCode.LLM_CALL_FAILED, 'Max retries exceeded');
+    }
+    async batchCall(prompts, options) {
+        const results = [];
+        for (const prompt of prompts) {
+            results.push(await this.call(prompt, options));
+        }
+        return results;
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.OpenAIClient = OpenAIClient;

package/{src/infrastructure/llm/prompt.template.ts → dist/infrastructure/llm/prompt.template.js}

@@ -1,6 +1,9 @@
-// ===== Three-step protocol: single file =====
-/** Step 1: Extract structure only (classes / globals / functions). No summary/description/basic info. */
-export const FILE_STRUCTURE_PROMPT = `
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHUNK_ANALYSIS_PROMPT = exports.CODE_ANALYSIS_PROMPT = exports.DIRECTORY_SUMMARY_PROMPT = exports.DIRECTORY_DESCRIPTION_PROMPT = exports.MERGE_STRUCTURE_PROMPT = exports.PARSE_RETRY_HINT = exports.FILE_SUMMARY_PROMPT = exports.FILE_DESCRIPTION_PROMPT = exports.FILE_STRUCTURE_PROMPT = void 0;
+// ===== Three-step protocol: single file =====
+/** Step 1: Extract structure only (classes / globals / functions). No summary/description/basic info. */
+exports.FILE_STRUCTURE_PROMPT = `
 Extract ONLY the following structure from the code file. Return STRICT JSON and nothing else.
 Do NOT generate summary/description or any basic info (language, LOC, dependencies, etc.).
 
@@ -29,19 +32,17 @@ Return JSON with ONLY these fields:
 }
 
 If nothing is found, return empty arrays. Do NOT output any other fields.
-`;
-
-/** Step 2: Generate description only (<= 200 words) */
-export const FILE_DESCRIPTION_PROMPT = `
+`;
+/** Step 2: Generate description only (<= 200 words) */
+exports.FILE_DESCRIPTION_PROMPT = `
 Based on the extracted structure JSON below, describe the overall purpose of this file in <= 200 words.
 Return ONLY one JSON object: {"description": "..."}. No other text.
 
 Structure JSON:
 {{structureJson}}
-`;
-
-/** Step 3: Generate summary only (<= 100 words) */
-export const FILE_SUMMARY_PROMPT = `
+`;
+/** Step 3: Generate summary only (<= 100 words) */
+exports.FILE_SUMMARY_PROMPT = `
 Based on the structure and description below, write a one-sentence high-level summary in <= 100 words.
 Return ONLY one JSON object: {"summary": "..."}. No other text.
 
@@ -50,18 +51,16 @@ Structure JSON:
 
 Description:
 {{description}}
-`;
-
-/** Retry hint when parsing fails (append to original prompt) */
-export const PARSE_RETRY_HINT = `
+`;
+/** Retry hint when parsing fails (append to original prompt) */
+exports.PARSE_RETRY_HINT = `
 
 [IMPORTANT] Your previous output did NOT match the required format.
 Return STRICTLY the JSON specified above and NOTHING ELSE (no markdown, no explanations, no extra text).
-`;
-
-// ===== Merge stage =====
-/** Merge step: merge and deduplicate multiple chunk results into one structure */
-export const MERGE_STRUCTURE_PROMPT = `
+`;
+// ===== Merge stage =====
+/** Merge step: merge and deduplicate multiple chunk results into one structure */
+exports.MERGE_STRUCTURE_PROMPT = `
 Below are analysis results for multiple chunks of the same file. Merge and deduplicate them into ONE complete structure (classes and global functions).
 Return ONLY JSON. Do NOT generate description or summary.
 
@@ -90,11 +89,10 @@ Return JSON with ONLY these fields:
 }
 
 Keep item formats consistent with the chunk results. Do NOT output any other fields.
-`;
-
-// ===== Directory two-step protocol =====
-/** Directory step 1: generate description (<= 200 words) */
-export const DIRECTORY_DESCRIPTION_PROMPT = `
+`;
+// ===== Directory two-step protocol =====
+/** Directory step 1: generate description (<= 200 words) */
+exports.DIRECTORY_DESCRIPTION_PROMPT = `
 You are a codebase structure analysis assistant. Below is a JSON list of all direct child directories and files (with brief summaries).
 Write an English paragraph (<= 200 words) describing the directory's role and responsibilities in the project.
 
@@ -102,10 +100,9 @@ Return ONLY one JSON object: {"description": "..."}. No other text.
 
 Children (JSON):
 {{childrenJson}}
-`;
-
-/** Directory step 2: generate summary (<= 100 words) */
-export const DIRECTORY_SUMMARY_PROMPT = `
+`;
+/** Directory step 2: generate summary (<= 100 words) */
+exports.DIRECTORY_SUMMARY_PROMPT = `
 Based on the directory description and children JSON below, write a one-sentence high-level summary in English (<= 100 words).
 Focus on the big picture and avoid details.
 
@@ -116,13 +113,11 @@ Directory description:
 
 Children (JSON):
 {{childrenJson}}
-`;
-
-export const CODE_ANALYSIS_PROMPT = `
+`;
+exports.CODE_ANALYSIS_PROMPT = `
 (Deprecated legacy prompt. Kept empty for backward compatibility; not used in the main pipeline.)
-`;
-
-export const CHUNK_ANALYSIS_PROMPT = `
+`;
+exports.CHUNK_ANALYSIS_PROMPT = `
 Analyze the following code chunk. Extract ONLY the structure that is confidently present in THIS chunk (classes, global variables, global functions).
 Return STRICT JSON and nothing else. Do NOT generate description, summary, or diagrams.
 
@@ -172,4 +167,4 @@ Rules:
 3) Analyze ONLY this chunk; context is reference only
 4) Do NOT output fields like basicInfo, partialDiagrams, summary, description, etc.
 5) Write all descriptions in English
-`;
+`;

package/dist/infrastructure/llm.service.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llmService = exports.OpenAILLMService = void 0;
+const openai_1 = __importDefault(require("openai"));
+const config_1 = require("../common/config");
+const errors_1 = require("../common/errors");
+const logger_1 = require("../common/logger");
+class OpenAILLMService {
+    client = null;
+    async getClient() {
+        if (!this.client) {
+            let config;
+            try {
+                config = config_1.configManager.getConfig();
+            }
+            catch (e) {
+                await config_1.configManager.load();
+                config = config_1.configManager.getConfig();
+            }
+            if (!config.llm.api_key) {
+                throw new errors_1.AppError(errors_1.ErrorCode.ANALYSIS_EXCEPTION, 'LLM API key not configured. Please set it in config file or via SKILL_ANY_CODE_LLM_API_KEY environment variable.');
+            }
+            this.client = new openai_1.default({
+                baseURL: config.llm.base_url,
+                apiKey: config.llm.api_key,
+            });
+        }
+        return this.client;
+    }
+    async generateCompletion(prompt, systemPrompt = 'You are a code analysis expert. You help analyze code files, generate summaries, class diagrams, and other analysis results. Be concise and accurate.') {
+        const client = await this.getClient();
+        const config = config_1.configManager.getConfig();
+        try {
+            logger_1.logger.debug(`Calling LLM model ${config.llm.model} with prompt length: ${prompt.length}`);
+            const response = await client.chat.completions.create({
+                model: config.llm.model,
+                messages: [
+                    { role: 'system', content: systemPrompt },
+                    { role: 'user', content: prompt },
+                ],
+                temperature: 0.1,
+                max_tokens: 2048,
+            });
+            const result = response.choices[0]?.message?.content?.trim() || '';
+            if (!result) {
+                throw new errors_1.AppError(errors_1.ErrorCode.ANALYSIS_EXCEPTION, 'LLM returned empty response');
+            }
+            logger_1.logger.debug(`LLM response received, length: ${result.length}`);
+            return result;
+        }
+        catch (error) {
+            logger_1.logger.error('LLM call failed:', error);
+            throw new errors_1.AppError(errors_1.ErrorCode.ANALYSIS_EXCEPTION, `LLM call failed: ${error.message}`);
+        }
+    }
+}
+exports.OpenAILLMService = OpenAILLMService;
+exports.llmService = new OpenAILLMService();

package/dist/infrastructure/skill/skill.generator.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillGenerator = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const skill_md_template_1 = require("./templates/skill.md.template");
+const resolve_script_1 = require("./templates/resolve.script");
+const logger_1 = require("../../common/logger");
+const PROVIDER_DIRECTORY_MAP = {
+    opencode: '.agents/skills/skill-any-code',
+    cursor: '.agents/skills/skill-any-code',
+    codex: '.agents/skills/skill-any-code',
+    claude: '.claude/skills/skill-any-code',
+};
+class SkillGenerator {
+    async generate(options) {
+        const { projectRoot, providers } = options;
+        const deployedPaths = [];
+        const uniqueDirs = new Set();
+        for (const p of providers) {
+            const lowerProvider = p.toLowerCase();
+            const dir = PROVIDER_DIRECTORY_MAP[lowerProvider];
+            if (dir) {
+                uniqueDirs.add(dir);
+            }
+            else {
+                logger_1.logger.warn(`Unknown provider: ${p}. Skipped.`);
+            }
+        }
+        const skillMd = (0, skill_md_template_1.getSkillMdContent)();
+        const resolveScript = (0, resolve_script_1.getResolveScriptContent)();
+        for (const relativeDir of uniqueDirs) {
+            const targetDir = path.join(projectRoot, relativeDir);
+            try {
+                await fs.ensureDir(targetDir);
+                await fs.ensureDir(path.join(targetDir, 'scripts'));
+                await fs.writeFile(path.join(targetDir, 'SKILL.md'), skillMd, 'utf-8');
+                await fs.writeFile(path.join(targetDir, 'scripts', 'get-summary.py'), resolveScript, 'utf-8');
+                deployedPaths.push(targetDir);
+                logger_1.logger.debug(`Skill deployed to: ${targetDir}`);
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                logger_1.logger.warn(`Failed to deploy skill (${targetDir}): ${msg}`);
+            }
+        }
+        return deployedPaths;
+    }
+}
+exports.SkillGenerator = SkillGenerator;

package/{src/infrastructure/skill/templates/resolve.script.ts → dist/infrastructure/skill/templates/resolve.script.js}

@@ -1,16 +1,19 @@
-/**
- * scripts/get-summary.py 内容模板（部署到 Skill 目录中的独立脚本，仅使用 Python 标准库）
- *
- * 约定：
- * - 输入：命令行参数 argv[1]，应为项目内文件或目录「相对项目根目录」的相对路径
- * - 行为：遵循主程序的结果 md 命名规则，推导目标对象对应的结果 md 路径；若结果 md 存在则输出其相对项目根路径
- * - 输出：
- *   - 命中：stdout 输出对应 Markdown 结果文件的相对路径（相对项目根目录，单行）
- *   - 未命中：stdout 输出字符串 "N/A"（单行）
- *   - 参数错误：stderr 输出错误信息并以 exit code 1 退出
- */
-export function getResolveScriptContent(): string {
-  return `#!/usr/bin/env python3
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getResolveScriptContent = getResolveScriptContent;
+/**
+ * scripts/get-summary.py 内容模板（部署到 Skill 目录中的独立脚本，仅使用 Python 标准库）
+ *
+ * 约定：
+ * - 输入：命令行参数 argv[1]，应为项目内文件或目录「相对项目根目录」的相对路径
+ * - 行为：遵循主程序的结果 md 命名规则，推导目标对象对应的结果 md 路径；若结果 md 存在则输出其相对项目根路径
+ * - 输出：
+ *   - 命中：stdout 输出对应 Markdown 结果文件的相对路径（相对项目根目录，单行）
+ *   - 未命中：stdout 输出字符串 "N/A"（单行）
+ *   - 参数错误：stderr 输出错误信息并以 exit code 1 退出
+ */
+function getResolveScriptContent() {
+    return `#!/usr/bin/env python3
 from __future__ import annotations
 
 import os
@@ -93,5 +96,5 @@ def main() -> int:
 
 if __name__ == "__main__":
   raise SystemExit(main())
-`
-}
+`;
+}

package/dist/infrastructure/skill/templates/skill.md.template.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSkillMdContent = getSkillMdContent;
+function getSkillMdContent() {
+    const lines = [
+        '---',
+        'name: code-atlas-navigator',
+        'description: Use this skill when you need to explore, understand, or search this codebase. Input a file or directory path relative to the project root to retrieve the path to its detailed natural language summary. Use this progressively to navigate from the root directory down to specific target files without reading the full raw source code.',
+        '---',
+        '',
+        '# Codebase Navigation Guide',
+        '',
+        'This repository has been pre-analyzed and summarized into natural language Markdown files. To save context window and improve accuracy, **do not read the raw source code directly**. Instead, use this skill to progressively navigate the repository layer by layer.',
+        '',
+        '## 🧭 How to Explore the Codebase',
+        '',
+        "1. **Start High-Level**: If you don't know the exact file location, begin by querying the summary of the root directory (`.`).",
+        '2. **Progressive Disclosure**: Read the directory summary to understand its sub-components. Identify the next relevant sub-directory or file based on your current task.',
+        '3. **Drill Down**: Query the summaries of those specific sub-components. Repeat this until you locate the target function, class, or logic.',
+        '',
+        '## 🛠️ How to Locate a Summary File',
+        '',
+        'Use the provided Python script to map the original codebase path to its corresponding Markdown summary path.',
+        '',
+        '**Script Specification:**',
+        '* **Input Parameter**: The relative path of the target file or directory with respect to the project root.',
+        '* **Output**: The relative path of the Markdown summary file with respect to the project root.',
+        '* **Fallback**: If the summary Markdown file cannot be found, the script will strictly output `N/A`.',
+        '',
+        '### Execution Commands',
+        '',
+        'Since the execution environment may vary, please use the appropriate command based on your current operating system:',
+        '',
+        '**For Linux / macOS (Bash/Zsh):**',
+        '```bash',
+        'python3 scripts/get_summary.py <relative/path/to/target>',
+        '```',
+        '(Note: If python3 is not found, fallback to python).',
+        '',
+        '**For Windows (CMD/PowerShell):**',
+        '```dos',
+        'python scripts\\get_summary.py <relative\\path\\to\\target>',
+        '```',
+        '(Note: You may also use py or python3 depending on the Windows environment setup).',
+    ];
+    return lines.join('\n') + '\n';
+}