技能
skills/ 里的 SKILL.md 工作流:每个做什么、需要你提供什么、如何确认完成。
skills/<name>/SKILL.md 是编码 Agent(例如 Claude Code)在本仓库或其衍生项目里干活时遵循的工作流。.claude/skills/<name> 链接了每一个,打开代码仓库即可使用。每个技能都有四节:Inputs(Agent 向你要什么)、Invariants(它遵守的规则)、Workflow(步骤)和 Verification(证明完成的命令和页面)。在其他项目里安装和运行的方法见使用编码 Agent 技能。
它们不是可选 /app/agent 工作台运行的 agent-skills/ 发布包,后者见 Agent 模板。
一览
| 技能 | 用途 | 你需要提供 |
|---|---|---|
project-context | 修改之前先了解项目 | 任务或要了解的部分 |
quick-start | 创建项目,跑到能用管理员账号登录 | 项目名、域名、部署平台、是否需要 Agent |
configure-providers | 接入登录、邮件、支付、存储、AI、分析或缓存 | 要接入的能力和服务商凭据 |
new-page | 添加一个后台或工作台页面 | 路径、读写什么、权限键 |
new-module | 从头到尾添加一个能力模块 | 模块 key、数据表、页面、权限键、依赖的模块 |
new-agent-plugin | 给唯一的 Agent 工作台添加一项能力 | 插件 id、场景、附带的 Skill、用户看到什么 |
deploy | 部署到 Cloudflare、Fly.io、Railway 或 Docker | 平台、已登录的平台 CLI、需要时的 Postgres 地址 |
add-module | 从 Kernlift registry 安装或升级模块 | 模块 key |
remove-module | 卸载 registry 安装的模块,保留本地修改和数据 | 模块 key、数据是否一并删除 |
直接用自然语言说任务,或点名技能,例如“用 new-page 技能加一个导出用的后台页面”。
了解项目
project-context
让 Agent 先运行 pnpm kernlift context 看概况,读 AGENTS.md,再按任务查看相关的路由、插件、设置页、环境变量、脚本或校验器,打开输出里指出的文件,最后选择对应的任务技能。概况里的插件列表与 src/plugins/installed.ts 一致、pnpm validate:skills 通过即为完成。
开发
new-page
在 /admin/<x> 或 /app/<x> 下添加页面:双语文案、按权限键把关的服务端函数、导航入口,以及所在布局的守卫。pnpm validate:route-i18n、pnpm validate:app-i18n、pnpm validate:auth-boundary 和 pnpm validate:beui-console 通过,页面在两种语言和两种主题下正常显示,没有权限的用户看不到入口,即为完成。
new-module
把一项能力做成模块:仓储、服务、路由、两种数据库方言的表结构与迁移、双语文案、校验器,以及带 @module 标记的清单。pnpm validate:registry 显示底座仍能单独通过类型检查、模块自己的校验器通过、pnpm validate:all 没有把任何检查变红,即为完成。
new-agent-plugin
给 Agent 工作台添加插件:服务端扩展、浏览器入口、Skill、卡片、面板和操作,可在 /admin/plugins 里随时开关。pnpm validate:agent-plugin-contract 和插件自己的校验器通过、pnpm build:agent-service 仍能构建、插件出现在 /app/agent 的选择器里,即为完成。
配置与上线
quick-start
创建项目、安装依赖、迁移本地数据库、创建超级管理员并启动 pnpm dev。pnpm typecheck 和 pnpm validate:gate 通过,/setup 显示会话密钥和至少一种登录方式就绪,即为完成。
configure-providers
带你走一遍某项能力对应的 /admin/config/* 页面,服务商凭据不放进环境变量。/setup 显示该项就绪、pnpm validate:env-example 通过即为完成;EXTERNAL_VALIDATE_STRICT=true pnpm validate:external 会对真实服务商做检查。
deploy
选择或切换 deploy.config.json 里记录的平台,保存生成的密钥,迁移并部署。部署命令打印出地址,/setup 显示平台、会话密钥和定时任务就绪,即为完成。上线前可以先用 pnpm smoke:node 或 pnpm smoke:worker 检查构建。
模块
这两个技能只用于从 Kernlift registry 安装模块的项目。从商店购买的模板以独立的 GitHub 仓库交付,不需要它们,见获取 Kernlift。
add-module
安装或升级模块,然后执行它的安装、迁移和校验步骤。模块的校验器通过、CLI 的健康检查全部正常、有权限的用户能看到它的后台页面,即为完成。
remove-module
卸载模块:先预览计划,保留你的本地修改,除非你要求,否则保留模块数据。CLI 的健康检查全部正常、pnpm typecheck 和 pnpm build 通过、模块页面已消失,即为完成。
检查
| 命令 | 检查什么 |
|---|---|
pnpm validate:skills | 每个技能都有四节,且只引用存在的命令、路径和路由 |
pnpm skills:pack | 从 skills/ 构建 @kernlift/skills |