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

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

@@ -144,7 +144,7 @@ if (config.banner === '__default__' || config.banner !== '') {
 // 检查新版本
 async function checkForUpdates() {
   try {
-    const { execSync } = await import('child_process');
+    const { execFileSync } = await import('child_process');
     // 读取本地版本 - 向上查找 package.json
     let rootDir = __dirname;
     let localVersion = null;
@@ -158,9 +158,9 @@ async function checkForUpdates() {
     }
     if (!localVersion) return;
 
-    // 获取当前 registry
-    const registry = execSync('npm config get registry', { encoding: 'utf8', stdio: 'pipe' }).trim();
-    const latestVersion = execSync(`npm view @ia-ccun/code-agent-cli version --registry=${registry}`, { encoding: 'utf8', stdio: 'pipe' }).trim();
+    // 🔒 Security: Use execFileSync instead of execSync to prevent command injection
+    const registry = execFileSync('npm', ['config', 'get', 'registry'], { encoding: 'utf8', stdio: 'pipe' }).trim();
+    const latestVersion = execFileSync('npm', ['view', '@ia-ccun/code-agent-cli', 'version', '--registry=' + registry], { encoding: 'utf8', stdio: 'pipe' }).trim();
 
     // 比较版本号
     const localParts = localVersion.split('.').map(Number);
@@ -175,7 +175,8 @@ async function checkForUpdates() {
     try {
       const cacheDir = join(process.env.HOME || process.env.USERPROFILE, '.aicode-cli');
       if (!existsSync(cacheDir)) {
-        execSync(`mkdir -p "${cacheDir}"`, { stdio: 'pipe' });
+        // 🔒 Security: Use execFileSync for mkdir instead of execSync
+        execFileSync('mkdir', ['-p', cacheDir], { stdio: 'pipe' });
       }
       const cacheData = {
         localVersion,
@@ -193,8 +194,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` 中配置模型覆盖。