概要说明
Snippet 用来保存短命令、Prompt 片段、检查语句和可复用输入模板。内容既可以先插入待输入区继续编辑,也可以在确认安全完整时直接发送。
全局 Snippet 适合跨 Host 使用的通用命令;Project Snippet 则用于仓库专属路径、包过滤条件、Prompt 和操作检查,避免与全局命令混在一起。
适用场景
- 保存 Git 状态、diff、最近提交、分支检查和 staged change 审查等高频命令。
- 在已打开的终端中快速复用定向测试、构建、包过滤、日志追踪、进程检查和健康检查命令。
- 维护代码审查、Bug 排查、测试生成、重构或实现规划等经常发送给 Agent 的 Prompt 模板。
- 保存包含仓库路径、workspace 名称、包目标或服务标识的 Project 专属命令。
- 先把复杂命令放入待输入区,根据当前任务调整参数并检查无误后再执行。
在当前终端中复用高频命令
Agent 会话已经打开时,可直接调用 Git diff、定向测试、日志过滤、进程检查和包管理命令,不必退出终端去聊天记录、备忘录或 Shell 历史中查找。
建立可继续编辑的 Prompt 模板库
保存代码审查、Bug 排查、重构、测试生成和实现规划等重复指令。使用时先插入待输入区,再补充当前文件、错误信息和约束条件,形成针对本次任务的 Prompt。
让仓库细节只出现在对应 Project
把路径、workspace 过滤器、包名称、服务标识和环境专属检查保存为 Project Snippet,避免全局列表被大量只对单个仓库有效的命令占满。
使用流程
- 创建全局或 Project 专属 Snippet。
- 使用易识别的名称,并保存命令或 Prompt 片段。
- 将其插入待输入区,或从终端直接发送。
使用建议
在现有会话中发送短输入时使用 Snippet,执行完整可复用任务时使用 Action。不要在 Snippet 中保存密码、Token 或私钥。