Known · 元数据驱动的 .NET 全栈框架

Known 除了给人看的这套文档，还提供一份给 AI 编码智能体用的 Agent Skill——known-framework，可直接从本站下载。装上它，你对助手说一句「在 Known 上加一个订单页面，带分页表格」，它就会自动按框架约定生成 AddMyApp 装配、[Menu] 页面、[WebApi]+[Service] 服务、实体与 Database CRUD，而不必反复去翻文档或猜 API。

这份技能覆盖什么

用 known new <应用名> [--db <方言>] 生成四工程起步方案；
插件装配 Add{应用名}(AppType)、Config.AddModule、菜单分组；
页面 + [Menu]、[WebApi]/[Service] 服务契约与路由约定；
实体建模（[Table]/[Key]/EntityBase）与 Database 的增删改查 / 分页 / 事务；
七种方言的 db.AddXxx<Factory>() 与连接串配置；
认证 AuthProvider 与内建 IAuthService、Known.Components 组件用法。

技能目录里三个文件各司其职：SKILL.md（主指引与配方）、reference.md（完整 API 签名）、examples.md（端到端可复制样例）。

从哪里来 · 下载

技能随文档站发布，以打包形式提供：

打包下载：known-framework.zip —— 解压即得整个 known-framework/ 目录（SKILL.md / reference.md / examples.md）。

known-framework/
├── SKILL.md        # 主文件：心智模型 + 8 个核心配方
├── reference.md    # API 参考：注册方法 / 特性 / Database 全套 / 组件清单
└── examples.md     # 端到端样例：分页表格 + CRUD、Cookie 宿主、多库切换

装到你的智能体

把整个 known-framework/ 目录放进对应智能体的技能目录即可被自动发现，无需额外命令：

智能体	安装目录
QoderWork	`%USERPROFILE%\.qoderwork\skills\known-framework\`（macOS/Linux 为 `~/.qoderwork/skills/known-framework/`）
Claude Code	`~/.claude/skills/known-framework/`

最省事的方式是下载上面的 known-framework.zip，解压后把整个 known-framework/ 目录放进表里对应位置即可；若你的智能体界面支持「保存/安装技能」，也可直接用这个压缩包一键安装。

装好后正常提需求即可，例如：

用 Known 做一个「客户管理」：列表要分页和按名字筛选，能新增和删除。

智能体会加载 known-framework，按框架的真实 API（注意是 AddSQLServer/AddMySQL/AddPostgreSQL/AddOracle 这类大小写敏感的方法名）产出可用代码。

没有技能时怎么办

技能只是加速器，不是必需。文档站本身已覆盖同样的知识——装配见应用装配 AddKnown、数据与 CRUD 见数据层与 Database 契约、分页表格见表格分页与筛选、鉴权见鉴权接入。手工照着这些页面写，结果一致。

给维护者：技能放在哪 · 如何更新

技能本体托管在 Website 项目里（不再放在开源仓库），但源码与对外发布件分两处：可编辑的 .md 源放在与 wwwroot 平级的 docs/skills/ 下（不随站点发布、不对外下载），只有打包好的 zip 留在 wwwroot/downloads/ 供下载——与 Known.AI 安装包同目录，站内一切对外下载件都收在 /downloads/ 下：

Website/docs/skills/known-framework/   # 源：SKILL.md + reference.md + examples.md（仓库留存，不发布）
Website/wwwroot/downloads/
├── known-ai-0.2.0-win-x64.zip         # Known.AI 安装包
└── known-framework.zip                # 技能发布件，地址 /downloads/known-framework.zip

改动任一 .md 源后，记得同步重生成 zip（否则下载到的还是旧内容），再把 zip 放回 wwwroot/downloads/——用 PowerShell 打包即可，注意条目名要用正斜杠（ZipArchive.CreateEntry("known-framework/SKILL.md")），别用 Compress-Archive（在 Windows 上会写成反斜杠，部分解压工具不认）。构建 Website 时 wwwroot/downloads/ 作为静态资源随站点发布；/downloads/ 前缀不受文档站软 404 守卫拦截，直接由 MapStaticAssets 送出。

本页（md/guides/agent-skill.md）若要挪动或新增同类文档页，登记进 /docs 仍是三步：

在对应分类目录放一个 .md（本文件就在 md/guides/agent-skill.md）。
写好头部 frontmatter：title / category（决定归入哪一组，如 guides）/ slug（URL 末段）/ order（组内排序）/ updated / excerpt（列表摘要）。
构建 Website 项目，索引 docs/index/pages.json（与 wwwroot 平级）会自动重新生成——不要手工编辑它。新页面随即出现在左侧导航与站内搜索里。

本页已从 overview「能力全景」与 quickstart「下一步」各挂了一条内链，改动时留意别把入口弄丢。