跨角色的 AI Agent Skill 私有化知识库
无论是写需求、撸代码还是周报，让 AI 秒变懂公司业务的老员工
Private AI Agent Skill knowledge base for every role
From PRDs to code to weekly reports—make the AI sound like a veteran who knows your business
告别四处复制粘贴"提示词"和"背景设定"。让你的 Cursor、Claude、ChatGPT 瞬间掌握团队专属的业务黑话、产品模板与代码规范，零依赖，一行命令在内网启动。 Stop copy-pasting prompts and context every time. Give Cursor, Claude, and ChatGPT your team jargon, templates, and standards—zero extra stack, one command on your intranet.
无论是产品、研发还是测试，告别每次对话都要重新教 AI 做事的烦恼 PM, engineering, QA—stop re-teaching the AI on every new chat
// ❌ 不懂公司统一鉴权与 Redis 封装
import jwt from 'jsonwebtoken';
export const login = async (req, res) => {
const token = jwt.sign({ id }, 'secret');
return res.json({ token });
}// ✅ 自动引入内部 SSO 组件与合规日志
import { ssoClient } from '@company/sso';
import { auditLogger } from '@core/logger';
export const login = async (req, res) => {
const user = await ssoClient.verify(req.body);
auditLogger.info('USER_LOGIN', user.id);
return SuccessResponse(user);
}// ❌ No idea about your SSO stack or Redis helpers
import jwt from 'jsonwebtoken';
export const login = async (req, res) => {
const token = jwt.sign({ id }, 'secret');
return res.json({ token });
}// ✅ Pulls in internal SSO + audit logging automatically
import { ssoClient } from '@company/sso';
import { auditLogger } from '@core/logger';
export const login = async (req, res) => {
const user = await ssoClient.verify(req.body);
auditLogger.info('USER_LOGIN', user.id);
return SuccessResponse(user);
}一、背景
这是一个为了提升活跃度的活动。
二、功能描述
1. 用户点击抽奖按钮。
2. 扣除积分。
3. 获得奖品。
（❌ 缺乏埋点要求、异常流、UI规范）
【需求编号】ACT-2024
【目标受众】V3及以上高价值用户（基于业务词典）
【异常流程】
- 并发防资损：调用 @Promo/Lock 接口拦截
【数据埋点要求】
- 事件名：btn_lottery_click
- 携带参数：user_id, source_type
（✅ 自动套用公司 PRD 模板与埋点规范）
1. Background
An activity to boost engagement.
2. Features
1) User taps lottery.
2) Deduct points.
3) Win a prize.
(❌ Missing analytics, edge cases, UI rules)
[ID] ACT-2024
[Audience] V3+ high-value users (from business glossary)
[Edge cases]
- Concurrency: call @Promo/Lock to prevent losses
[Analytics]
- Event: btn_lottery_click
- Params: user_id, source_type
(✅ Uses your PRD template + tracking rules)
// ❌ 使用了公司没在用的测试框架，且不知道测试账号
import axios from 'axios';
test('add to cart', async () => {
const res = await axios.post('http://api/cart');
expect(res.status).toBe(200);
});// ✅ 自动使用公司的 Playwright 封装与测试网关
import { apiTest, getMockUser } from '@qa/core';
apiTest('购物车-正常添加', async ({ request }) => {
const user = await getMockUser('VIP'); // 自动获取环境数据
const res = await request.post('/gw/api/v2/cart');
expect(res).toHaveCode('SUCCESS');
});// ❌ Wrong framework; no idea about test accounts
import axios from 'axios';
test('add to cart', async () => {
const res = await axios.post('http://api/cart');
expect(res.status).toBe(200);
});// ✅ Uses your Playwright helpers and test gateway
import { apiTest, getMockUser } from '@qa/core';
apiTest('cart — happy path', async ({ request }) => {
const user = await getMockUser('VIP'); // env-aware fixtures
const res = await request.post('/gw/api/v2/cart');
expect(res).toHaveCode('SUCCESS');
});本周工作总结：
1. 周一开了个会，讨论了首页改版。
2. 周二写了接口。
3. 周三修复了几个bug。
4. 下周计划继续做项目。
🎯 【OKR 对齐进展】
- 首页改版（O1-KR2）：完成核心接口，进度 60%，符合预期。
🔥 【核心产出与价值】
- 修复支付链路 3 个 P2 缺陷，预计降低客诉率 5%。
🚧 【风险与求助】
- UI 走查延迟，可能影响下周三的发版，需协调资源。
（✅ 自动套用团队 OKR 汇报模板与结构）
This week:
1. Monday: meeting about the homepage.
2. Tuesday: wrote APIs.
3. Wednesday: fixed bugs.
4. Next week: keep going.
🎯 OKR alignment
- Homepage redesign (O1-KR2): core APIs done, ~60% on track.
🔥 Outcomes
- Fixed 3 P2 issues in payments; ~5% fewer support tickets expected.
🚧 Risks / asks
- UI review slipped; may hit Wed release—need help.
(✅ Uses your OKR update template)
告诉 AI 公司的专有名词、业务背景、产品线划分。无论哪个岗位的同事在写 Prompt，AI 都能瞬间 Get 到业务上下文。Teach the model your terms, domains, and product map—so every role gets consistent context in prompts.
从代码目录结构、组件封装、到自动化测试的断言写法，把高手的最佳实践沉淀下来，让 AI 严格遵守。Layout, components, test assertions—capture how your best people work and make the AI follow it.
管理产品 PRD 模板、Git Commit 格式、Code Review 重点、甚至汇报 PPT 结构，一键下发到团队每个人的 IDE 或浏览器中。PRDs, commit format, review checklists, slide outlines—ship them to every IDE or browser with one flow.
三个痛点，一个解决方案Three pains, one fix
公司的编码规范、内部 API 文档、业务逻辑不能上传到公共平台，但又需要让 AI 理解这些内容。Standards, internal APIs, and domain rules cannot live on a public registry—but models still need them.
每次换项目、带新人，都要把长长的"系统提示词"和"业务背景"重新发一遍，版本混乱。New project or new hire means resending giant system prompts—versions drift and nobody wins.
不想为了管理几个提示词文件就部署复杂的基础设施，K8s、Docker Compose 太重了。You should not need a full platform just to manage a handful of prompt files.
为开发者精心打造的每一个细节Details that respect your time
一行命令启动服务，SQLite 自动初始化，开箱即用One command, SQLite bootstraps itself—ready to go
search / install / publish，熟悉的工作流，零学习成本search / install / publish—the muscle memory you already have
完全部署在你的内网，敏感规范不外泄Runs on your network—sensitive rules stay inside
每次发布自动生成版本号，支持版本回溯和对比Every publish gets a version—diff and roll back when needed
7 篇文章带你系统了解 Agent Skills：从概念到实战，从搭建到避坑 7 articles to master Agent Skills—from concepts to production, from setup to pitfalls
Skill 是什么、适合什么问题、如何选题与撰写，以及碎片化与团队分发。What a Skill is, when to use it, how to choose topics, and team distribution.
02运行时分层加载、技能目录结构，以及一份可照抄的最小 SKILL.md 模板。Runtime layering, directory layout, and a copy-paste minimal SKILL.md template.
03用 skill-base / skb 像 npm 一样发布、搜索、安装与更新团队 Skill。Use skill-base / skb to publish, search, install and update team Skills like npm.
04重复、稳定、可执行三条标准判断什么值得写成 Skill，附场景清单与反例。Three criteria—repeatable, stable, executable—to decide what deserves a Skill.
05把分页映射、时间范围校验、查询折叠、机构权限沉淀为项目 Skill 的真实改造案例。A real-world case study: pagination, date validation, permissions as Skills.
06收窄 description、分层组织 SKILL.md/references、用 checklist 和版本策略稳住长期质量。Tighten descriptions, organize references, and use checklists and versioning.
07多工具、多 Skill 并存时的真相源、触发排序与 frontmatter 方言。Truth sources, trigger ordering and frontmatter dialects across tools.
从安装到使用，只需几分钟From install to daily use in minutes
把下面的话直接发给助手即可（按你的环境替换服务器地址与验证码） Send these lines to your assistant—substitute your server URL and verification code
skill-base-cliInstall skill-base-cli from ClawHub日常用 skb 搜索、安装、发版、对接团队已部署的 Skill Base 时用；不必为了用 CLI 再装服务端部署 Skill。Use when searching, installing, publishing with skb, or connecting to your team’s Skill Base—you do not need to deploy the server again just for the CLI.
skill-base-web-deployInstall skill-base-web-deploy from ClawHub仅当需要助手在本机或服务器上起服务、Docker、数据目录与备份等服务端工作时再装。Install only when you need the assistant to run the service, Docker, data paths, backups, and other server-side tasks.
换成你的实际站点 BASE URL。Use your real site base URL.
some-skillUse skb to search for some-skill.
一般不需要登录。Usually no login required.
some-skillUse skb to install some-skill.
可用 skill_id@版本 指定版本。一般不需要登录。Pin a version with skill_id@version. Usually no login required.
some-skillUse skb to update some-skill.
一般不需要登录。Usually no login required.
验证码需在浏览器打开 https://<主机>/cli-code 获取，五分钟有效期。Obtain the code by opening https://<host>/cli-code in your browser; it expires in five minutes.
发布 skill 必须先登录。可让助手写 changelog 文案。
You must sign in before publishing a skill.Ask for --changelog copy when you need release notes.
Stay Out of the Way — 极简与无侵入Stay Out of the Way — minimal and invisible
Skill Base 只做一件事：把 Skill 从服务器搬到你的项目里。不做解析，不做转换，原封不动。One job: move Skills from the server to your project. No parsing, no transforms—byte-for-byte.
能用一个文件搞定的，绝不引入两个。SQLite 单文件部署，就是这么任性。If one file can do it, we do not add a second. SQLite in a single file—deploy and forget.
所有数据都在你本地。不想用云？内网也能跑。不想升级？永不更新也能用。Your data stays local. No cloud? Run on the intranet. No upgrades? It still works.