Agent skill

bash-style

Bash 脚本与系统命令规范。禁止行尾注释,强制使用 tee/heredoc 写入,提升命令执行的可维护性。

Stars 424
Forks 44

Install this agent skill to your Project

npx add-skill https://github.com/doccker/cc-use-exp/tree/main/.gemini/skills/bash-style

SKILL.md

Bash 与系统命令规范

参考来源: Google Shell Style Guide


🚫 严格禁止

1. 禁止行尾注释

  • curl -X POST ... # 发送请求
  • ✅ 注释必须独占一行,放在代码上方

2. 禁止隐式路径

  • rm test.txt
  • ✅ 优先使用变量或绝对路径:rm "${WORK_DIR}/test.txt"

🛠️ 脚本编写原则

  • 防御性头声明:所有 .sh 文件首行必须包含 set -euo pipefail
  • 变量引用:必须为所有变量引用加双引号("${VAR}"),防止空格溢出。
  • 安全写入:禁止在大段脚本中使用 cat <<EOF > file。优先使用 write_file (工具) 或分步 tee 写入。
bash
# ✅ 良好的脚本头
#!/usr/bin/env bash
set -euo pipefail

💻 命令输出与日志

  • 复杂命令必须使用 tee -a "${LOG_FILE}" 同时记录到屏幕和日志。
  • 循环操作必须打印当前进度索引(如 [1/50] Processing...)。

📋 本回复遵循:bash-style - [章节]

Expand your agent's capabilities with these related and highly-rated skills.

doccker/cc-use-exp

ops-safety

运维安全规范。当用户执行系统级命令(sysctl、iptables、systemctl、Docker 配置、数据库 DDL) 或进行服务器运维操作时触发。 包含命令风险说明模板、回滚方案要求、问题排查原则、Docker/Cloudflare/数据库场景规则等。

424 44
Explore
doccker/cc-use-exp

ruanzhu

当用户执行 /ruanzhu 命令或请求生成软著源代码文档时触发。提供软著源代码 DOCX 生成规范。 覆盖项目信息检测、语言扫描规则、页数控制、DOCX 格式规范等。

424 44
Explore
doccker/cc-use-exp

ui-ux-pro-max

专业级 UI/UX 设计规范,需要高质量界面设计时手动触发或描述"设计感/专业UI"时自动触发。 覆盖视觉层次、配色体系、排版节奏、交互微动效、响应式适配等。 日常前端开发由 frontend-dev skill 覆盖。

424 44
Explore
doccker/cc-use-exp

bash-style

Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件, 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。

424 44
Explore
doccker/cc-use-exp

redis-safety

Redis 安全与性能规范。当用户操作 Redis 相关代码(go-redis、Jedis、redis-py、ioredis)时触发。 包含禁止 KEYS 命令、SCAN 替代、大 key 控制、Pipeline 批量、TTL 规范等。

424 44
Explore
doccker/cc-use-exp

python-dev

Python 开发规范。当用户操作 .py、pyproject.toml、requirements.txt、setup.py 文件, 或涉及 FastAPI、Django、Flask、pytest、asyncio 开发时触发。 包含 PEP 8 风格、类型注解、异常处理、测试规范、异步编程、性能优化等。

424 44
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results