> 功能说明: 本技能涵盖 化工作流场景 等核心能力。

ai-assistant Code Ru

专业版专属特性

轻松上手

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

应用场景

1. Automated Code Review

result = run_claude_code(
    workdir='/root/repo/project',
    prompt='Review this codebase and identify potential bugs or improvements'
)

2. Refactoring Tasks

result = run_claude_code(
    workdir='/root/repo/legacy-app',
    prompt='Refactor the database layer to use SQLAlchemy ORM instead of raw SQL'
)

核心能力(补充)

result = run_claude_code(
    workdir='/root/repo/api-service',
    prompt='''
    Add a new REST endpoint for user profile management:
    - GET /api/users/{id}/profile
    - PUT /api/users/{id}/profile
    - Include validation and error handling
    - Add unit tests
    '''
)

4. Bug Fixes

result = run_claude_code(
    workdir='/root/repo/web-app',
    prompt='Fix the memory leak in the WebSocket connection handler'
)

输入参数

响应格式

{
  "success": true,
  "data": {
    "result": "处理结果",
    "status": "success",
    "metadata": {
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

安装与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(ai-assistant Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

限制条件

• Requires Unix-like environment (uses PTY)
• Requires root/sudo for user switching
• ai-assistant Code must be installed separately
• May not handle all edge cases of interactive prompts

差异化分析

效率提升量化分析

差异化对比

核心痛点解决

常见问题FAQ

Q1: Claude代码运行器支持哪些编程语言？

A: Claude代码运行器支持多种编程语言，包括但不限于Python、Java、JavaScript、C++等，具体支持情况请参考官方文档。

Q2: Claude代码运行器如何处理非TTY环境？

A: Claude代码运行器通过PTY调用Claude Code执行编程任务，确保在非TTY环境下也能正常运行。

Q3: Claude代码运行器如何保证代码质量？

A: Claude代码运行器提供代码静态分析与质量评分功能，帮助开发者及时发现并修复代码中的问题。

Q4: Claude代码运行器如何与其他工具集成？

A: Claude代码运行器支持CI/CD流水线集成，方便与其他开发工具协同工作。

Q5: Claude代码运行器是否支持批量代码审查？

A: 是的，Claude代码运行器支持批量代码审查与报告生成，提高代码审查效率。

安全建议

1. 确保运行环境安全，避免未授权访问。
2. 对敏感信息进行加密处理，防止泄露。
3. 定期更新依赖库，修复已知漏洞。
4. 限制技能的访问权限，防止滥用。
5. 监控技能运行状态，及时发现并处理异常情况。

安全风险防范

错误恢复方案

针对Claude代码运行器使用中可能遇到的常见问题,提供以下排查方案:

Claude代码运行器通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块