Code Assistant (Asistente de Programación Pro)
Una super-habilidad para desarrolladores. Va más allá de escribir código: analiza, depura, optimiza, refactoriza y documenta.
Capacidades
CODEBLOCK0
Comandos
Análisis de Código
CODEBLOCK1
Optimización
CODEBLOCK2
Refactorización
CODEBLOCK3
Documentación
CODEBLOCK4
Tests
CODEBLOCK5
Ejemplo de Uso
CODEBLOCK6 typescript
// ❌ Problema
if (user) {
await saveUser(user); // user puede cambiar entre check y save
}
💡 Solución: Usar transacción o lock
2. Línea 142: SQL Injection
typescript
// ❌ Problema
query(
SELECT * FROM users WHERE id = ${userId})
CODEBLOCK8
Lenguajes Soportados
| Lenguaje | Análisis | Docs | Tests |
|---|
| TypeScript/JavaScript | ✅ | ✅ | ✅ |
| Python |
✅ | ✅ | ✅ |
| Go | ✅ | ✅ | ✅ |
| Rust | ✅ | ✅ | ⚠️ |
| Java | ✅ | ✅ | ✅ |
| C/C++ | ⚠️ | ⚠️ | ⚠️ |
Integración con Coding Agents
Puede delegar tareas complejas a Codex, Claude Code o Pi:
CODEBLOCK9
Configuración
| Variable | Descripción | Default |
|---|
| INLINECODE1 | Estilo de código | INLINECODE2 |
| INLINECODE3 |
Umbral de complejidad |
15 |
|
CODE_AUTO_FIX | Aplicar fixes automáticamente |
false |
|
CODE_IGNORE_PATTERNS | Patrones a ignorar |
node_modules,dist |
Reglas de Análisis
El asistente detecta:
- - Security: SQL injection, XSS, path traversal, hardcoded secrets
- Performance: N+1 queries, loops ineficientes, memory leaks
- Style: Nombres inconsistentes, funciones largas, código muerto
- Logic: Null checks faltantes, race conditions, off-by-one errors
Integración
- - self-repair: Los bugs encontrados pueden auto-corregirse
- knowledge-base: Busca en documentación indexada
- expert-researcher: Investiga mejores prácticas
代码助手 (专业编程助手)
面向开发者的超级技能。不仅限于编写代码:还能分析、调试、优化、重构和编写文档。
能力概览
┌─────────────────────────────────────────────────────┐
│ 代码助手 │
├─────────────────────────────────────────────────────┤
│ 🔍 分析 │ 发现缺陷和代码坏味道 │
│ ⚡ 优化 │ 提升性能和效率 │
│ 🔄 重构 │ 清理和结构化代码 │
│ 📝 文档 │ 生成文档字符串和README │
│ 🧪 测试 │ 创建单元测试 │
│ 🔐 安全 │ 检测漏洞 │
└─────────────────────────────────────────────────────┘
命令
代码分析
分析文件
code analyze src/utils.ts
分析目录
code analyze src/ --depth:2
查找特定缺陷
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/
减少打包体积
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
文档
生成文档字符串
code document src/api/
创建README
code readme src/my-project/
生成变更日志
code changelog --since:v1.0.0
测试
生成单元测试
code test-gen src/calculator.ts
建议边界情况
code edge-cases src/validator.py
使用示例
用户: code analyze src/users/auth.ts
机器人: 🔍 分析文件: src/users/auth.ts
📊 指标:
├── 行数: 245
├── 函数数: 12
├── 圈复杂度: 18 ⚠️ (过高)
└── 文档覆盖率: 30% ⚠️
🐛 潜在缺陷 (2个):
1. 第67行: 竞态条件
typescript
// ❌ 问题
if (user) {
await saveUser(user); // user在检查与保存之间可能发生变化
}
💡 解决方案: 使用事务或锁
2. 第142行: SQL注入
typescript
// ❌ 问题
query(SELECT * FROM users WHERE id = ${userId})
💡 解决方案: 使用参数化查询
⚡ 建议优化 (3项):
1. 第89行: 对频繁查找使用Map替代Object
2. 第156行: 对getPermissions()结果进行缓存
3. 第201行: 对crypto模块进行懒加载
🔄 建议重构:
1. 将validateToken()提取到独立模块
2. 对查询应用Repository模式
是否执行操作?[生成文档] [重构] [生成测试]
支持的语言
| 语言 | 分析 | 文档 | 测试 |
|---|
| TypeScript/JavaScript | ✅ | ✅ | ✅ |
| Python |
✅ | ✅ | ✅ |
| Go | ✅ | ✅ | ✅ |
| Rust | ✅ | ✅ | ⚠️ |
| Java | ✅ | ✅ | ✅ |
| C/C++ | ⚠️ | ⚠️ | ⚠️ |
与编码代理集成
可将复杂任务委托给Codex、Claude Code或Pi:
使用Codex进行重构
code refactor src/legacy.ts --agent:codex
使用Claude生成文档
code document src/ --agent:claude
配置
| 变量 | 描述 | 默认值 |
|---|
| CODEDEFAULTSTYLE | 代码风格 | auto |
| CODEMAXCOMPLEXITY |
复杂度阈值 | 15 |
| CODE
AUTOFIX | 自动应用修复 | false |
| CODE
IGNOREPATTERNS | 忽略模式 | node_modules,dist |
分析规则
助手可检测:
- - 安全: SQL注入、XSS、路径遍历、硬编码密钥
- 性能: N+1查询、低效循环、内存泄漏
- 风格: 命名不一致、函数过长、死代码
- 逻辑: 缺少空值检查、竞态条件、差一错误
集成
- - self-repair: 发现的缺陷可自动修复
- knowledge-base: 搜索索引文档
- expert-researcher: 研究最佳实践