本文へ移動
cccskills
無料GitHub で公開

bash-style

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

インストール方法を見る

含まれるファイル(1)

  • SKILL.md1.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

<instructions>

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 写入。
# ✅ 良好的脚本头
#!/usr/bin/env bash
set -euo pipefail

💻 命令输出与日志

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

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

</instructions>

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0652026年8月26日 更新

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0652026年8月26日 更新

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0652026年8月26日 更新

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0652026年8月26日 更新

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0652026年8月26日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0652026年8月26日 更新

doccker のスキルをすべて見る

このスキルの問題を報告する