HumanLayer Skills Skill 技能

HumanLayer Skills 是面向 Claude Code 的专业领域扩展技能集，由 HumanLayer 团队出品，汇集了改善 AI 编程质量、提升 Agent 任务执行精度的四大核心技能。所有技能均以斜杠命令形式集成到 Claude Code 会话中，工程师通过 /improve-claude-md、/narrow-react-prop-types 等指令即可调用，无需额外配置复杂工作流。

核心能力

improve-claude-md（CLAUDE.md 优化）：分析项目现有 CLAUDE.md 文件，使用结构化条件块重写指令，使 AI 在正确的上下文场景下自动激活对应规则。解决 CLAUDE.md 变得冗长、指令相互冲突导致的 AI 遵从度下降问题。

narrow-react-prop-types（React Props 收窄）：在 TypeScript + React 项目中，将过于宽泛的 Props 类型（如 any、泛型 T extends object）智能收窄为只覆盖实际代码路径中出现的具体子集。AI 会扫描组件文件，找出所有被真实使用的属性路径，生成精确的类型定义。

build-iterated-agentic-loop（迭代式 Agent 循环构建）：在代码仓库中构建本地 Skill，同时生成配套的迭代式编码 Agent GitHub Actions 工作流、提示词模板、记忆文件和参考模板。适用于需要 AI 持续在后台工作的 DevOps 场景。

design-control-loop（控制环设计）：通过访谈式对话帮助工程师识别代码库中 Agent 行为的四个标准组件——Sensor（传感器）、Controller（控制器）、Actuator（执行器）和 Disturbances（扰动），然后生成对应的本地可运行组件和定时调度配置。

show-me（可视化解释）：用简洁图表、代码形态草图和聚焦 HTML 产物解释当前话题，生成可直接在浏览器中查看的交互式可视化内容。

安装配置

前提条件：Node.js 22 及以上（用于运行 npx）、已安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code）、Git（用于版本管理）。

完整安装：npx skills add humanlayer/skills —— 将全套 5 个技能安装到当前项目 .claude/skills/ 目录。

独立安装单个技能：npx skills add humanlayer/skills --skill（如 npx skills add humanlayer/skills --skill improve-claude-md）。

Claude Code 插件方式：对于 Claude Code 用户，也可从官方插件市场安装（搜索 pascalorg/editor 相关插件流程同理），整个技能集作为托管包自动更新。

使用步骤

在已有 CLAUDE.md 的项目目录中启动 Claude Code，输入 /improve-claude-md，AI 自动分析现有指令并引导优化流程。

对于 React + TypeScript 项目，输入 /narrow-react-prop-types，AI 扫描 src/ 目录并生成精确的 Props 类型定义文件。

需要构建持续工作流时，输入 /build-iterated-agentic-loop，AI 引导访谈后自动生成 .github/workflows/ 配置和记忆文件模板。

需要设计控制环时，输入 /design-control-loop，AI 通过四组件访谈帮助梳理系统边界和调度逻辑。

需要可视化解释任何技术概念时，输入 /show-me，AI 生成 HTML 产物直接渲染到会话中。

适用场景

提升大型项目中 Claude Code 的指令遵从度，解决 AI 忽视关键规则的难题。

重构 TypeScript + React 代码库，获得精确到实际调用路径的 Props 类型，排除 mock/test-only 类型覆盖盲区。

为代码库搭建 AI 持续工作流，将人工监督的 Agent 任务嵌入 GitHub Actions 实现自动化。

设计面向复杂业务系统的 AI Agent 调度架构，梳理传感器、控制器和扰动因素的系统边界。

适用人群

使用 Claude Code 的专业软件工程师、TypeScript/React 开发者、DevOps 工程师、AI 编程工具研究者。

工作原理

HumanLayer Skills 基于 CLAUDE.md 条件块机制和 MCP 协议。improve-claude-md 通过解析现有 CLAUDE.md 的指令结构，识别互斥规则并重新编排为场景化条件块；narrow-react-prop-types 利用 TypeScript 编译器 API 遍历 AST 并与实际运行路径交叉验证，生成精确子集类型；build-iterated-agentic-loop 将 GitHub Actions 的触发条件和 Claude Code 的 /cl:* 命令语义对齐，生成可在任意代码仓库复用的配置文件；design-control-loop 则将控制论四组件映射到代码库的 CI 监控点和 git 操作记录，形成闭环反馈系统。

官方链接 安装指引：https://skills.sh/humanlayer/skills GitHub 仓库：https://github.com/humanlayer/skills HumanLayer 官网：https://humanlayer.dev