Code Assistant（编程助手 Pro）

面向开发者的超级能力。不止于编写代码：还可进行分析、调试、优化、重构与文档生成。

能力概览

┌─────────────────────────────────────────────────────┐
│                  CODE ASSISTANT                      │
├─────────────────────────────────────────────────────┤
│  🔍 分析        │  发现 bug 和代码异味（code smells）     │
│  ⚡ 优化         │  提升性能与执行效率                    │
│  🔄 重构        │  清理并规范化代码结构                  │
│  📝 文档生成    │  自动生成 docstrings 与 README         │
│  🧪 测试生成    │  创建单元测试                          │
│  🔐 安全检测    │  识别潜在安全漏洞                      │
└─────────────────────────────────────────────────────┘

命令列表

代码分析

# 分析单个文件
code analyze src/utils.ts

# 分析目录（最大深度为 2）
code analyze src/ --depth:2

# 查找特定类型的 bug
code bugs src/api/
code find-bugs src/

# 检查代码复杂度
code complexity src/heavy-function.ts

优化

# 提出优化建议
code optimize src/slow-algorithm.py

# 优化 SQL 查询
code optimize-sql queries/

# 减小打包体积（bundle size）
code optimize-bundle src/

重构

# 重构单个文件
code refactor src/legacy-code.js

# 应用编码规范（如 PEP8、ESLint 规则）
code format src/ --style:pep8

# 提取函数（指定行范围）
code extract-function src/long-file.ts --lines:45-80

文档生成

# 为代码生成 docstrings
code document src/api/

# 为项目生成 README
code readme src/my-project/

# 生成变更日志（changelog）
code changelog --since:v1.0.0

测试

# 生成单元测试
code test-gen src/calculator.ts

# 推荐边界情况（edge cases）
code edge-cases src/validator.py

使用示例

用户: code analyze src/users/auth.ts

Bot: 🔍 正在分析: src/users/auth.ts

     📊 统计指标:
     ├── 行数: 245
     ├── 函数数: 12
     ├── 圈复杂度: 18 ⚠️（偏高）
     └── 文档覆盖率: 30% ⚠️

     🐛 潜在 Bug（2 个）:
     
     1. 第 67 行：竞态条件（Race condition）
        ```typescript
        // ❌ 问题
        if (user) {
          await saveUser(user);  // user 可能在 check 与 save 之间被修改
        }
        ```
        💡 建议方案：使用事务（transaction）或加锁（lock）
     
     2. 第 142 行：SQL 注入（SQL Injection）
        ```typescript
        // ❌ 问题
        query(`SELECT * FROM users WHERE id = ${userId}`)
        ```
        💡 建议方案：改用预处理参数（prepared parameters）

     ⚡ 建议优化项（3 项）:
     
     1. 第 89 行：对高频查找操作，建议使用 Map 替代 Object
     2. 第 156 行：对 getPermissions() 的返回值进行 memoization
     3. 第 201 行：对 crypto 模块启用懒加载（lazy loading）

     🔄 建议重构项:
     
     1. 将 validateToken() 提取至独立模块
     2. 对数据库查询应用 Repository 模式
     
     是否立即执行某项操作？[Documentar] [Refactorizar] [Generar Tests]

支持的语言

与 Coding Agents 集成

可将复杂任务委派给 Codex、Claude Code 或 Pi：

# 使用 Codex 执行重构
code refactor src/legacy.ts --agent:codex

# 使用 Claude 生成文档
code document src/ --agent:claude

配置项

分析规则

该助手可识别以下问题类型：

• Security（安全）: SQL 注入、XSS、路径遍历（path traversal）、硬编码密钥（hardcoded secrets）
• Performance（性能）: N+1 查询、低效循环、内存泄漏（memory leaks）
• Style（风格）: 命名不一致、函数过长、死代码（dead code）
• Logic（逻辑）: 缺失空值检查（null checks）、竞态条件（race conditions）、边界错误（off-by-one errors）

集成能力

• self-repair: 自动修复已发现的 bug
• knowledge-base: 在已索引的文档库中检索相关信息
• expert-researcher: 主动调研行业最佳实践（best practices）