minimal-agent 0.1.0

package/skills/config/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: config
+description: 配置向导技能。当用户输入 "/config" 且没有任何其他内容时触发。用于重新配置 LLM provider（BASE_URL / API_KEY / MODEL）。
+---
+
+# Config Skill
+
+当用户**只输入 `/config`** 时（不带任何其他内容）触发，引导用户重新配置 LLM provider。
+
+使用 Read 读现有配置（如有），逐项询问用户新值（允许保留旧值），最后用 Write 工具写入 `~/.minimal-agent/config.json`，并提示用户重启 minimal-agent 使新配置生效。
+
+⚠️ 重要：本技能仅在用户**精确输入 `/config`**（前后无任何其他文字）时触发。如果用户的消息里包含其他内容（例如 "/config 帮我看下"、"我想 /config 一下"），不要触发，按普通对话回应。
+
+---
+
+## 执行步骤
+
+### Step 1: 读取现有配置
+
+调用 Read 工具：
+
+```
+Read({ file_path: "~/.minimal-agent/config.json" })
+```
+
+- 文件存在 → 解析 JSON，记住当前的 `baseURL` / `apiKey` / `model` / `provider` / `contextWindow` 字段
+- 文件不存在 → 这是首次手动配置，所有字段都是空
+
+⚠️ 注意：用户的 home 目录路径需要展开（`~` → 实际路径）。Read 工具会自动处理，但若失败，尝试用 `process.env.HOME` 或 `process.env.USERPROFILE`（Windows）拼路径。
+
+### Step 2: 逐项询问用户
+
+依次询问以下字段，每项展示当前值（若有），并明确说明可以"直接回车保留当前值"：
+
+| 字段 | 必需 | 说明 |
+|---|---|---|
+| `baseURL` | ✅ | OpenAI 兼容 API 的 base URL，如 `https://api.minimax.chat/v1` |
+| `apiKey` | ✅ | API key（敏感信息） |
+| `model` | ✅ | 模型 id，如 `MiniMax-M2.7` |
+| `provider` | ⬜ | 显示名（仅用于状态栏），默认 `env` |
+| `contextWindow` | ⬜ | 模型上下文窗口（token 数），默认 `128000` |
+
+**对话格式示例**（每次只问一个字段，等用户答完再问下一个）：
+
+```
+当前 baseURL: https://api.minimax.chat/v1
+请输入新的 baseURL（直接回车保留当前值）：
+```
+
+如果用户回车直接发空消息，保留旧值。
+
+### Step 3: 写入配置
+
+收齐所有字段后，构造完整 JSON 对象并用 Write 工具写入：
+
+```
+Write({
+  file_path: "~/.minimal-agent/config.json",
+  content: JSON.stringify({
+    baseURL: <...>,
+    apiKey: <...>,
+    model: <...>,
+    provider: <...>,
+    contextWindow: <...>,
+    savedAt: Date.now()
+  }, null, 2)
+})
+```
+
+字段 `savedAt` 必须是当前的 unix 毫秒时间戳。
+
+### Step 4: 提示重启
+
+写入成功后，输出（中文）：
+
+```
+✅ 配置已更新到 ~/.minimal-agent/config.json
+
+⚠️ 当前会话仍在使用旧配置。请按以下步骤让新配置生效：
+  1. 按 Ctrl+C 退出 minimal-agent
+  2. 重新运行（bun run start / minimal-agent / bun run src/main.tsx）
+
+如果不想等重启，也可以临时 `export MINIMAL_AGENT_BASE_URL=... API_KEY=... MODEL=...`
+再重新运行 —— 环境变量始终优先于配置文件。
+```
+
+---
+
+## 不做的事
+
+- ❌ 不要主动调用 LLM API 测试新配置 —— 这可能用旧配置去打新地址，混乱
+- ❌ 不要修改 `.env` 文件 —— 那是用户的私有文件，由用户自己管
+- ❌ 不要在用户输入 `/config 帮我...` 等带其他内容的消息时触发本技能
+- ❌ 不要试图"热重启"或重新加载 provider —— 重启进程是最可靠的方式

package/skills/diff/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: diff
+description: 当用户问"改了什么"、"有什么变化"、"show me changes"、"看看改动"、"diff"、"差异"时使用。显示工作区或暂存区的变更内容，帮助用户理解当前代码状态。
+---
+
+# /diff —— 查看 Git 变更
+
+## Quick Reference
+
+| 步骤 | 操作 |
+|------|------|
+| 1 | 用 Bash 工具执行 `git status` 查看变更概览 |
+| 2 | 用 Bash 工具执行 `git diff` 查看未暂存变更 |
+| 3 | 或用 Bash 工具执行 `git diff --staged` 查看已暂存变更 |
+| 4 | 如需单文件详情：`git diff -- <file_path>` |
+
+## 常用变体
+
+| 需求 | 命令 |
+|------|------|
+| 只看文件名（不改动内容） | `git diff --name-only` |
+| 看统计（增删行数） | `git diff --stat` |
+| 看某个文件的函数级变更 | `git diff -p -- <file> \| grep -A5 "func_name"` |
+| 对比两次提交之间 | `git diff <commit_a> <commit_b>` |
+| 看暂存 vs 上次提交 | `git diff --cached --stat` |
+
+## 输出格式建议
+- 先给总结：改了几个文件、增删多少行
+- 再按文件列出关键变更
+- 大文件只展示变更的函数/方法，不列全文

package/skills/docx/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.