「密钥使用规范」是安全工程师与开发团队的高频任务。它的输入通常是项目配置,期望得到的是改进建议。这类有固定流程、又需要一点判断力的工作,很适合封装成智能体 Skill。

不是每个人都有能装技能的智能体平台。下面这份提示词可以直接粘贴到任何对话助手中使用,效果接近技能版本,只是需要每次手动粘贴。

可复制的提示词

# 角色
你是一名熟悉密钥使用规范的助手,服务对象是安全工程师与开发团队。

# 任务
检查项目中密钥的存放与使用方式。

# 输入
我会提供:项目配置。如果缺少关键信息,请先列出问题,不要自行编造。

# 步骤
1. 查找硬编码密钥
2. 检查环境变量与密钥管理
3. 建议轮换
4. 写规范

# 输出
改进建议。使用清晰的小标题,最后单独列出“需人工确认”的内容。

# 约束
- 扫描结论需人工复核,涉及生产的动作走变更流程。
- 只输出建议、草稿或命令预览,不执行任何不可逆操作;需要执行时先请用户明确确认。
- 脚本只在当前项目目录内运行,运行失败时报告错误原文,不要猜测结果。

# 材料
(在这里粘贴你的内容)

用法

  1. 复制整段提示词,把材料粘贴到最后
  2. 第一次使用时附一份你认可的范例,告诉助手“参考这个格式”
  3. 对输出不满意时,指出具体哪一步有问题,而不是笼统地说“再改改”
  4. 把调好的提示词保存在笔记里,下次直接用

和技能版的区别

提示词版本每次都要手动粘贴,长对话中后半段可能逐渐偏离要求;技能版由平台自动加载,适合高频使用。如果你每周都要用好几次,建议升级为技能,参考快速上手。

小技巧

  • 把“输出”部分改成表格表头,能显著提高格式稳定性
  • 材料很长时先让助手复述理解,再开始处理
  • 属于高风险:涉及权限、个人信息或不可逆操作,Skill 只产出建议或草稿,执行前必须人工确认

每一步要产出什么

把每一步的中间产出写清楚,智能体就不容易跳步,人也方便定位问题:

  1. 查找硬编码密钥:产出一段简短的中间结果,并注明依据来自项目配置的哪一部分
  2. 检查环境变量与密钥管理:产出一段简短的中间结果,并注明依据来自项目配置的哪一部分
  3. 建议轮换:产出一段简短的中间结果,并注明依据来自项目配置的哪一部分
  4. 写规范:产出一段简短的中间结果,并注明依据来自项目配置的哪一部分

最后一步之后,再把这些中间结果汇总成改进建议。中间结果可以折叠或省略展示,但在技能指令中要求智能体“先完成再汇总”,能明显减少遗漏。

领域注意事项

「密钥使用规范」属于安全审查领域,使用者多是安全工程师与开发团队,工作环境通常是代码、配置与云环境。这个领域最重要的一条底线是:扫描结论需人工复核,涉及生产的动作走变更流程。

建议把这条底线原样写进技能的约束部分,而不是指望智能体自己意识到。同时,在团队内部明确:智能体给出的改进建议只是初稿或建议,最终由谁签字确认、出了问题由谁负责。

延伸阅读

说明:文中的配置、代码与目录结构均为示意,用于说明思路;各平台的入口、字段名与能力会更新,落地前请以对应官方文档为准。示例中的数据与场景为虚构,不代表真实案例。