>- Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件, 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。
npx skills add https://github.com/doccker/cc-use-exp --skill bash-style
command # 注释)# ❌ 错误:行尾注释
curl -X POST https://api.example.com/data # 发送请求
# ✅ 正确:注释独占一行
# 发送请求
curl -X POST https://api.example.com/data
# ✅ 推荐:简洁、无嵌套引号
sudo tee /etc/myapp/config.yml > /dev/null << 'EOF'
server:
port: 8080
EOF
| 方式 | 优点 | 缺点 | 推荐场景 |
|------|------|------|---------|
| sudo tee | 简洁、无嵌套 | 需 > /dev/null 抑制输出 | 首选 |
| sudo bash -c 'cat >' | 无需 tee | 嵌套引号复杂 | 不推荐 |
| 场景 | 用法 | 原因 |
|------|------|------|
| 配置文件 | << 'EOF' | 避免意外展开 |
| 模板生成 | << EOF | 需要插入变量 |
| 不确定时 | << 'EOF' | 更安全 |
# ✅ 正确:tee 配合 sudo
echo 'content' | sudo tee /etc/xxx
# ❌ 错误:重定向在 sudo 之外,权限不足
sudo echo 'content' > /etc/xxx
#!/usr/bin/env bash
set -euo pipefail
| 选项 | 作用 |
|------|------|
| -e | 命令失败时退出 |
| -u | 使用未定义变量时报错 |
| -o pipefail | 管道中任一命令失败则整体失败 |
# ✅ 推荐:使用 ${} 包裹
echo "Hello, ${name}"
db_host="${DB_HOST:-localhost}"
# ❌ 避免:裸变量
echo "Hello, $name_suffix"
# 检查命令是否存在
if ! command -v docker &> /dev/null; then
echo "docker 未安装"
exit 1
fi
# 安全删除
rm -rf "${dir:?}"/*
Take doccker/cc-use-exp-.cursor-bash-style from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.