Skill: rocherkong/claudecode-controller (version 1.0.0)

--- name: claudecode-controller description: 控制和管理 Claude Code 编码助手，支持项目感知编码、代码审查、重构和功能实现。使用 ACP 运行时在隔离会话中执行 Claude Code 任务，或在主会话中管理配置和项目上下文。 license: MIT --- # Claude Code Controller 本技能提供对 Anthropic Claude Code 的完整控制，让你能够在 OpenClaw 环境中高效使用 Claude 进行代码开发。 ## 核心能力 1. **项目感知编码** - Claude Code 理解你的项目结构和上下文 2. **代码审查** - 自动审查 PR、提供改进建议 3. **重构辅助** - 安全地重构现有代码 4. **功能实现** - 从需求描述到完整实现 5. **调试帮助** - 定位和修复 bug 6. **文档生成** - 自动生成代码文档 ## 使用方式 ### 模式选择 | 模式 | 用途 | 命令 | |------|------|------| | **ACP 隔离会话** | 长时间编码任务、需要独立上下文 | `/claudecode <任务描述>` | | **主会话管理** | 配置管理、快速查询、项目设置 | `/claudecode-config <操作>` | ### 基本命令 ```bash # 启动 Claude Code 进行编码任务 /claudecode 帮我实现一个用户登录功能，使用 JWT 认证 # 代码审查 /claudecode 审查这个 PR 的代码质量，检查潜在问题 # 重构代码 /claudecode 重构这个模块，提高可维护性和性能 # 调试帮助 /claudecode 帮我找出这个 bug 的原因并修复 ``` ## 配置管理 ### 设置 Claude Code 1. **安装 Claude Code CLI** (如未安装): ```bash npm install -g @anthropic-ai/claude-code ``` 2. **配置 API 密钥**: ```bash # 设置环境变量 export ANTHROPIC_API_KEY="your-api-key" # 或在 ~/.claude/config.json 中配置 ``` 3. **验证安装**: ```bash claude --version ``` ### 项目配置 在项目根目录创建 `.claude/settings.json`: ```json { "model": "claude-sonnet-4-5-20250929", "allowedTools": ["bash", "edit", "write", "read"], "maxTurns": 50, "permissionMode": "auto" } ``` ## 工作流程 ### 1. 代码开发流程 ``` 需求分析 → 方案设计 → 代码实现 → 测试验证 → 代码审查 ``` **示例对话**: ``` 用户：帮我创建一个 REST API，包含用户 CRUD 操作 Claude: 我将使用 Express.js 创建 API，包含以下端点： - POST /users - 创建用户 - GET /users/:id - 获取用户 - PUT /users/:id - 更新用户 - DELETE /users/:id - 删除用户 开始实现... ``` ### 2. 代码审查流程 ``` 代码加载 → 静态分析 → 问题识别 → 建议生成 → 修复实施 ``` **审查要点**: - 代码风格和一致性 - 潜在 bug 和边界情况 - 性能优化机会 - 安全漏洞检查 - 测试覆盖率 ### 3. 重构流程 ``` 代码分析 → 识别改进点 → 制定重构计划 → 安全重构 → 验证测试 ``` **常见重构**: - 提取函数/类 - 简化条件逻辑 - 优化数据结构 - 改进命名和文档 ## 最佳实践 ### 提示词技巧 1. **具体明确**: 清晰描述需求和约束 2. **提供上下文**: 说明项目背景和技术栈 3. **分步执行**: 复杂任务分解为小步骤 4. **验证输出**: 审查生成的代码是否符合预期 ### 安全注意事项 1. **权限控制**: 限制 Claude Code 的文件访问范围 2. **代码审查**: 始终审查生成的代码后再提交 3. **敏感信息**: 不要将 API 密钥等敏感信息放入代码 4. **版本控制**: 使用 git 跟踪所有更改 ## 故障排除 ### 常见问题 | 问题 | 解决方案 | |------|----------| | API 密钥错误 | 检查 `ANTHROPIC_API_KEY` 环境变量 | | 命令未找到 | 确认已安装 `@anthropic-ai/claude-code` | | 权限被拒绝 | 检查 `.claude/settings.json` 中的 allowedTools | | 超时错误 | 增加 `maxTurns` 配置或使用更小的任务 | ### 日志和调试 ```bash # 查看 Claude Code 日志 cat ~/.claude/logs/latest.log # 调试模式运行 claude --debug ``` ## 高级功能 ### 多模型支持 ```json { "models": { "default": "claude-sonnet-4-5-20250929", "complex": "claude-opus-4-5-20250929", "quick": "claude-haiku-4-5-20250929" } } ``` ### 自定义工具 创建自定义工具脚本放在 `~/.claude/tools/`: ```bash #!/bin/bash # ~/.claude/tools/run-tests.sh npm test "$@" ``` ### 项目模板 使用预定义模板快速启动项目: ```bash claude --template express-api claude --template react-app claude --template python-package ``` ## 与 OpenClaw 集成 ### ACP 会话使用 当使用 ACP 运行时，Claude Code 将在隔离会话中执行: ``` 用户请求 → OpenClaw → ACP 会话 → Claude Code → 结果返回 ``` **优势**: - 独立上下文，不污染主会话 - 可配置超时和模型 - 支持长时间运行任务 ### 主会话管理 在主会话中管理配置和项目设置: - 查看和修改配置 - 管理项目上下文 - 查看历史记录 - 快速查询和统计 ## 参考资源 - [Claude Code 官方文档](https://docs.anthropic.com/claude-code) - [OpenClaw ACP 文档](https://docs.openclaw.ai) - [技能开发指南](/usr/lib/node_modules/openclaw/skills/skill-creator/SKILL.md)

path: scripts/launch-claudecode.sh
content: #!/bin/bash
# launch-claudecode.sh - 启动 Claude Code 会话
# 用法：./launch-claudecode.sh [项目目录] [模型] [任务描述]

set -e

# 默认配置
DEFAULT_MODEL="claude-sonnet-4-5-20250929"
DEFAULT_TIMEOUT=3600

# 颜色输出
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color

# 检查依赖
check_dependencies() {
    if ! command -v claude &> /dev/null; then
        echo -e "${RED}错误：Claude Code 未安装${NC}"
        echo "请运行：npm install -g @anthropic-ai/claude-code"
        exit 1
    fi
    
    if [ -z "$ANTHROPIC_API_KEY" ]; then
        echo -e "${RED}错误：未设置 ANTHROPIC_API_KEY 环境变量${NC}"
        echo "请设置：export ANTHROPIC_API_KEY=\"your-key\""
        exit 1
    fi
}

# 检查项目配置
check_project_config() {
    local project_dir="$1"
    local config_file="$project_dir/.claude/settings.json"
    
    if [ ! -f "$config_file" ]; then
        echo -e "${YELLOW}提示：项目无 Claude 配置，创建默认配置...${NC}"
        mkdir -p "$project_dir/.claude"
        cat > "$config_file" << EOF
{
  "model": "$DEFAULT_MODEL",
  "allowedTools": ["bash", "edit", "write", "read"],
  "maxTurns": 50,
  "permissionMode": "auto"
}
EOF
    fi
}

# 主函数
main() {
    local project_dir="${1:-.}"
    local model="${2:-$DEFAULT_MODEL}"
    local task="${3:-}"
    
    echo -e "${GREEN}=== Claude Code 启动器 ===${NC}"
    echo "项目目录：$(cd "$project_dir" && pwd)"
    echo "使用模型：$model"
    echo ""
    
    check_dependencies
    check_project_config "$project_dir"
    
    # 进入项目目录
    cd "$project_dir"
    
    if [ -n "$task" ]; then
        echo -e "${GREEN}执行任务：$task${NC}"
        echo ""
        # 带任务启动
        claude --model "$model" "$task"
    else
        echo -e "${YELLOW}进入交互模式，输入任务描述或输入 /help 查看帮助${NC}"
        echo ""
        # 交互模式
        claude --model "$model"
    fi
}

# 执行
main "$@"


path: references/workflows.md
content: # Claude Code 工作流参考

## 常用开发工作流

### 1. 新功能开发

```markdown
**触发条件**: 用户需要实现新功能

**步骤**:
1. 需求澄清 - 确认功能细节和边界条件
2. 技术方案 - 设计实现方案和架构
3. 代码实现 - 编写代码和单元测试
4. 自检验证 - 运行测试确保功能正常
5. 文档更新 - 更新相关文档

**示例提示词**:
- "帮我实现一个用户认证系统，支持邮箱登录和 JWT"
- "创建一个数据导入功能，支持 CSV 和 Excel 格式"
```

### 2. Bug 修复

```markdown
**触发条件**: 发现 bug 或异常行为

**步骤**:
1. 问题复现 - 确认 bug 的触发条件
2. 根因分析 - 定位问题源头
3. 修复方案 - 设计修复策略
4. 代码修复 - 实施修复并添加测试
5. 回归验证 - 确保修复不引入新问题

**示例提示词**:
- "这个函数在处理空数组时抛出异常，帮我修复"
- "用户报告登录后页面空白，帮我排查原因"
```

### 3. 代码重构

```markdown
**触发条件**: 代码需要改进可维护性或性能

**步骤**:
1. 代码分析 - 识别需要重构的部分
2. 重构计划 - 制定安全的重构步骤
3. 渐进重构 - 小步重构，每步验证
4. 测试覆盖 - 确保重构后测试通过
5. 性能对比 - 验证性能改进

**示例提示词**:
- "这个模块太复杂了，帮我重构提高可读性"
- "优化这个函数的性能，它现在是瓶颈"
```

### 4. 代码审查

```markdown
**触发条件**: 需要审查代码质量

**审查清单**:
- [ ] 代码风格一致性
- [ ] 命名清晰准确
- [ ] 函数职责单一
- [ ] 错误处理完善
- [ ] 边界条件覆盖
- [ ] 注释和文档充分
- [ ] 测试覆盖率足够
- [ ] 无明显安全漏洞
- [ ] 性能考虑合理

**示例提示词**:
- "审查这个 PR，重点关注安全性和性能"
- "检查这个模块是否有潜在的 bug"
```

### 5. 技术调研

```markdown
**触发条件**: 需要评估技术方案或库

**步骤**:
1. 需求定义 - 明确调研目标和约束
2. 方案收集 - 列出可行的技术方案
3. 对比分析 - 评估各方案优劣
4. 原型验证 - 快速验证关键假设
5. 建议输出 - 给出推荐方案和理由

**示例提示词**:
- "比较一下 Express.js 和 Fastify 的性能和生态"
- "调研一下实现实时通信的最佳方案"
```

## 模型选择指南

| 任务类型 | 推荐模型 | 理由 |
|----------|----------|------|
| 简单修复 | claude-haiku | 快速、经济 |
| 常规开发 | claude-sonnet | 平衡质量和速度 |
| 复杂架构 | claude-opus | 深度思考和规划 |
| 代码审查 | claude-sonnet | 细节把控好 |
| 技术调研 | claude-opus | 分析能力强 |

## 权限配置参考

### 开发环境 (宽松)

```json
{
  "allowedTools": ["bash", "edit", "write", "read", "mcp"],
  "permissionMode": "auto",
  "maxTurns": 100
}
```

### 生产环境 (严格)

```json
{
  "allowedTools": ["read", "edit"],
  "permissionMode": "always",
  "maxTurns": 30,
  "readOnlyDirs": ["/etc", "/var"]
}
```

### 审查环境 (只读)

```json
{
  "allowedTools": ["read"],
  "permissionMode": "auto",
  "maxTurns": 50
}
```


path: references/config-reference.md
content: # Claude Code 配置参考

## 环境变量

| 变量名 | 说明 | 示例 |
|--------|------|------|
| `ANTHROPIC_API_KEY` | Anthropic API 密钥 | `sk-ant-...` |
| `ANTHROPIC_MODEL` | 默认模型 | `claude-sonnet-4-5-20250929` |
| `CLAUDE_CODE_TIMEOUT` | 超时时间 (秒) | `3600` |
| `CLAUDE_CODE_MAX_TURNS` | 最大对话轮数 | `50` |

## 配置文件位置

- **全局配置**: `~/.claude/config.json`
- **项目配置**: `<project>/.claude/settings.json`
- **日志目录**: `~/.claude/logs/`
- **工具目录**: `~/.claude/tools/`

## 项目配置示例

### 基础配置

```json
{
  "model": "claude-sonnet-4-5-20250929",
  "allowedTools": ["bash", "edit", "write", "read"],
  "maxTurns": 50,
  "permissionMode": "auto"
}
```

### 高级配置

```json
{
  "model": "claude-sonnet-4-5-20250929",
  "allowedTools": ["bash", "edit", "write", "read", "mcp"],
  "maxTurns": 100,
  "permissionMode": "auto",
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-filesystem"]
    }
  },
  "customInstructions": "始终使用 TypeScript，遵循 ESLint 规则，编写单元测试",
  "excludeTools": ["web_search"],
  "allowedDirectories": ["./src", "./tests", "./docs"],
  "readOnlyDirectories": ["./config"]
}
```

## 模型选择

### 可用模型

| 模型 | 适用场景 | 速度 | 成本 |
|------|----------|------|------|
| `claude-haiku-4-5-20250929` | 简单任务、快速响应 | 快 | 低 |
| `claude-sonnet-4-5-20250929` | 常规开发、代码审查 | 中 | 中 |
| `claude-opus-4-5-20250929` | 复杂架构、深度分析 | 慢 | 高 |

### 模型切换

```bash
# 命令行指定
claude --model claude-opus-4-5-20250929

# 配置文件指定
{
  "model": "claude-opus-4-5-20250929"
}

# 环境变量指定
export ANTHROPIC_MODEL=claude-opus-4-5-20250929
```

## MCP 服务器配置

### 文件系统 MCP

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-filesystem"],
      "env": {
        "ALLOWED_PATHS": "/home/user/projects"
      }
    }
  }
}
```

### 数据库 MCP

```json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}
```

## 权限模式

| 模式 | 说明 | 适用场景 |
|------|------|----------|
| `auto` | 自动允许安全操作 | 开发环境 |
| `always` | 每次操作都询问 | 生产环境 |
| `never` | 禁止所有写操作 | 审查/只读场景 |

## 自定义指令

在配置中添加 `customInstructions` 指导 Claude 行为:

```json
{
  "customInstructions": "1. 始终使用 TypeScript\n2. 遵循 Airbnb 代码规范\n3. 为新函数编写 JSDoc\n4. 编写单元测试覆盖边界情况\n5. 使用英文注释和提交信息"
}
```

## 故障排除

### 常见问题

**问题**: API 密钥无效
```bash
# 检查密钥格式
echo $ANTHROPIC_API_KEY | grep -E "^sk-ant-"

# 重新设置密钥
export ANTHROPIC_API_KEY="sk-ant-..."
```

**问题**: 模型不可用
```bash
# 检查模型名称是否正确
claude --model claude-sonnet-4-5-20250929 --version

# 查看可用模型
claude --list-models
```

**问题**: 权限被拒绝
```bash
# 检查配置文件权限
ls -la ~/.claude/config.json

# 修复权限
chmod 600 ~/.claude/config.json
```

### 日志查看

```bash
# 查看最新日志
tail -f ~/.claude/logs/latest.log

# 查看错误日志
grep -i error ~/.claude/logs/*.log
```


path: package.json
content: {
  "name": "claudecode-controller",
  "version": "1.0.0",
  "description": "控制和管理 Claude Code 编码助手，支持项目感知编码、代码审查、重构和功能实现",
  "author": "小龙虾",
  "license": "MIT",
  "keywords": ["claude", "claude-code", "coding", "code-review", "anthropic", "ai-assistant"],
  "repository": {
    "type": "git",
    "url": "https://github.com/sundial-org/awesome-openclaw-skills"
  }
}


path: PUBLISH.md
content: # 发布到 ClawHub 的说明

## 技能信息

- **技能名称**: Claude Code Controller
- **Slug**: claudecode-controller
- **版本**: 1.0.0
- **许可证**: MIT
- **作者**: RocherKong

## 发布步骤

由于 ClawHub CLI 的 `acceptLicenseTerms` 字段存在 bug，请通过 Web 界面发布：

1. 访问 https://clawhub.ai
2. 登录账户 (RocherKong)
3. 点击 "Publish Skill" 或访问 https://clawhub.ai/publish
4. 上传技能文件夹或 ZIP 包
5. 填写以下信息：
   - Name: `Claude Code Controller`
   - Slug: `claudecode-controller`
   - Version: `1.0.0`
   - License: `MIT`
   - Tags: `claude, coding, ai-assistant, code-review, openclaw`
   - Changelog: `初始版本 - 支持 Claude Code 项目感知编码、代码审查、重构和调试`

## 技能文件

技能包位于：
```
/root/.openclaw/workspace/skills/claudecode-controller.skill
```

或上传整个文件夹：
```
/root/.openclaw/workspace/skills/claudecode-controller/
```

## 技能描述

控制和管理 Claude Code 编码助手，支持项目感知编码、代码审查、重构和功能实现。使用 ACP 运行时在隔离会话中执行 Claude Code 任务，或在主会话中管理配置和项目上下文。

## 功能特性

- 项目感知编码
- 代码审查
- 重构辅助
- 功能实现
- 调试帮助
- 文档生成

## 使用方式

安装后，用户可以通过以下方式调用：

```
/claudecode 帮我实现一个用户登录功能，使用 JWT 认证
```

或在项目目录运行：
```bash
./scripts/launch-claudecode.sh /path/to/project claude-sonnet-4-5-20250929 "实现登录功能"
```

## 联系

如有问题，请联系技能作者或在 ClawHub 上提交 issue。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)