使用编码 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| 主题 | 列出的内容 |
|---|---|
rules | AGENTS.md 各节摘要 |
routes | 按区域(public、auth、app、admin、api)列出 URL 及文件 |
plugins | src/plugins 里的插件、本次构建是否安装、它们的路由和导航项 |
config | 每个 /admin/config/* 页面及其背后的 server function 和 repository |
env | .env.example 里的变量、级别和说明 |
scripts | 校验器以外的 pnpm 脚本 |
validators | pnpm validate:* 检查、哪些由 validate:all 运行,以及已知失败项 |
skills | skills/ 里的技能 |
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 失败
某个技能提到的命令、路径或路由已经不存在。按代码更新该技能。
参考
- 技能:每个技能做什么、需要什么、如何检查
- Agent 模板:单独的运行时产品及其发布技能包
- Agent Skills 规范:
SKILL.md的文件格式