当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
FreePublished on GitHub
bash-style
Bash 脚本与系统命令规范。禁止行尾注释，强制使用 tee/heredoc 写入，提升命令执行的可维护性。
The English summary is being prepared. Showing the original description.
See how to installFiles included (1)
- SKILL.md1.2 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
<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...）。
</instructions>📋 本回复遵循：
bash-style- [章节]
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
当设计或修改 REST API 响应结构、处理 API 返回值，或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义，以及生成产物时关键字段缺失但静默成功的问题。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
api-proxy-safety
Free网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范，防止纯子串匹配误判正常响应内容中的技术术语（如 Cloudflare、502、error）
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
当 API/任务可能执行超过 10 秒（批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合）时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
bash-style
Free当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件，或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
bash-style
FreeBash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件， 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026