humanlayer/skills

技能简介 humanlayer/skills 是由 HumanLayer 团队推出的一套 Claude Code 专用 Skills 合集，专门解决 AI 编程助手在真实项目中的两大核心难题：指令遵循度不足和代码上下文不精准。这套 Skills 源自 HumanLayer 在"上下文工程"（Context Engineering）领域的深度积累，被认为是当前最实用的 Claude Code 技能包之一。 核心能力 CLAUDE.md 指令优化 通过 语法块重写项目的 CLAUDE.md 文件，让 Claude Code 更精准地识别关键约束条件，显著提升指令遵循率。 React Props 类型收窄 将组件的 Props 类型从 Storybook、测试或 mock 场景中解放出来，自动收窄为仅匹配真实代码执行路径的类型，减少 AI 生成的类型错误。 迭代式 Agent 循环构建 自动在代码仓库中创建本地 Skill，并配套生成 GitHub Actions 工作流、Prompt 模板、记忆文件和参考文档，实现可持续迭代的 Agent 开发闭环。 控制环设计 通过对话引导工程师设计针对特定代码库的 Agent 控制环（传感器、控制器、执行器、扰动），并将其落地为本地可运行组件加上定时 Agent 工作流。 架构图生成 以简洁的架构图、代码形态草图和 HTML Artifacts 形式解释当前主题，帮助团队快速对齐技术理解，适合技术方案评审和新人 onboarding。 Agentic 测试用例生成 为复杂代码路径自动生成 Agent 可理解的测试用例，涵盖边界条件和异常场景，降低回归风险。 安装配置 前置要求 Claude Code 已安装并完成基础配置；Node.js 18+ 环境。 安装命令 npx skills add humanlayer/skills --skill SKILLNAME 其中 SKILLNAME 为具体技能名，可选值包括 improve-claude-md、narrow-react-prop-types、build-iterated-agentic-loop、design-control-loop、explain-with-artifacts 等。 CLAUDE.md 优化技能安装 npx skills add humanlayer/skills --skill improve-claude-md 安装后，在项目目录下运行 /improve-claude-md，Agent 会自动分析并重写 CLAUDE.md 文件。 迭代 Agent 循环技能安装 npx skills add humanlayer/skills --skill build-iterated-agentic-loop 安装后运行 /build-iterated-agentic-loop，根据项目情况定制 Agent 循环架构。 使用步骤 第一步：在项目中安装 Skills 进入项目目录，运行安装命令添加所需技能，例如： npx skills add humanlayer/skills --skill improve-claude-md 第二步：运行优化指令 在 Claude Code 中执行对应指令： /improve-claude-md Agent 会分析当前 CLAUDE.md 并用 语法块重构，提升指令精准度。 第三步：验证优化效果 在后续对话中观察 Claude Code 对约束条件的遵循程度，若仍有偏差，可继续手动调整 块内容。 第四步：构建迭代 Agent 循环 安装 build-iterated-agentic-loop 后运行： /build-iterated-agentic-loop Agent 会在本地创建 Skill 文件、GitHub Actions 工作流和参考模板，形成可持续演进的开发闭环。 第五步：集成到 CI/CD 生成的 GitHub Actions 工作流可直接加入仓库的 .github/workflows/ 目录，实现每次代码提交自动触发 Agent 循环验证。 适用场景 大型前端项目 React 项目中组件 Props 类型繁多，AI 生成的代码常因类型不匹配而报错，narrow-react-prop-types 可有效解决此问题。 多成员协作代码库 不同成员的代码风格和项目规范各异，通过 improve-claude-md 统一 Claude Code 的行为预期，减少 AI 生成的代码风格不一致问题。 复杂 Agent 系统开发 需要构建可控、可迭代的 Agent 工作流时，build-iterated-agentic-loop 提供标准化起点，避免每次从零设计。 技术方案评审 用 explain-with-artifacts 生成架构图和代码草图，在评审会议中直观展示技术方案，降低沟通成本。 代码库知识传递 新人 onboarding 时，通过 Agent 生成项目特化的代码解释和Artifacts，快速建立对代码库的理解。 适用人群 AI 编程深度用户 已掌握 Claude Code 基础用法，希望在真实项目中提升 AI 输出质量，需要针对具体痛点的精准解决方案。 前端工程师 处理 React/Vue 等前端框架的复杂组件时，需要 AI 生成更精准的代码和类型，减少调试时间。 DevOps / 平台工程师 需要构建可控的 Agent 自动化工作流，并将其嵌入企业现有的 CI/CD 体系，对 Agent 行为有治理需求。 技术负责人 / 架构师 关注团队整体 AI 编程效率，需要标准化 Agent 开发流程，建立可审计、可迭代的 Agent 工程实践。 工作原理 humanlayer/skills 的每个技能都是一个独立的 Claude Code Skill 模块，内含详细的指令模板和执行逻辑。以 improve-claude-md 为例：它会读取项目现有的 CLAUDE.md 文件，分析其中指令的模糊程度，然后利用 块语法重写关键约束。 是 HumanLayer 提出的一种指令标注格式，通过"在某某条件下，必须如何"的明确句式，让 Claude Code 在执行时精确判断约束是否适用，从根本上减少"忽略次要指令"的问题。其他技能如 build-iterated-agentic-loop 则在仓库中创建完整的文件结构和工作流配置，用标准化模板降低 Agent 系统的搭建门槛。 官方链接 官方主页：https://humanlayer.dev GitHub 仓库：https://github.com/humanlayer/skills