免费在 GitHub 公开

bash-tools

Proper usage of Bash and file operation tools. Use this skill when executing shell commands, writing files, or when tempted to use echo/cat/heredoc to pipe content to files. Prevents permission circumvention patterns like piping multiline content through echo instead of using Write tool. Covers Bash tool, Write tool, Edit tool, and Read tool best practices.

中文简介正在准备中。当前显示原文说明。

kettleofketchup/DraftForge

查看安装方法

包含的文件（7）

SKILL.md3.2 KB
references/bash-tool.md1.9 KB
references/edit-tool.md1.9 KB
references/permission-patterns.md3.2 KB
references/read-tool.md1.8 KB
references/updating-skill.md2.5 KB
references/write-tool.md1.5 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Bash Tools

Guidelines for proper tool selection when executing commands or modifying files.

Core Principle

Use specialized file tools for file operations. Use Bash only for actual shell commands.

Never use Bash to circumvent file operation permissions. If Write tool is blocked, that's intentional - do not work around it with echo, cat, or heredocs.

Tool Selection Decision Tree

Need to create/overwrite a file?
├── YES → Use Write tool (NOT echo/cat/heredoc)
└── NO → Continue...

Need to edit part of a file?
├── YES → Use Edit tool (NOT sed/awk)
└── NO → Continue...

Need to read file contents?
├── YES → Use Read tool (NOT cat/head/tail)
└── NO → Continue...

Need to search file contents?
├── YES → Use Grep tool (NOT grep/rg in Bash)
└── NO → Continue...

Need to find files by pattern?
├── YES → Use Glob tool (NOT find/ls in Bash)
└── NO → Continue...

Is this an actual shell command? (git, npm, docker, make, etc.)
├── YES → Use Bash tool
└── NO → Reconsider - probably need a file tool

Prohibited Patterns

These patterns attempt to circumvent Write tool permissions and MUST NOT be used:

Pattern	Why It's Wrong	Correct Approach
`echo "content" > file.py`	Bypasses Write permissions	Use Write tool
`cat << 'EOF' > file.py`	Heredoc bypasses permissions	Use Write tool
`printf '%s' "$content" > file`	Same as echo bypass	Use Write tool
`tee file.py <<< "content"`	Redirect bypass	Use Write tool

See references/permission-patterns.md for comprehensive examples.

Tool References

Write Tool - Creating and overwriting files
Bash Tool - Running shell commands
Edit Tool - Modifying existing files
Read Tool - Reading file contents

When Write Tool is Blocked

If the Write tool is blocked for a file:

Accept the block - It exists for a reason
Ask the user if they want to allow the operation
Do NOT attempt to use Bash to write the file instead

The permission system protects the user. Circumventing it defeats its purpose.

Updating This Skill

When encountering new permission circumvention patterns or tool usage issues, see references/updating-skill.md.

Quick Reference

Task	Tool	NOT This
Create file	Write	`echo > file`
Edit file	Edit	`sed -i`
Read file	Read	`cat file`
Search content	Grep	`grep pattern`
Find files	Glob	`find . -name`
Git commands	Bash	-
npm/yarn	Bash	-
docker/make	Bash	-
Run tests	Bash	-

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

aesthetic

免费

Create aesthetically beautiful interfaces following proven design principles. Use when building UI/UX, analyzing designs from inspiration sites, generating design images with ai-multimodal, implementing visual hierarchy and color theory, adding micro-interactions, or creating design documentation. Includes workflows for capturing and analyzing inspiration screenshots with chrome-devtools and ai-multimodal, iterative design image generation until aesthetic standards are met, and comprehensive design system guidance covering BEAUTIFUL (aesthetic principles), RIGHT (functionality/accessibility), SATISFYING (micro-interactions), and PEAK (storytelling) stages. Integrates with chrome-devtools, ai-multimodal, media-processing, ui-styling, and web-frameworks skills.

中文简介正在准备中。当前显示原文说明。