HumanLayer Skills 安全指南：permissions 与 concurrency 的正确配置姿势（新手完整教程）
【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills
本文面向想使用HumanLayer Skills的新手，讲解如何在 CI 工作流中正确配置permissions（最小权限）与concurrency（并发控制），让 AI 编码 Agent 安全地自动提 PR，而不失控。
一、HumanLayer Skills 是什么？
HumanLayer Skills 是一组来自 HumanLayer 的Claude Code 技能（Skills），核心能力是帮你在自己的仓库里搭建"智能体控制回路（agentic control loop）"：
| 技能 | 作用 |
|---|---|
design-control-loop | 通过访谈式设计"传感器→控制器→执行器"回路，并生成定时运行的 Agent 工作流 |
narrow-react-prop-types | 自动收窄 React 组件 Prop 类型到真实代码路径 |
improve-claude-md | 用<important if>块重写 CLAUDE.md，提升指令遵循率 |
show-me | 用图表和 HTML 工件讲解当前主题 |
这些技能生成的工作流会在 GitHub Actions 上无人值守运行编码 Agent——Agent 能改代码、能开 PR。因此安全配置（permissions + concurrency）不是可选项，而是必修课。🔐
安装方式（任选其一）：
npx skills add humanlayer/skills --skill design-control-loop # 或克隆仓库 git clone https://gitcode.com/GitHub_Trending/skills53/skills二、为什么这两个配置如此关键？
想象两个 Agent 同时被触发：一个刚开完 PR，另一个又推送分支、又开 PR——你会得到冲突的重复 PR 和翻倍的花费。再看 permissions：如果工作流拿到的GITHUB_TOKEN拥有超出需要的权限，Agent 一旦行为异常，破坏面也会放大。
项目自带的模板已经给出了标准答案，我们直接拆解。👇
三、permissions 最小权限配置：只给 Agent 需要的
workflow-template.yml 中的标准写法：
permissions: contents: write pull-requests: write issues: write三个权限各司其职：
contents: write—— 推送 Agent 分支（开 PR 的前提）pull-requests: write—— 创建和更新 PRissues: write—— 用于/iterate迭代时的 PR 评论
配置要点
- 显式声明，拒绝默认值：不写
permissions时，token 会继承仓库的默认（可能更宽）。 - 只写不读的权限给最小范围：如果 Agent 只读分析、由人工开 PR，
contents甚至可以是read。 - 密钥走 secrets：模板中 API Key 一律通过
${{ secrets.ANTHROPIC_API_KEY }}注入，绝不硬编码（见 agent-runner-templates.md）。
同一套配置在narrow-react-prop-types的完整工作流示例中同样出现，可对照 agent-narrow-component-props.yml。
四、concurrency 并发控制：别让两个 Agent 打架
紧跟着 permissions，模板给出了并发锁（workflow-template.yml）：
concurrency: group: agent-<task-slug> cancel-in-progress: true两个字段怎么理解？
| 字段 | 含义 | 新手建议 |
|---|---|---|
group | 同一 group 内同时只允许一个运行 | 每个任务用独立 slug（如agent-narrow-component-props） |
cancel-in-progress | 新运行触发时取消旧运行 | Agent 任务通常设为true：最新的传感器结果永远比旧的有价值 |
一个反直觉的细节：cancel-in-progress: true配合定时任务时，Agent 正在跑、新一次调度进来，旧运行会被取消——这正是你想要的行为，因为旧运行拿到的测量结果已经过期。
双重保险：PR 流控
并发锁只保证"同时只有一个在跑"，还不够。SKILL.md 的 Phase G（流控） 要求再加一层：定时运行前检查是否已有该回路的开放 PR，有则 no-op。推荐默认值是"每个回路最多一个开放 PR"，防止每天一次的回路堆出一摞没人看的 PR。
五、Agent 权限模式：宽权限只给隔离 Runner
Agent 本体（Claude Code、Codex、OpenCode 等）也有自己的权限开关。模板中 Claude Code 使用了：
claude -p "$PROMPT" --permission-mode bypassPermissionsOpenCode 则用--dangerously-skip-permissions，Codex 用--sandbox danger-full-access——名字听着吓人，项目文档第一行就给了安全前提（agent-runner-templates.md）：
宽权限模式只适用于受信任的隔离 Runner。
给新手的三条实操规则：
- CI 里放宽权限可以，本地开发机别放宽——本地保留逐条确认。
- 加花费护栏：
--max-turns或--max-budget-usd限制单轮预算（参考）。 - 先本地跑通再接入 CI：每个 Agent 命令先手动执行，确认行为符合预期再写进工作流。
六、别忘了人的那道门：/iterate 权限过滤
安全配置还包括"谁能指挥 Agent"。模板在 job 级别的if条件里过滤/iterate评论，只有OWNER、MEMBER、COLLABORATOR的评论才会触发 Agent 迭代（workflow-template.yml）——普通贡献者无法借评论"劫持" Agent 干活。
七、5 点安全自检清单
上线前逐项打勾，30 秒完成自查：✅
| # | 检查项 | 对应配置 |
|---|---|---|
| 1 | 工作流显式声明了permissions且无多余权限 | contents / pull-requests / issues |
| 2 | 有独立concurrency.group且cancel-in-progress: true | 每个任务一个 slug |
| 3 | 定时运行前检查开放 PR 数量（流控） | Phase G no-op 逻辑 |
| 4 | Agent 宽权限模式只跑在隔离 CI Runner 上，并带预算护栏 | bypassPermissions+--max-budget-usd |
| 5 | /iterate仅 OWNER/MEMBER/COLLABORATOR 可触发 | job 级if条件 |
把这份清单和你的 workflow 模板一起存档，每次新增一条 Agent 回路时复制粘贴检查一遍，安全配置就能一直保持"正确姿势"。🚀
【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
