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 只读分析、由人工开 PRcontents甚至可以是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.ymlconcurrency: group: agent-task-slug cancel-in-progress: true两个字段怎么理解字段含义新手建议group同一 group 内同时只允许一个运行每个任务用独立 slug如agent-narrow-component-propscancel-in-progress新运行触发时取消旧运行Agent 任务通常设为true最新的传感器结果永远比旧的有价值一个反直觉的细节cancel-in-progress: true配合定时任务时Agent 正在跑、新一次调度进来旧运行会被取消——这正是你想要的行为因为旧运行拿到的测量结果已经过期。双重保险PR 流控并发锁只保证同时只有一个在跑还不够。SKILL.md 的 Phase G流控 要求再加一层定时运行前检查是否已有该回路的开放 PR有则 no-op。推荐默认值是每个回路最多一个开放 PR防止每天一次的回路堆出一摞没人看的 PR。五、Agent 权限模式宽权限只给隔离 RunnerAgent 本体Claude Code、Codex、OpenCode 等也有自己的权限开关。模板中 Claude Code 使用了claude -p $PROMPT --permission-mode bypassPermissionsOpenCode 则用--dangerously-skip-permissionsCodex 用--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 / issues2有独立concurrency.group且cancel-in-progress: true每个任务一个 slug3定时运行前检查开放 PR 数量流控Phase G no-op 逻辑4Agent 宽权限模式只跑在隔离 CI Runner 上并带预算护栏bypassPermissions--max-budget-usd5/iterate仅 OWNER/MEMBER/COLLABORATOR 可触发job 级if条件把这份清单和你的 workflow 模板一起存档每次新增一条 Agent 回路时复制粘贴检查一遍安全配置就能一直保持正确姿势。【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考