@zhongqian97-code/ecode 0.0.8 → 0.1.0

package/dist/index.js

@@ -3,6 +3,8 @@ const _ew=process.emitWarning.bind(process);process.emitWarning=function(w,...a)
 
 // src/index.ts
 import { createRequire } from "module";
+import { resolve, dirname as dirname2 } from "path";
+import { fileURLToPath } from "url";
 import React4 from "react";
 import { render } from "ink";
 
@@ -11,16 +13,20 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
 var MODEL_CONTEXT_LIMITS = {
+  // OpenAI GPT 系列
   "gpt-4o": 128e3,
   "gpt-4o-mini": 128e3,
   "gpt-4-turbo": 128e3,
   "gpt-4": 8192,
+  // 老版 GPT-4 上下文极小，需特别注意
   "gpt-3.5-turbo": 16385,
+  // OpenAI o 系列推理模型
   "o1": 2e5,
   "o1-mini": 128e3,
   "o1-preview": 128e3,
   "o3": 2e5,
   "o3-mini": 2e5,
+  // Anthropic Claude 系列（全线支持 200K）
   "claude-3-5-sonnet-20241022": 2e5,
   "claude-3-5-haiku-20241022": 2e5,
   "claude-3-opus-20240229": 2e5,
@@ -29,6 +35,7 @@ var MODEL_CONTEXT_LIMITS = {
   "claude-sonnet-4-6": 2e5,
   "claude-opus-4-7": 2e5,
   "claude-haiku-4-5-20251001": 2e5,
+  // DeepSeek 系列（上下文较小，截断策略需更激进）
   "deepseek-chat": 65536,
   "deepseek-reasoner": 65536
 };
@@ -71,14 +78,18 @@ function loadConfig() {
     }
   }
   return {
+    // ?? 运算符：仅在左侧为 null / undefined 时才取右侧值，
+    // 与 || 的区别在于不会跳过空字符串，保证显式设置 "" 也能生效
     baseUrl: process.env.ECODE_BASE_URL ?? fileConfig.baseUrl ?? DEFAULTS.baseUrl,
     apiKey: process.env.ECODE_API_KEY ?? fileConfig.apiKey ?? DEFAULTS.apiKey,
     model: process.env.ECODE_MODEL ?? fileConfig.model ?? DEFAULTS.model,
-    // dangerousPatterns: 文件配置覆盖默认值，不支持环境变量（命令数组不适合通过环境变量传递）
+    // dangerousPatterns 不支持环境变量注入：命令数组通过单个环境变量传递需要转义，
+    // 容易引入歧义，因此仅支持配置文件覆盖
     dangerousPatterns: fileConfig.dangerousPatterns ?? DEFAULTS.dangerousPatterns,
-    // logDir: ECODE_LOG_DIR > 文件配置 > undefined
+    // logDir: ECODE_LOG_DIR 环境变量 > 配置文件 > undefined（禁用日志）
     logDir: process.env.ECODE_LOG_DIR ?? fileConfig.logDir ?? DEFAULTS.logDir,
-    // contextLimit: 仅支持配置文件，不支持环境变量（数值类型直接在文件中配置更清晰）
+    // contextLimit 仅支持配置文件配置：数值类型在文件中更直观，
+    // 环境变量还需要 parseInt 转换，增加出错风险
     contextLimit: fileConfig.contextLimit
   };
 }
@@ -95,6 +106,20 @@ function createLLMClient(config2) {
     apiKey: config2.apiKey
   });
   return {
+    /**
+     * stream 方法向 LLM 发起一次流式对话请求，返回异步可迭代的 chunk 序列。
+     *
+     * 实现细节：
+     * - 使用 `Symbol.asyncIterator` + async generator 实现懒执行：
+     *   只有调用方执行 `for await` 时才真正发起 HTTP 请求，避免浪费连接
+     * - 内部维护两个累加器：
+     *   1. `tcAccumulator`：按 index 聚合工具调用的分片参数（JSON 字符串）
+     *   2. `reasoningAccumulator`：拼接思考链的所有分片文本
+     * - 只在最终 chunk（`finish_reason !== null`）中 yield done=true 的完整信息
+     *
+     * @param messages  完整的对话历史，包含 user/assistant/tool 所有轮次
+     * @param tools     可选的工具列表，不传或传空数组时不附加 tools 字段
+     */
     stream(messages, tools) {
       return {
         [Symbol.asyncIterator]: async function* () {
@@ -141,8 +166,11 @@ function createLLMClient(config2) {
                 text: delta.content ?? "",
                 done: true,
                 finishReason: choice.finish_reason,
+                // tcAccumulator 为空说明本轮没有工具调用，传 undefined 而非空数组，
+                // 让调用方用 if (chunk.toolCalls) 做简洁判断
                 toolCalls: tcAccumulator.size > 0 ? Array.from(tcAccumulator.values()) : void 0,
                 reasoning: reasoningAccumulator || void 0,
+                // 将 snake_case 的原始字段映射为 camelCase，对外接口保持一致
                 usage: rawUsage ? {
                   promptTokens: rawUsage.prompt_tokens,
                   completionTokens: rawUsage.completion_tokens,
@@ -217,13 +245,13 @@ function classifyCommand(cmd, dangerPatterns) {
 import { exec } from "child_process";
 var DEFAULT_TIMEOUT_MS = 3e4;
 function executeBash(cmd, timeoutMs = DEFAULT_TIMEOUT_MS) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     exec(cmd, { timeout: timeoutMs }, (err, stdout, stderr) => {
       if (err) {
         const exitCode = err.code ?? 1;
-        resolve({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode });
+        resolve2({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode });
       } else {
-        resolve({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode: 0 });
+        resolve2({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode: 0 });
       }
     });
   });
@@ -281,6 +309,15 @@ function createLogger(logDir, sessionStart) {
   const filePath = path.join(logDir, filename);
   return {
     filePath,
+    /**
+     * 将单条日志条目序列化为 JSON 并同步追加到文件（末尾加换行符）。
+     *
+     * 使用 appendFileSync 而非 appendFile（异步版本）的原因：
+     * 进程崩溃或 Ctrl-C 退出时，异步写操作可能尚未完成，导致最后几条记录丢失。
+     * 同步写入虽然阻塞事件循环，但日志条目通常很小（< 1KB），延迟可忽略。
+     *
+     * 写入失败时输出到 stderr 而非抛出异常，防止日志错误中断正常业务流程。
+     */
     append(entry) {
       try {
         fs.appendFileSync(filePath, JSON.stringify(entry) + "\n");
@@ -292,6 +329,39 @@ function createLogger(logDir, sessionStart) {
   };
 }
 
+// src/skills/resolver.ts
+function isSkillCommand(input) {
+  return input.length > 1 && input.startsWith("/");
+}
+function parseSkillCommand(input) {
+  const withoutSlash = input.slice(1);
+  const spaceIndex = withoutSlash.search(/\s/);
+  if (spaceIndex === -1) {
+    return { name: withoutSlash, args: "" };
+  }
+  const name = withoutSlash.slice(0, spaceIndex);
+  const args = withoutSlash.slice(spaceIndex).trim();
+  return { name, args };
+}
+
+// src/skills/handler.ts
+function handleSkillInput(input, registry2) {
+  if (!isSkillCommand(input)) return { type: "passthrough" };
+  const { name, args } = parseSkillCommand(input);
+  const skill = registry2.find(name);
+  if (!skill) {
+    const available = registry2.list().map((s) => s.name).join(", ") || "none";
+    return {
+      type: "error",
+      message: `Unknown skill: /${name}. Available: ${available}`
+    };
+  }
+  const content = args ? `${skill.body}
+
+${args}` : skill.body;
+  return { type: "skill", message: { role: "user", content } };
+}
+
 // src/ui/StatusBar.tsx
 import { useEffect, useState } from "react";
 import { Box, Text } from "ink";
@@ -355,7 +425,7 @@ function StatusBar({
   const ctxStr = `ctx: ${tokenUsage.estimated ? "~" : ""}${usedStr}/${limitStr}`;
   const versionStr = `v${version2}`;
   return (
-    // justifyContent="space-between" 让 Ink 自动撑开左右，
+    // 外层 Box：行方向布局，justifyContent="space-between" 实现左右分列
     // 避免用 string.length 手动计算填充（CJK 双宽字符会导致计算偏差）
     /* @__PURE__ */ jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [
       /* @__PURE__ */ jsxs(Box, { flexDirection: "row", children: [
@@ -364,13 +434,13 @@ function StatusBar({
           " "
         ] }),
         confirmPrompt ? (
-          // 确认模式：整体用黄色显示
+          // 确认模式：整体用黄色显示，吸引用户注意
           /* @__PURE__ */ jsxs(Text, { color: "yellow", children: [
             icon,
             label
           ] })
         ) : status === "thinking" || status === "tool_calling" ? (
-          // 进行中状态：icon 用绿色，文字用白色
+          // 进行中状态：图标用绿色（活跃感），标签用白色（可读性）
           /* @__PURE__ */ jsxs(Fragment, { children: [
             /* @__PURE__ */ jsxs(Text, { color: "green", children: [
               icon,
@@ -379,7 +449,7 @@ function StatusBar({
             /* @__PURE__ */ jsx(Text, { color: "white", children: label })
           ] })
         ) : (
-          // 空闲 / 等待确认：淡灰
+          // 空闲 / 等待确认过渡态：整体淡灰，降低视觉权重
           /* @__PURE__ */ jsxs(Fragment, { children: [
             /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
               icon,
@@ -413,7 +483,7 @@ function UserMessage({
   content
 }) {
   return (
-    // 用户消息使用 ">" 前缀，白色，与助手消息对比
+    // marginBottom={0} 避免 Ink 默认添加的底部间距，使历史区域更紧凑
     /* @__PURE__ */ jsx2(Box2, { flexDirection: "row", marginBottom: 0, children: /* @__PURE__ */ jsxs2(Text2, { color: "white", children: [
       "> ",
       content
@@ -427,32 +497,47 @@ function AssistantMessage({
   expandTools
 }) {
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginBottom: 0, children: [
-    reasoning_content && reasoning_content.length > 0 && (expandTools ? /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsx2(Text2, { color: "gray", children: "<thinking>" }),
-      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: reasoning_content })
-    ] }) : /* @__PURE__ */ jsx2(Text2, { color: "gray", children: "[+ thinking]" })),
+    reasoning_content && reasoning_content.length > 0 && (expandTools ? (
+      // 展开：显示 <thinking> 标题和完整推理内容
+      /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx2(Text2, { color: "gray", children: "<thinking>" }),
+        /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: reasoning_content })
+      ] })
+    ) : (
+      // 折叠：一行简短占位符，告知用户有隐藏的思考内容
+      /* @__PURE__ */ jsx2(Text2, { color: "gray", children: "[+ thinking]" })
+    )),
     content && content.trim().length > 0 && /* @__PURE__ */ jsx2(Text2, { color: "cyan", children: content }),
-    tool_calls && tool_calls.length > 0 && (expandTools ? tool_calls.map((tc, idx) => {
-      let argsDisplay = tc.function.arguments;
-      try {
-        const parsed = JSON.parse(tc.function.arguments);
-        if (typeof parsed === "object" && parsed !== null) {
-          argsDisplay = Object.values(parsed).map(String).join(", ");
+    tool_calls && tool_calls.length > 0 && (expandTools ? (
+      // 展开：逐条渲染每个工具调用
+      tool_calls.map((tc, idx) => {
+        let argsDisplay = tc.function.arguments;
+        try {
+          const parsed = JSON.parse(tc.function.arguments);
+          if (typeof parsed === "object" && parsed !== null) {
+            argsDisplay = Object.values(parsed).map(String).join(", ");
+          }
+        } catch {
         }
-      } catch {
-      }
-      return /* @__PURE__ */ jsxs2(Text2, { color: "yellow", children: [
-        "\u2699 \u8C03\u7528\u5DE5\u5177: ",
-        tc.function.name,
-        "(",
-        argsDisplay,
-        ")"
-      ] }, idx);
-    }) : /* @__PURE__ */ jsxs2(Text2, { color: "gray", children: [
-      "[+ ",
-      tool_calls.length,
-      " \u4E2A\u5DE5\u5177\u8C03\u7528]"
-    ] }))
+        return (
+          // 黄色 ⚙ 图标 + 工具名 + 格式化参数
+          /* @__PURE__ */ jsxs2(Text2, { color: "yellow", children: [
+            "\u2699 \u8C03\u7528\u5DE5\u5177: ",
+            tc.function.name,
+            "(",
+            argsDisplay,
+            ")"
+          ] }, idx)
+        );
+      })
+    ) : (
+      // 折叠：用计数占位符替代，避免占用多行
+      /* @__PURE__ */ jsxs2(Text2, { color: "gray", children: [
+        "[+ ",
+        tool_calls.length,
+        " \u4E2A\u5DE5\u5177\u8C03\u7528]"
+      ] })
+    ))
   ] });
 }
 function ToolMessage({
@@ -485,12 +570,18 @@ function estimateLines(msg, expandTools) {
     }
     let toolLines = 0;
     if (assistantMsg.tool_calls && assistantMsg.tool_calls.length > 0) {
-      toolLines = expandTools ? assistantMsg.tool_calls.length : 1;
+      if (expandTools) {
+        toolLines = assistantMsg.tool_calls.length;
+      } else {
+        toolLines = 1;
+      }
     }
     return Math.max(1, contentLines + reasoningLines + toolLines);
   }
   if (msg.role === "tool") {
-    if (!expandTools) return 1;
+    if (!expandTools) {
+      return 1;
+    }
     return Math.min(TOOL_RESULT_MAX_LINES, msg.content.split("\n").length) + 1;
   }
   return 1;
@@ -512,28 +603,31 @@ function ConversationHistory({
     startIdx = i;
   }
   const displayMessages = visible.slice(startIdx);
-  return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: displayMessages.map((msg, idx) => {
-    if (msg.role === "user") {
-      return /* @__PURE__ */ jsx2(UserMessage, { content: msg.content }, idx);
-    }
-    if (msg.role === "assistant") {
-      const assistantMsg = msg;
-      return /* @__PURE__ */ jsx2(
-        AssistantMessage,
-        {
-          content: assistantMsg.content,
-          tool_calls: assistantMsg.tool_calls,
-          reasoning_content: assistantMsg.reasoning_content,
-          expandTools
-        },
-        idx
-      );
-    }
-    if (msg.role === "tool") {
-      return /* @__PURE__ */ jsx2(ToolMessage, { content: msg.content, expandTools }, idx);
-    }
-    return null;
-  }) });
+  return (
+    // 纵向堆叠所有消息
+    /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: displayMessages.map((msg, idx) => {
+      if (msg.role === "user") {
+        return /* @__PURE__ */ jsx2(UserMessage, { content: msg.content }, idx);
+      }
+      if (msg.role === "assistant") {
+        const assistantMsg = msg;
+        return /* @__PURE__ */ jsx2(
+          AssistantMessage,
+          {
+            content: assistantMsg.content,
+            tool_calls: assistantMsg.tool_calls,
+            reasoning_content: assistantMsg.reasoning_content,
+            expandTools
+          },
+          idx
+        );
+      }
+      if (msg.role === "tool") {
+        return /* @__PURE__ */ jsx2(ToolMessage, { content: msg.content, expandTools }, idx);
+      }
+      return null;
+    }) })
+  );
 }
 
 // src/ui/Input.tsx
@@ -596,6 +690,7 @@ function Input({ isActive, onSubmit, placeholder }) {
         });
       }
     },
+    // 第二个参数：仅在 isActive=true 时注册键盘监听
     { isActive }
   );
   const isEmpty = lines.every((line) => line === "");
@@ -617,15 +712,21 @@ function Input({ isActive, onSubmit, placeholder }) {
       ] }, idx);
     }) });
   };
-  return /* @__PURE__ */ jsx3(Box3, { children: isActive ? renderLines() : /* @__PURE__ */ jsxs3(Box3, { children: [
-    /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "> " }),
-    /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: isEmpty ? placeholder ?? "" : lines.join(" ") })
-  ] }) });
+  return /* @__PURE__ */ jsx3(Box3, { children: isActive ? (
+    // 激活状态：调用完整的多行渲染逻辑
+    renderLines()
+  ) : (
+    // 禁用状态：暗色单行显示，不响应键盘
+    /* @__PURE__ */ jsxs3(Box3, { children: [
+      /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "> " }),
+      /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: isEmpty ? placeholder ?? "" : lines.join(" ") })
+    ] })
+  ) });
 }
 
 // src/ui/App.tsx
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
-function App({ config: config2, version: version2, autoMode: autoMode2 = false }) {
+function App({ config: config2, version: version2, autoMode: autoMode2 = false, registry: registry2 }) {
   const [messages, setMessages] = useState3([]);
   const [status, setStatus] = useState3("idle");
   const contextLimit = getContextLimit(config2.model, config2.contextLimit);
@@ -653,8 +754,11 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
       loggerRef.current.append({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         role: msg.role,
+        // content 可能为 null（纯工具调用的 assistant 消息），日志中保留 null
         content: typeof msg.content === "string" ? msg.content : null,
+        // tool_call_id 只在 tool 角色消息中存在，用于关联工具调用与结果
         tool_call_id: "tool_call_id" in msg ? msg.tool_call_id : void 0,
+        // tool_calls 只在 assistant 角色消息中存在（当 LLM 决定调用工具时）
         tool_calls: "tool_calls" in msg ? msg.tool_calls : void 0
       });
     }
@@ -666,10 +770,10 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
     }
   });
   const confirm = useCallback((prompt) => {
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       setStatus("awaiting_confirm");
       setConfirmPrompt(prompt);
-      pendingConfirmRef.current = { resolve };
+      pendingConfirmRef.current = { resolve: resolve2 };
     });
   }, []);
   const runLlmLoop = useCallback(
@@ -681,6 +785,7 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
         confirm,
         print,
         dangerousPatterns: config2.dangerousPatterns,
+        // autoMode=true 时自动同意 normal 级工具调用，无需用户确认
         autoApproveNormal: autoMode2
       };
       let currentMessages = history;
@@ -725,12 +830,14 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
         if (toolCalls.length > 0) {
           const assistantMsg = {
             role: "assistant",
+            // content 可能为空字符串（纯工具调用），存 null 符合 OpenAI API 规范
             content: assistantText || null,
             tool_calls: toolCalls.map((tc) => ({
               id: tc.id,
               type: "function",
               function: { name: tc.name, arguments: tc.arguments }
             })),
+            // 仅在存在思考内容时扩展 reasoning_content 字段
             ...assistantReasoning ? { reasoning_content: assistantReasoning } : {}
           };
           setMessages((prev) => {
@@ -804,6 +911,29 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
         return;
       }
       if (!trimmed) return;
+      if (registry2) {
+        const skillResult = handleSkillInput(trimmed, registry2);
+        if (skillResult.type === "error") {
+          setMessages((prev) => [
+            ...prev,
+            { role: "assistant", content: skillResult.message }
+          ]);
+          return;
+        }
+        if (skillResult.type === "skill") {
+          const nextMessages2 = [...messages, skillResult.message];
+          setMessages(nextMessages2);
+          runLlmLoop(nextMessages2).catch((err) => {
+            setStatus("idle");
+            setToolName(void 0);
+            setMessages((prev) => [
+              ...prev,
+              { role: "assistant", content: `[error] ${String(err)}` }
+            ]);
+          });
+          return;
+        }
+      }
       const userMsg = { role: "user", content: trimmed };
       const nextMessages = [...messages, userMsg];
       setMessages(nextMessages);
@@ -812,6 +942,7 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
         setToolName(void 0);
         setMessages((prev) => [
           ...prev,
+          // 错误消息前缀 "[error]" 便于用户识别和日志筛选
           { role: "assistant", content: `[error] ${String(err)}` }
         ]);
       });
@@ -819,27 +950,116 @@ function App({ config: config2, version: version2, autoMode: autoMode2 = false }
     [status, messages, runLlmLoop]
   );
   const isInputActive = status === "idle" || status === "awaiting_confirm";
-  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", height: "100%", children: [
-    /* @__PURE__ */ jsx4(ConversationHistory, { messages, expandTools }),
-    /* @__PURE__ */ jsx4(
-      StatusBar,
-      {
-        status,
-        toolName,
-        confirmPrompt,
-        version: version2,
-        tokenUsage
-      }
-    ),
-    /* @__PURE__ */ jsx4(
-      Input,
-      {
-        isActive: isInputActive,
-        onSubmit: handleSubmit,
-        placeholder: status === "awaiting_confirm" ? "y / n" : void 0
-      }
-    )
-  ] });
+  return (
+    // 顶层容器：纵向堆叠，撑满终端高度（height="100%"）
+    /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", height: "100%", children: [
+      /* @__PURE__ */ jsx4(ConversationHistory, { messages, expandTools }),
+      /* @__PURE__ */ jsx4(
+        StatusBar,
+        {
+          status,
+          toolName,
+          confirmPrompt,
+          version: version2,
+          tokenUsage
+        }
+      ),
+      /* @__PURE__ */ jsx4(
+        Input,
+        {
+          isActive: isInputActive,
+          onSubmit: handleSubmit,
+          placeholder: status === "awaiting_confirm" ? "y / n" : void 0
+        }
+      )
+    ] })
+  );
+}
+
+// src/skills/registry.ts
+var SkillRegistry = class {
+  skills = /* @__PURE__ */ new Map();
+  /** 注册或覆盖一个 skill（键不区分大小写）。 */
+  register(skill) {
+    this.skills.set(skill.name.toLowerCase(), skill);
+  }
+  /** 按名称查找 skill；未找到时返回 undefined。 */
+  find(name) {
+    return this.skills.get(name.toLowerCase());
+  }
+  /** 返回所有 skill，按名称字母顺序排序。 */
+  list() {
+    return [...this.skills.values()].sort(
+      (a, b) => a.name.localeCompare(b.name)
+    );
+  }
+  /** 已注册的 skill 数量。 */
+  size() {
+    return this.skills.size;
+  }
+};
+
+// src/skills/loader.ts
+import { readFile, readdir, stat } from "fs/promises";
+import { join as join3, dirname, basename } from "path";
+function parseFrontmatter(content) {
+  const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+  const match = FRONTMATTER_RE.exec(content);
+  if (!match) {
+    return { data: {}, body: content };
+  }
+  const rawFrontmatter = match[1];
+  const body = match[2] ?? "";
+  const data = {};
+  for (const line of rawFrontmatter.split(/\r?\n/)) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (key) {
+      data[key] = value;
+    }
+  }
+  return { data, body };
+}
+async function loadSkillFile(skillMdPath) {
+  const content = await readFile(skillMdPath, "utf-8");
+  const { data, body } = parseFrontmatter(content);
+  const dirName = basename(dirname(skillMdPath));
+  return {
+    name: data["name"] ?? dirName,
+    description: data["description"] ?? "",
+    body,
+    source: skillMdPath
+  };
+}
+async function loadSkillsFromDir(dir) {
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return [];
+  }
+  const skills = [];
+  for (const entry of entries) {
+    const entryPath = join3(dir, entry);
+    let entryStat;
+    try {
+      entryStat = await stat(entryPath);
+    } catch {
+      continue;
+    }
+    if (!entryStat.isDirectory()) continue;
+    const skillMdPath = join3(entryPath, "SKILL.md");
+    try {
+      await stat(skillMdPath);
+    } catch {
+      continue;
+    }
+    const skill = await loadSkillFile(skillMdPath);
+    skills.push(skill);
+  }
+  return skills.sort((a, b) => a.name.localeCompare(b.name));
 }
 
 // src/index.ts
@@ -874,4 +1094,13 @@ if (!finalConfig.apiKey) {
   );
   process.exit(1);
 }
-render(React4.createElement(App, { config: finalConfig, version: VERSION, autoMode }));
+var __dirname = dirname2(fileURLToPath(import.meta.url));
+var builtinSkillsDir = resolve(__dirname, "../skills");
+var userSkillsDir = resolve(process.env.HOME ?? "~", ".ecode/skills");
+var projectSkillsDir = resolve(process.cwd(), ".ecode/skills");
+var registry = new SkillRegistry();
+for (const dir of [builtinSkillsDir, userSkillsDir, projectSkillsDir]) {
+  const skills = await loadSkillsFromDir(dir);
+  for (const skill of skills) registry.register(skill);
+}
+render(React4.createElement(App, { config: finalConfig, version: VERSION, autoMode, registry }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhongqian97-code/ecode",
-  "version": "0.0.8",
+  "version": "0.1.0",
   "description": "A minimal Claude Code clone with REPL interface and bash tool calling",
   "type": "module",
   "author": "zhongqian97-code",
@@ -28,6 +28,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "LICENSE"
   ],