bash-style Skill
Enforces coding standards for Bash scripts, Dockerfiles, Makefiles, and YAML files to ensure readability and security.
- GitHub Stars
- 1.061
- Dateien
- 1
- Letzter Commit
- 26. Aug. 2026
- Lizenz
- —
- Erlaubte Tools
- —
Was macht der bash-style Skill?
Enforces coding standards for Bash scripts, Dockerfiles, Makefiles, and YAML files to ensure readability and security.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
So installierst du den bash-style Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den bash-style Skill in Plugin installieren
/plugin marketplace add doccker/cc-use-exp /plugin install cc-use-exp@cc-use-exp
Den bash-style Skill in Claude Code installieren
~/.claude/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style ~/.claude/skills/bash-styleDen bash-style Skill in Claude Code (project) installieren
.claude/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style .claude/skills/bash-styleDen bash-style Skill in Codex installieren
~/.agents/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style ~/.agents/skills/bash-styleDen bash-style Skill in Gemini CLI installieren
~/.gemini/skills/bash-style/SKILL.md
$ npx degit doccker/cc-use-exp/skills/bash-style ~/.gemini/skills/bash-styleDen bash-style Skill in Claude.ai installieren
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
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Skill braucht 80 Punkte, keinen schweren Befund und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbardoccker/cc-use-exp/skills/bash-style is public and reachablegithub.com/doccker/cc-use-exp/tree/HEAD/skills/bash-style ↗Bestanden
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrLast commit 2026-08-26github.com/doccker/cc-use-exp/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/doccker/cc-use-exp/blob/HEAD/skills/bash-style/SK ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/doccker/cc-use-exp/blob/HEAD/skills/bash-style/SK ↗Bestanden
- SKILL.md folgt dem Agent-Skills-Formatthe description does not say when to use the skillgithub.com/doccker/cc-use-exp/blob/HEAD/skills/bash-style/SK ↗Befund
SKILL.md
Auf GitHub ansehenBash 编写规范
版本: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
```
参考资料
Dateien in diesem Skill
1bash-style Skill-Fragen
Wie installiere ich den bash-style Skill in Claude Code?
Führe npx degit doccker/cc-use-exp/skills/bash-style ~/.claude/skills/bash-style aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den bash-style Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
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.