@ia-ccun/code-agent-cli 0.0.50-beta.1 → 0.0.50-beta.3

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 包中）

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

@@ -11,9 +11,12 @@
     "~/.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"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-ccun/code-agent-cli",
-  "version": "0.0.50-beta.1",
+  "version": "0.0.50-beta.3",
   "description": "AI Coding Agent CLI - 基于OpenClaw🦞底层Agent（pi）原理封装的编码智能体（供学习使用）。",
   "type": "module",
   "main": "./dist/index.js",