Skill bash-style
Enforces coding standards for Bash scripts, Dockerfiles, Makefiles, and YAML files to ensure readability and security.
- Estrellas en GitHub
- 1061
- Archivos
- 1
- Último commit
- 26 ago 2026
- Licencia
- —
- Herramientas permitidas
- —
¿Qué hace la skill bash-style?
Enforces coding standards for Bash scripts, Dockerfiles, Makefiles, and YAML files to ensure readability and security.
Resumen generado a partir del SKILL.md de la skill.
Cómo instalar la skill bash-style
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill bash-style en Plugin
/plugin marketplace add doccker/cc-use-exp /plugin install cc-use-exp@cc-use-exp
Instalar la skill bash-style en Claude Code
~/.claude/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style ~/.claude/skills/bash-styleInstalar la skill bash-style en Claude Code (project)
.claude/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style .claude/skills/bash-styleInstalar la skill bash-style en Codex
~/.agents/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style ~/.agents/skills/bash-styleInstalar la skill bash-style en Gemini CLI
~/.gemini/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style ~/.gemini/skills/bash-styleInstalar la skill bash-style en Claude.ai
npx degit doccker/cc-use-exp/skills/bash-style bash-style && zip -r bash-style.zip bash-style # claude.ai → Customize → Skills → + → Create skill → Upload a skill → bash-style.zip
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún sin verificar. Una skill necesita 80 puntos, ningún hallazgo grave y datos suficientes para comprobarla. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibledoccker/cc-use-exp/skills/bash-style is public and reachablegithub.com/doccker/cc-use-exp/tree/HEAD/skills/bash-style ↗Aprobado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit 2026-08-26github.com/doccker/cc-use-exp/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/doccker/cc-use-exp/blob/HEAD/skills/bash-style/SK ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/doccker/cc-use-exp/blob/HEAD/skills/bash-style/SK ↗Aprobado
- SKILL.md sigue el formato de Agent Skillsthe description does not say when to use the skillgithub.com/doccker/cc-use-exp/blob/HEAD/skills/bash-style/SK ↗Hallazgo
SKILL.md
Ver en GitHubBash 编写规范
版本:v1.0 更新:2026-01
1. 注释规范
禁止行尾注释
- ❌ 禁止行尾注释(如
command # 注释) - ✅ 注释应独占一行,放在代码上方
适用范围:
- Shell 脚本文件(.sh)
- Markdown 文档中的 bash 代码块
- Dockerfile、Makefile 中的 shell 命令
# ❌ 错误:行尾注释
curl -X POST https://api.example.com/data # 发送请求
docker run -d nginx # 启动容器
cp -r src/ dist/ # 复制文件
# ✅ 正确:注释独占一行
# 发送请求
curl -X POST https://api.example.com/data
# 启动容器
docker run -d nginx
# 复制文件
cp -r src/ dist/
原因:
- 复制粘贴时容易带上注释导致命令出错
- 长命令 + 注释 = 超长行,可读性差
- Heredoc 块内
#不是注释而是内容
2. 文件写入方式
推荐方式:tee 命令
# ✅ 推荐:简洁、无嵌套引号
sudo tee /etc/fail2ban/jail.d/docker-nginx.local > /dev/null << 'EOF'
[docker-nginx]
enabled = true
filter = docker-nginx
logpath = /var/log/nginx/access.log
maxretry = 5
EOF
追加内容
# ✅ 追加到文件
sudo tee -a /etc/hosts > /dev/null << 'EOF'
192.168.1.100 myserver
EOF
# ✅ 单行追加
echo '192.168.1.100 myserver' | sudo tee -a /etc/hosts
避免的写法
# ❌ 避免:嵌套引号复杂,易出错
sudo bash -c 'cat > /etc/xxx << EOF
content
EOF'
# ❌ 避免:需要转义内容中的特殊字符
sudo sh -c "echo 'line1\nline2' > /etc/xxx"
方式对比
| 方式 | 优点 | 缺点 | 推荐场景 |
|---|---|---|---|
sudo tee |
简洁、无嵌套 | 需 > /dev/null 抑制输出 |
首选 |
sudo bash -c 'cat >' |
无需 tee | 嵌套引号复杂 | 不推荐 |
| 临时文件 + mv | 可先验证 | 步骤多 | 复杂配置 |
3. Heredoc 引号规则
禁止变量展开(推荐默认)
# ✅ 'EOF' 带引号:内容原样输出,不解析变量
sudo tee /etc/xxx > /dev/null << 'EOF'
$HOME 不会被展开
$(command) 不会被执行
EOF
需要变量展开
# EOF 不带引号:变量会被展开
sudo tee /etc/xxx > /dev/null << EOF
当前用户: $USER
当前目录: $(pwd)
EOF
选择原则
| 场景 | 用法 | 原因 |
|---|---|---|
| 配置文件 | << 'EOF' |
避免意外展开 |
| 模板生成 | << EOF |
需要插入变量 |
| 不确定时 | << 'EOF' |
更安全 |
4. 权限与路径
需要 root 权限
# ✅ 正确:tee 配合 sudo
echo 'content' | sudo tee /etc/xxx
# ❌ 错误:重定向在 sudo 之外,权限不足
sudo echo 'content' > /etc/xxx
路径带空格
# ✅ 正确:双引号包裹路径
sudo tee "/etc/my config/file.conf" > /dev/null << 'EOF'
content
EOF
5. 脚本规范
文件头
#!/usr/bin/env bash
set -euo pipefail
# 脚本说明(一句话)
set 选项说明
| 选项 | 作用 |
|---|---|
-e |
命令失败时退出 |
-u |
使用未定义变量时报错 |
-o pipefail |
管道中任一命令失败则整体失败 |
变量使用
# ✅ 推荐:使用 ${} 包裹
echo "Hello, ${name}"
# ✅ 推荐:设置默认值
db_host="${DB_HOST:-localhost}"
# ❌ 避免:裸变量(易与后续字符混淆)
echo "Hello, $name_suffix"
6. 常用模式
检查命令是否存在
if ! command -v docker &> /dev/null; then
echo "docker 未安装"
exit 1
fi
检查文件/目录
# 文件存在
[[ -f /path/to/file ]] && echo "文件存在"
# 目录存在
[[ -d /path/to/dir ]] || mkdir -p /path/to/dir
安全删除
# ✅ 使用变量时防止误删
rm -rf "${dir:?}"/*
# ❌ 危险:变量为空时会删除根目录
rm -rf $dir/*
7. 文档中的代码块
在 Markdown 文档中编写 bash 命令时,同样遵循以上规范:
## 安装配置
创建配置文件:
```bash
sudo tee /etc/myapp/config.yml > /dev/null << 'EOF'
server:
port: 8080
host: 0.0.0.0
EOF
```
参考资料
Archivos de esta skill
1Preguntas sobre la skill bash-style
¿Cómo instalo la skill bash-style en Claude Code?
Ejecuta npx degit doccker/cc-use-exp/skills/bash-style ~/.claude/skills/bash-style. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill bash-style?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
How should comments be placed in Bash scripts?
Comments should be placed on their own line above the code rather than at the end of a command.
How can I prevent variable expansion when using Heredoc?
Wrap the EOF delimiter in single quotes to output the content exactly as written without parsing variables.
What is the recommended way to write files with sudo?
Use the tee command with sudo to avoid the complexity and errors associated with nested quotes.