@ia-ccun/code-agent-cli 0.0.50 → 0.0.51-beta.2

package/README.md

@@ -217,22 +217,48 @@ aicode-cli --list-models   # 列出可用模型
 
 ### 创建自定义 Skill
 
-在 `~/.aicode-cli/skills/` 目录下创建 `.md` 文件：
+在 `~/.aicode-cli/agent/skills/<skill-name>/` 目录下创建 `SKILL.md` 文件：
+
+```bash
+# 创建技能目录
+mkdir -p ~/.aicode-cli/agent/skills/my-skill
+
+# 创建 SKILL.md
+cat > ~/.aicode-cli/agent/skills/my-skill/SKILL.md << 'EOF'
+---
+name: my-skill
+description: "技能的简短描述。Use when 触发条件描述。"
+metadata:
+  version: "1.0.0"
+  author: "your-name"
+---
 
-```markdown
 # My Skill
 
 ## 描述
-技能说明
+技能的详细说明
 
 ## 触发方式
-/skill:my-skill
+`/skill:my-skill`
 
 ## 执行步骤
 1. 步骤一
 2. 步骤二
+EOF
 ```
 
+**字段说明：**
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `name` | 是 | 技能标识符（小写+连字符），与目录名一致 |
+| `description` | 是 | 触发条件描述，Agent 据此判断何时使用该技能 |
+| `disable-model-invocation` | 否 | 设为 `true` 时禁止调用 LLM，纯本地执行 |
+| `metadata.version` | 否 | 版本号 |
+| `metadata.author` | 否 | 作者 |
+
+> ⚠️ 文件名必须为 `SKILL.md`，且放在独立目录中（目录名与 `name` 一致）。
+
 ## 预置 Prompts
 
 内置 Prompt 模板位于 `config/agent/prompts/`（打包在 npm 包中）
@@ -246,6 +272,68 @@ aicode-cli --list-models   # 列出可用模型
 | `/feat` | 功能开发 - 辅助功能开发 |
 | `/workflow` | 工作流 - 执行复杂工作流 |
 
+## 自定义 Agents
+
+内置 Agent 示例位于 `config/agent/agents/`（打包在 npm 包中）
+
+| Agent | 说明 |
+|-------|------|
+| `agent-example` | 示例 Agent - 展示如何创建自定义 subagent |
+
+### 创建自定义 Agent
+
+在 `~/.aicode-cli/agent/agents/` 目录下创建 `<name>.md` 文件：
+
+```bash
+# 创建 Agent 文件
+cat > ~/.aicode-cli/agent/agents/my-agent.md << 'EOF'
+---
+name: my-agent
+description: "自定义 Agent 的简短描述"
+tools: "read,bash,write,edit"
+model:  "qwen3.5-35b-a3b"
+---
+
+# My Agent
+
+## 角色
+你是一个专业的代码优化助手...
+
+## 能力
+1. 代码分析
+2. 性能优化
+3. 重构建议
+
+## 工作流程
+1. 阅读代码
+2. 分析问题
+3. 提供建议
+EOF
+```
+
+**字段说明：**
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `name` | 是 | Agent 标识符（小写+连字符） |
+| `description` | 是 | 功能描述，用户据此选择 Agent |
+| `tools` | 否 | 逗号分隔的工具列表 |
+| `model` | 否 | 指定使用的模型 |
+
+### 使用 Agent
+
+在对话中自然语言调用：
+
+```
+使用 my-agent 来优化这段代码
+```
+
+或配合 pi-subagents 使用：
+
+```
+/run my-agent "Review this implementation"
+```
+
 ## 项目结构
 
 ```
@@ -265,11 +353,3 @@ aicode-cli --list-models   # 列出可用模型
 │   └── postinstall.js      # 安装脚本
 └── package.json
 ```
-
-## 文档
-
-更多功能请参考 [pi-coding-agent 文档](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent)
-
-## License
-
-MIT

package/bin/cli.js

@@ -193,8 +193,7 @@ async function checkForUpdates() {
 }
 checkForUpdates();
 
-// 获取 node_modules 中 pi-coding-agent 的 CLI 路径
-const piAgentPathUrl = new URL('../node_modules/@mariozechner/pi-coding-agent/dist/cli.js', import.meta.url);
+const piAgentPathUrl = new URL('../node_modules/@earendil-works/pi-coding-agent/dist/cli.js', import.meta.url);
 const piAgentPath = fileURLToPath(piAgentPathUrl); // 解码中文路径
 
 // 获取本地版本号

package/config/agent/agents/agent-example.md

@@ -0,0 +1,88 @@
+---
+name: agent-example
+description: "示例 Agent - 展示如何创建自定义 subagent。可删除或复制此文件作为模板。"
+tools: "read,bash,write,edit"
+model: "qwen3.5-35b-a3b"
+---
+
+# 示例 Agent
+
+> 💡 这是一个自定义 subagent 示例，展示如何创建具有个性和能力的 Agent。
+> 你可以复制此文件，修改 frontmatter 和下方内容来创建自己的 Agent。
+
+## 角色
+
+你是一个专业的代码优化助手，专注于提升代码质量和开发效率。
+
+## 能力
+
+1. **代码分析**：深入理解代码逻辑，识别潜在问题
+2. **性能优化**：发现性能瓶颈，提供优化方案
+3. **重构建议**：改善代码结构和可读性
+4. **最佳实践**：推荐行业标准和设计模式
+
+## 工作流程
+
+1. 首先使用 `read` 工具阅读需要优化的代码
+2. 分析问题并给出具体建议
+3. 使用 `edit` 工具实施改进（需用户确认）
+4. 使用 `bash` 工具验证修改结果
+
+## 输出风格
+
+- 简洁明了，避免冗长解释
+- 使用 Markdown 格式展示代码变更
+- 标注修改原因和预期效果
+- 对重大变更提供回退方案
+
+---
+
+## 📖 创建自定义 Agent 指南
+
+### 文件位置
+
+| 类型 | 路径                                     |
+|------|----------------------------------------|
+| 用户级 | `~/.aicode-cli/agent/agents/<name>.md` |
+| 项目级 | `.aicode-cli/agents/<name>.md`           |
+
+### 文件结构
+
+Agent 文件必须是 `.md` 格式，包含 YAML frontmatter 和 Markdown body：
+
+```markdown
+---
+name: my-agent              # 必填：Agent 名称（小写+连字符）
+description: "简短描述"     # 必填：Agent 功能描述
+tools: "read,bash,write"    # 可选：允许使用的工具（逗号分隔）
+model: "provider/model-id"  # 可选：指定使用的模型
+---
+
+# Agent 标题
+
+这里是 Agent 的 system prompt，定义：
+- 角色定位
+- 能力和职责
+- 工作流程
+- 输出风格
+- 任何你希望 Agent 遵循的规则
+```
+
+### Frontmatter 字段说明
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `name` | 是 | Agent 标识符，小写字母和连字符 |
+| `description` | 是 | 功能描述，用户通过此描述选择 Agent |
+| `tools` | 否 | 逗号分隔的工具列表，不填则使用默认工具集 |
+| `model` | 否 | 指定模型，如 `qwen3.5-35b-a3b` |
+
+### 使用方式
+
+在对话中调用 subagent 时，aicode 会自动发现并使用这些自定义 Agent：
+
+```
+使用 agent-example 来优化这段代码
+```
+
+或在 settings.json 的 `subagents.agentOverrides` 中配置模型覆盖。

package/config/agent/extensions/aicode-tips.ts

@@ -6,7 +6,7 @@
  * 技巧列表包含快捷键、命令使用及联系方式提示
  */
 
-import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 const AICODE_TIPS = [
   "@ 快速搜索项目文件",
@@ -102,6 +102,21 @@ const AICODE_TIPS = [
   "插话消息会打断 AI 正在执行的工具，等待响应",
   "排队消息静默等待，AI 空闲时自动发送",
   "可在 /settings 中调整消息发送模式和行为偏好",
+  // 记忆功能使用技巧
+  "💡 记忆功能自动记录会话中的关键经验，下次会话自动应用",
+  "💡 在对话中说'记住这个'可手动保存经验到记忆库",
+  "💡 记忆功能支持选择性注入 (selective)，只注入相关记忆避免干扰",
+  "💡 说'忘记 XXX'可删除特定记忆条目",
+  "💡 记忆会在会话结束时自动整合优化，提炼更有价值的经验",
+  "💡 记忆功能示例：记住代码规范后，后续开发自动遵循该规范",
+  "💡 记忆功能示例：记录常见错误模式，主动避免重复犯错",
+  "💡 记忆功能示例：保存项目特定配置，新会话自动加载上下文",
+  // Subagent 使用方法
+  "🤖 说'使用 subagent 探索当前代码关于权限校验的实现'可快速定位相关代码",
+  "🤖 说'使用 subagent 为这个功能制定实施计划'可生成详细的开发步骤",
+  "🤖 说'使用 subagent 执行这个计划'可自动完成代码实现",
+  "🤖 说'使用 subagent 审查刚写的代码'可获得代码质量反馈",
+  "🤖 说'使用 subagent 给这个方案提点意见'可获得第二视角的评估建议",
   // 联系方式提示
   "⚠️  任何疑问或需求可联系 xujianjiang，支持需求对接开发、系统集成与扩展",
   "⚠️  内网手册参考 UniDoc《2026.03 AICode Agent CLI 编码智能体使用手册》",

package/config/agent/extensions/bash-check.ts

@@ -10,7 +10,7 @@
  * 危险模式配置: config/agent/dangerous-patterns.json
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";

package/config/agent/extensions/context-monitor.ts

@@ -14,7 +14,7 @@
  * - 100%  : 阻止继续并强制提示压缩
  */
 
-import type { ExtensionAPI, ExtensionContext, ToolResultEvent } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext, ToolResultEvent } from "@earendil-works/pi-coding-agent";
 
 interface ContextThresholds {
 	info: number;    // 70%

package/config/agent/extensions/context.ts

@@ -9,9 +9,9 @@
  * - current context window usage + session totals (tokens/cost)
  */
 
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, ToolResultEvent } from "@mariozechner/pi-coding-agent";
-import { DynamicBorder } from "@mariozechner/pi-coding-agent";
-import { Container, Key, Text, matchesKey, type Component, type TUI } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, ToolResultEvent } from "@earendil-works/pi-coding-agent";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
+import { Container, Key, Text, matchesKey, type Component, type TUI } from "@earendil-works/pi-tui";
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";

package/config/agent/extensions/custom-footer.ts

@@ -6,9 +6,9 @@
  * [gold]  [dim]       [dim]       [color ctx]  [accent]
  */
 
-import type { AssistantMessage } from "@mariozechner/pi-ai";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 function fmtTokens(n: number): string {
 	if (n < 1000) return n.toString();

package/config/agent/extensions/custom.ts

@@ -8,9 +8,9 @@
  * 可以拦截内置工具、注册自定义工具和命令
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import type { AssistantMessage } from "@mariozechner/pi-ai";
-import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 export default function (pi: ExtensionAPI) {
   // === 记录开始时间 ===
@@ -23,25 +23,29 @@ export default function (pi: ExtensionAPI) {
   // === 消息完成通知（只在最后一条显示）===
 
   pi.on("agent_end", async (event, ctx) => {
-    // 计算耗时
-    const elapsed = Date.now() - agentStartTime;
-    let timeStr: string;
-    if (elapsed < 1000) {
-      timeStr = `${elapsed}ms`;
-    } else if (elapsed < 60000) {
-      timeStr = `${(elapsed / 1000).toFixed(1)}s`;
-    } else {
-      const mins = Math.floor(elapsed / 60000);
-      const secs = Math.floor((elapsed % 60000) / 1000);
-      timeStr = `${mins}m ${secs}s`;
-    }
+    try {
+      // 计算耗时
+      const elapsed = Date.now() - agentStartTime;
+      let timeStr: string;
+      if (elapsed < 1000) {
+        timeStr = `${elapsed}ms`;
+      } else if (elapsed < 60000) {
+        timeStr = `${(elapsed / 1000).toFixed(1)}s`;
+      } else {
+        const mins = Math.floor(elapsed / 60000);
+        const secs = Math.floor((elapsed % 60000) / 1000);
+        timeStr = `${mins}m ${secs}s`;
+      }
 
-    // 格式化完整时间
-    const now = new Date();
-    const timeStr2 = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')} ${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}:${String(now.getSeconds()).padStart(2, '0')}`;
+      // 格式化完整时间
+      const now = new Date();
+      const timeStr2 = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')} ${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}:${String(now.getSeconds()).padStart(2, '0')}`;
 
-    // agent_end 表示一轮对话结束，显示完成提示
-    ctx.ui.notify(`${timeStr2} | ✨ 消息处理完成 (${timeStr})`, "info");
+      // agent_end 表示一轮对话结束，显示完成提示
+      ctx.ui.notify(`${timeStr2} | ✨ 消息处理完成 (${timeStr})`, "info");
+    } catch (e) {
+      // 忽略错误（ctx 可能已过期）
+    }
   });
 
   // === 拦截工具调用 ===

package/config/agent/extensions/error-monitor.ts

@@ -3,15 +3,16 @@
  *
  * @author: xujianjiang
  *
- * Logs errors to ./.aicode-cli/debug-logs/aicode-error-YYYY-MM-DD.log
+ * Logs errors to ~/.aicode-cli/logs/aicode-error-YYYY-MM-DD.log
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import fs from "fs";
+import os from "os";
 import path from "path";
 
 // Error log file configuration
-const ERROR_LOG_DIR = path.resolve(process.cwd(), "./.aicode-cli/debug-logs");
+const ERROR_LOG_DIR = path.resolve(os.homedir(), ".aicode-cli", "logs");
 const KEEP_DAYS = 2; // 保留最近2天
 
 // 北京时间格式化函数 (UTC+8)

package/config/agent/extensions/msg-debug.ts

@@ -15,7 +15,7 @@
 
 import { appendFileSync, existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 // 北京时间格式化函数 (UTC+8)
 function formatBeijingTime(date: Date = new Date()): string {
@@ -125,6 +125,21 @@ ${JSON.stringify({ ...payload, messages: filteredMessages }, null, 2)}
 		const timestamp = formatBeijingTime();
 		const { response, usage, cached } = event;
 		
+		// Check if response is defined
+		if (!response) {
+			const logEntry = `
+================================================================================
+[${timestamp}] AFTER PROVIDER RESPONSE
+================================================================================
+Cached: ${cached ? "YES" : "NO"}
+Error: Response is undefined
+
+================================================================================
+`;
+			appendFileSync(logFile, logEntry, "utf8");
+			return;
+		}
+		
 		const logEntry = `
 ================================================================================
 [${timestamp}] AFTER PROVIDER RESPONSE

package/config/agent/extensions/review.ts

@@ -27,9 +27,9 @@
  * Note: PR review requires a clean working tree (no uncommitted changes to tracked files).
  */
 
-import type { ExtensionAPI, ExtensionContext, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { DynamicBorder, BorderedLoader } from "@mariozechner/pi-coding-agent";
-import { Container, type SelectItem, SelectList, Text } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionContext, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { DynamicBorder, BorderedLoader } from "@earendil-works/pi-coding-agent";
+import { Container, type SelectItem, SelectList, Text } from "@earendil-works/pi-tui";
 import path from "node:path";
 import { promises as fs } from "node:fs";
 

package/config/agent/extensions/working-msg.ts

@@ -5,8 +5,8 @@
  * 自定义工作消息，格式类似 Claude Code: ✶ xxx… (时间 · tokens)
  */
 
-import type { ExtensionAPI, TurnEndEvent } from "@mariozechner/pi-coding-agent";
-import type { AssistantMessage } from "@mariozechner/pi-ai";
+import type { ExtensionAPI, TurnEndEvent } from "@earendil-works/pi-coding-agent";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
 
 // 主题色 #49bccf
 const accentColor = "\x1b[38;2;73;188;207m";

package/config/agent/help.md

@@ -31,6 +31,8 @@ npm install -g @ia-ccun/code-agent-cli
 
 ```bash
 aicode-cli
+# 或
+aicode
 ```
 
 ### 基本对话
@@ -66,6 +68,15 @@ Ctrl+Q
 Enter
 ```
 
+### Git Worktree 支持
+
+使用 `/skill:using-git-worktrees` 在多工作区间高效切换：
+
+```
+/skill:using-git-worktrees
+帮我创建一个新的 worktree 来开发登录功能
+```
+
 ---
 
 ## 3. 核心命令
@@ -90,6 +101,13 @@ Enter
 
 思考级别：`off` → `minimal` → `low` → `medium` → `high` → `xhigh`
 
+### 技能相关
+
+| 命令 | 说明 |
+|------|------|
+| `/skill:<name>` | 激活指定技能 |
+| `/skills` | 列出所有可用技能 |
+
 ---
 
 ## 4. 快捷键
@@ -224,16 +242,71 @@ Skill 是预置的 AI 技能模块，针对特定场景优化。
 
 ### 可用 Skills
 
+#### 代码开发
+
 | Skill | 说明 | 激活方式 |
 |-------|------|----------|
-| code-review | 代码审查 | `/skill:code-review` |
-| commit | Git 提交 | `/skill:commit` |
-| pr | PR 描述 | `/skill:pr` |
-| refactor | 代码重构 | `/skill:refactor` |
-| unit-test | 单元测试 | `/skill:unit-test` |
-| csv-data-summarizer | CSV 数据分析 | `/skill:csv-data-summarizer` |
-| frontend-design | 前端设计 | `/skill:frontend-design` |
-| ui-ux-pro-max | UI/UX 设计 | `/skill:ui-ux-pro-max` |
+| `code-review` | 代码审查 | `/skill:code-review` |
+| `refactor` | 代码重构 | `/skill:refactor` |
+| `unit-test` | 单元测试 | `/skill:unit-test` |
+| `test-driven-development` | 测试驱动开发 | `/skill:test-driven-development` |
+| `frontend-design` | 前端设计 | `/skill:frontend-design` |
+| `owasp-security` | OWASP 安全编码 | `/skill:owasp-security` |
+
+#### Git 相关
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `commit` | Git 提交消息生成 | `/skill:commit` |
+| `using-git-worktrees` | Git Worktree 管理 | `/skill:using-git-worktrees` |
+
+#### 数据分析
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `csv-data-summarizer` | CSV 数据分析 | `/skill:csv-data-summarizer` |
+| `design-md` | Markdown 设计文档 | `/skill:design-md` |
+
+#### UI/UX 设计
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `ui-ux-pro-max` | UI/UX 专业设计 | `/skill:ui-ux-pro-max` |
+| `impeccable/*` | 完美界面系列技能 | `/skill:impeccable:polish` 等 |
+
+#### 多媒体
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `video-generation` | 视频生成 | `/skill:video-generation` |
+| `aliyun-tts` | 阿里云 TTS | `/skill:aliyun-tts` |
+| `xiaomi-tts` | 小米 TTS | `/skill:xiaomi-tts` |
+
+#### 写作与内容
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `khazix-writer` | 公众号长文写作 | `/skill:khazix-writer` |
+| `hv-analysis` | 横纵分析法深度研究 | `/skill:hv-analysis` |
+
+#### 开发流程
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `brainstorming` | 头脑风暴 | `/skill:brainstorming` |
+| `writing-plans` | 编写实施计划 | `/skill:writing-plans` |
+| `executing-plans` | 执行计划 | `/skill:executing-plans` |
+| `dispatching-parallel-agents` | 并行任务分发 | `/skill:dispatching-parallel-agents` |
+| `systematic-debugning` | 系统性调试 | `/skill:systematic-debugging` |
+| `verification-before-completion` | 完成前验证 | `/skill:verification-before-completion` |
+
+#### 技能管理
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `skill-creator` | 创建/编辑技能 | `/skill:skill-creator` |
+| `session-learning` | 会话学习总结 | `/skill:session-learning` |
+| `find-skills` | 查找技能 | `/skill:find-skills` |
 
 ### 使用方法
 
@@ -254,13 +327,11 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 | Prompt | 说明 |
 |--------|------|
-| `/bmad-init` | 初始化 BMAD 项目 |
 | `/init-project` | 初始化新项目 |
 | `/feat` | 新增功能开发流程 |
 | `/git-commit` | Git 提交 |
-| `/git-rollback` | Git 回滚 |
-| `/git-worktree` | Git Worktree 管理 |
 | `/workflow` | 复杂工作流 |
+| `/code-simplifier` | 代码简化 |
 
 ### 使用示例
 
@@ -273,6 +344,9 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 # Git 提交
 /git-commit
+
+# 复杂工作流
+/workflow
 ```
 
 ---
@@ -293,9 +367,11 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 | 主题 | 说明 |
 |------|------|
-| dark | 暗色主题 |
-| light | 亮色主题 |
-| catppuccin-mocha | 猫puccin mocha（推荐） |
+| `catppuccin-mocha` | Catppuccin Mocha 暗色主题（推荐） |
+
+### 自定义主题
+
+主题文件位于 `~/.aicode-cli/agent/themes/`，可自定义颜色和样式。
 
 ---
 
@@ -320,6 +396,12 @@ Prompt 是预置的工作流模板，用于特定任务。
 2. **先审后改**：重要修改前先让 AI 解释代码
 3. **备份优先**：关键文件操作前手动备份
 
+### Git 工作流
+
+1. **使用 Worktree**：多分支并行开发时使用 Git Worktree
+2. **规范提交**：使用 `/skill:commit` 生成规范提交消息
+3. **代码审查**：重要变更使用 `/skill:code-review` 审查
+
 ---
 
 ## 10. 故障排除
@@ -328,10 +410,11 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 | 问题 | 解决方案 |
 |------|----------|
-| 启动慢 | 检查网络连接 |
-| 模型连接失败 | 核对 models.json 配置 |
-| 扩展不生效 | 运行 `/reload` 重载 |
+| 启动慢 | 检查网络连接，确认模型 API 可达 |
+| 模型连接失败 | 核对 `models.json` 配置和 API Key |
+| 扩展不生效 | 运行 `/reload` 重载配置 |
 | Token 溢出 | 使用 `/clear` 清理上下文 |
+| Skills 找不到 | 确认技能已安装到 `~/.aicode-cli/agent/skills/` |
 
 ### 详细模式
 
@@ -339,6 +422,12 @@ Prompt 是预置的工作流模板，用于特定任务。
 aicode-cli --verbose
 ```
 
+### 查看上下文
+
+```bash
+/context
+```
+
 ---
 
 ## 附录
@@ -347,8 +436,8 @@ aicode-cli --verbose
 
 | 变量 | 说明 |
 |------|------|
-| `AICODE_CLI_CONFIG_DIR` | 配置目录 |
-| `AICODE_CLI_CODING_AGENT_DIR` | Agent 配置目录 |
+| `AICODE_CLI_CONFIG_DIR` | 配置目录路径 |
+| `AICODE_CLI_CODING_AGENT_DIR` | Agent 配置目录路径 |
 
 ### 命令行参数
 
@@ -359,6 +448,12 @@ aicode-cli --verbose
 | `--model <name>` | 指定模型 |
 | `--clear` | 启动时清理会话 |
 
+### 相关资源
+
+- **项目仓库**: https://github.com/ia-ccun/code-agent-cli
+- **npm 包**: https://www.npmjs.com/package/@ia-ccun/code-agent-cli
+- **pi-coding-agent**: 底层 Agent 框架
+
 ---
 
 *世界那么哒 · AI 实践落地 @2026*

package/config/agent/settings.json

@@ -1,5 +1,7 @@
 {
   "quietStartup":true,
+  "defaultProvider": "aicode",
+  "defaultModel": "qwen3.5-35b-a3b",
   "theme":"light",
   "extensions":[
     "~/.aicode-cli/agent/extensions/bash-check.ts",
@@ -11,9 +13,46 @@
     "~/.aicode-cli/agent/extensions/working-msg.ts"
   ],
   "packages":[  
-    "npm:pi-subagents",
-    "npm:pi-rewind",
-    "npm:pi-btw",
-    "npm:pi-mcp-adapter"
-  ]
+    "npm:pi-subagents@0.17.1",
+    "npm:pi-rewind@0.5.0",
+    "npm:pi-btw@0.2.1",
+    "npm:pi-mcp-adapter@2.4.0",
+    "npm:@juicesharp/rpiv-todo",
+    "npm:@juicesharp/rpiv-ask-user-question",
+    "npm:@juicesharp/rpiv-advisor",
+    "npm:@samfp/pi-memory@1.1.1"
+  ],
+  "memory": {
+    "localPath": "~/.aicode-cli/memory",
+    "lessonInjection": "selective",
+    "consolidationModel": "qwen3.5-35b-a3b"
+  },
+  "subagents": {
+    "agentOverrides": {
+      "scout": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "researcher": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "planner": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "worker": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "reviewer": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "context-builder": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "oracle": {
+        "model": "qwen3.5-35b-a3b"
+      },
+      "delegate": {
+        "model": "qwen3.5-35b-a3b"
+      }
+    }
+  }
 }

package/dist/index.d.ts

@@ -2,9 +2,8 @@
  * aicode-cli
  * AI Coding Agent CLI
  *
- * 基于 @mariozechner/pi-coding-agent 的封装
  */
-export * from '@mariozechner/pi-coding-agent';
+export * from '@earendil-works/pi-coding-agent';
 export { defaultConfig, type AppConfig } from './config.js';
 export { getConfig, getConfigDir, loadConfig } from './config-loader.js';
 export { defaultBanner, generateBanner } from './banner.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iCAAiC,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -2,10 +2,8 @@
  * aicode-cli
  * AI Coding Agent CLI
  *
- * 基于 @mariozechner/pi-coding-agent 的封装
  */
-// 重新导出 pi-coding-agent 的核心功能
-export * from '@mariozechner/pi-coding-agent';
+export * from '@earendil-works/pi-coding-agent';
 // 导出配置相关
 export { defaultConfig } from './config.js';
 export { getConfig, getConfigDir, loadConfig } from './config-loader.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6BAA6B;AAC7B,cAAc,+BAA+B,CAAC;AAE9C,SAAS;AACT,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEzE,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iCAAiC,CAAC;AAEhD,SAAS;AACT,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEzE,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-ccun/code-agent-cli",
-  "version": "0.0.50",
+  "version": "0.0.51-beta.2",
   "description": "AI Coding Agent CLI - 基于OpenClaw🦞底层Agent（pi）原理封装的编码智能体（供学习使用）。",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,10 +35,10 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@mariozechner/pi-agent-core": "0.62.0",
-    "@mariozechner/pi-ai": "0.62.0",
-    "@mariozechner/pi-coding-agent": "0.62.0",
-    "@mariozechner/pi-tui": "0.62.0"
+    "@earendil-works/pi-agent-core": "^0.74.0",
+    "@earendil-works/pi-ai": "^0.74.0",
+    "@earendil-works/pi-coding-agent": "^0.74.0",
+    "@earendil-works/pi-tui": "^0.74.0"
   },
   "overrides": {
     "glob": "^11.0.0",
@@ -50,6 +50,7 @@
     "@typescript-eslint/parser": "^8.57.0",
     "eslint": "^10.0.3",
     "husky": "^9.1.7",
+    "playwright": "^1.60.0",
     "shx": "^0.4.0",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.57.0"

package/scripts/postinstall.js

@@ -21,7 +21,7 @@ const piDir = join(homeDir, '.pi');
 // ============================================================================
 // Fix pi-coding-agent APP_NAME
 // ============================================================================
-const piAgentPackageJson = join(__dirname, '..', 'node_modules', '@mariozechner', 'pi-coding-agent', 'package.json');
+const piAgentPackageJson = join(__dirname, '..', 'node_modules', '@earendil-works', 'pi-coding-agent', 'package.json');
 if (existsSync(piAgentPackageJson)) {
   try {
     const piPkg = JSON.parse(readFileSync(piAgentPackageJson, 'utf-8'));
@@ -39,7 +39,7 @@ if (existsSync(piAgentPackageJson)) {
 }
 
 // Fix pi-coding-agent cli.js process.title
-const piAgentCliJs = join(__dirname, '..', 'node_modules', '@mariozechner', 'pi-coding-agent', 'dist', 'cli.js');
+const piAgentCliJs = join(__dirname, '..', 'node_modules', '@earendil-works', 'pi-coding-agent', 'dist', 'cli.js');
 if (existsSync(piAgentCliJs)) {
   try {
     let cliContent = readFileSync(piAgentCliJs, 'utf-8');
@@ -54,7 +54,7 @@ if (existsSync(piAgentCliJs)) {
 }
 
 // Fix pi-coding-agent config.js APP_NAME default
-const piAgentConfigJs = join(__dirname, '..', 'node_modules', '@mariozechner', 'pi-coding-agent', 'dist', 'config.js');
+const piAgentConfigJs = join(__dirname, '..', 'node_modules', '@earendil-works', 'pi-coding-agent', 'dist', 'config.js');
 if (existsSync(piAgentConfigJs)) {
   try {
     let configContent = readFileSync(piAgentConfigJs, 'utf-8');
@@ -69,7 +69,7 @@ if (existsSync(piAgentConfigJs)) {
 }
 
 // Fix pi-coding-agent slash commands - change "Quit pi" to "Quit aicode-cli"
-const slashCommandsJs = join(__dirname, '..', 'node_modules', '@mariozechner', 'pi-coding-agent', 'dist', 'core', 'slash-commands.js');
+const slashCommandsJs = join(__dirname, '..', 'node_modules', '@earendil-works', 'pi-coding-agent', 'dist', 'core', 'slash-commands.js');
 if (existsSync(slashCommandsJs)) {
   try {
     let content = readFileSync(slashCommandsJs, 'utf-8');
@@ -171,6 +171,7 @@ const FORCE_OVERWRITE_LIST = [
   'SYSTEM.md',
   'dangerous-patterns.json',
   'settings.json',
+  'help.md',
   'extensions/working-msg.ts',
   'extensions/custom-footer.ts',
   'extensions/custom.ts',