使用编码 Agent 技能

使用 skills/ 中的 SKILL.md 工作流了解项目、创建项目,开发、安装和卸载模块,添加页面,配置服务商并部署。

skills/ 是给维护本仓库或其衍生项目的编码助手使用的工作流。它们不是可选 /app/agent 运行时使用的 agent-skills/ 发布包。后者见 Agent 模板和 Agent 运行机制。

准备工作

  • 能读取 SKILL.md 文件的编码 Agent,例如 Claude Code。
  • 已检出的仓库,或你想安装技能的项目。
技能适用场景
project-context刚接手项目或要改一块没读过的代码时,弄清有什么、在哪里
quick-start用 CLI 创建项目并做到管理员可以正常登录
new-module端到端添加一个模块,包括区域标记和清单
new-page添加一个带文案、守卫和导航的后台或工作台页面
new-agent-plugin把一项 agent 能力做成统一工作台的插件:Skill、卡片、面板和操作
configure-providers通过 /admin/config/* 接入真实服务商
deploy部署到 Cloudflare、Fly.io、Railway 或 Docker 主机:选择或切换平台、保存生成的密钥、迁移并检查 /setup
add-module通过 CLI 的包管理流程安装或升级模块,先预览再执行
remove-module通过 CLI 的包管理流程卸载模块:预览计划、保留改动、决定数据去留并下架它的 Skill

quick-start、add-module 和 remove-module 走的是 CLI 的包管理流程,从 GitHub 克隆的项目用不到。克隆的项目请按快速开始操作,不用 quick-start 技能;另外两个也不需要,因为所有模块已经在代码里。

每个技能都有同样的四个部分:Inputs、Invariants、Workflow 和 Verification。它只提到仓库中真实存在的命令、路径和路由。

安装技能

无需安装。仓库为 skills/ 中的每个技能提交了 .claude/skills/<name> 链接,在克隆目录中打开 Claude Code 即可加载。

在 Windows 上,除非开启了符号链接(克隆前执行 git config core.symlinks true,并打开开发者模式),git 会把这些链接检出为普通文本文件。这种情况下用另一种方式安装。

运行技能

说明任务

用自然语言向 Agent 描述任务,或直接点名技能,例如“用 new-page 技能添加一个导出用的后台页面”。

提供输入

每个技能都以 Inputs 部分开头,例如模块键或部署平台。缺什么 Agent 会向你询问。

让它按工作流执行

Agent 按 Workflow 步骤执行,同时遵守 Invariants,例如绝不编造 id、不在功能代码中读取 process.env。

检查结果

Agent 最后执行技能的 Verification 部分:证明任务完成的命令和页面。

让 Agent 读懂项目

文档讲的是 Kernlift 的通用做法;在你的项目里工作的 Agent 需要的是这个项目本身的情况。下面两个来源提供这些信息。

pnpm kernlift context 每次运行时从源码读出当前项目的描述,新增路由、插件或设置后无需维护。它不需要令牌、网络或数据库,也不写任何文件。

pnpm kernlift context              # 概况和下面的主题
pnpm kernlift context routes       # 每个 URL 及其文件
pnpm kernlift context validators --json
主题列出的内容
rulesAGENTS.md 各节摘要
routes按区域(public、auth、app、admin、api)列出 URL 及文件
pluginssrc/plugins 里的插件、本次构建是否安装、它们的路由和导航项
config每个 /admin/config/* 页面及其背后的 server function 和 repository
env.env.example 里的变量、级别和说明
scripts校验器以外的 pnpm 脚本
validatorspnpm validate:* 检查、哪些由 validate:all 运行,以及已知失败项
skillsskills/ 里的技能

all 一次输出全部主题。project-context 技能会让 Agent 从这里开始。

Markdown 版文档。 /zh/llms.txt 列出本站每一页并链接到它的 Markdown,/zh/llms-full.txt 是全站合在一个文件里,任意页面地址后加 .md 即可得到 Markdown,例如 /zh/docs/quick-start.md。英文版去掉 /zh 前缀。Agent 需要代码里没有的概念或操作步骤时,把 https://kernlift.dev/zh/llms.txt 给它。

验证

  • 在 Claude Code 中,可用技能列表里出现 skills/ 中的技能。
  • pnpm kernlift context 输出的概况里,插件列表与 src/plugins/installed.ts 一致。
  • 在仓库中,pnpm validate:skills 确认技能提到的每个命令、路径和路由都存在。

常见问题

Agent 看不到技能

在仓库根目录打开 Agent,使其找到 .claude/skills。如果 .claude/skills/<name> 是一个很小的文本文件而不是链接,说明克隆时没有启用符号链接,用 npx skills add kernlift/kernlift 安装。

修改后 pnpm validate:skills 失败

某个技能提到的命令、路径或路由已经不存在。按代码更新该技能。

参考

下一步