{
  "markdown": "# 基础设施知识库\n\n团队基础设施知识库。人和 Agent 读同一套 Markdown。本仓库是框架；`wiki/` 分组已建好，概念页待入库。\n\n组织方式来自两处：\n\n- [Karpathy / llm-wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)：`raw/` 与 `wiki/` 分离。人投放来源、提问；Agent 把知识编译进 wiki 并持续维护。wiki 是可复利的产物，对话不是。\n- [Google Cloud Open Knowledge Format (OKF)](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md)：用各层 `index.md` 做**渐进式索引**（progressive disclosure）。先读 `wiki/index.md` 看有哪些分组，再读分组 index，最后打开 2–5 篇正文。每页 YAML frontmatter（`type` 等）和 `tools/okf-lint/okf_lint.py` 是配套约定。[OKF — The Markdown Spec for Humans and AI Agents](https://okf.md/)\n\n**分享请 clone 整仓**（含 `wiki/` 与 `raw/`），不要只拷 `wiki/`。知识页须自洽；`sources` 只做溯源。\n\n## 目录结构\n\n```\n.\n├── index.md                      # 仓地图：wiki / raw / script / tools\n├── wiki/                         # OKF 知识图：Agent 维护\n│   ├── index.md                  # 知识入口：只列分组（可有 okf_version）\n│   ├── log.md                    # 追加式变更日志\n│   ├── 资源注册表/\n│   ├── 系统与架构/\n│   ├── 操作手册/\n│   ├── 故障排查/\n│   ├── 架构决策记录/\n│   ├── 常见问题/\n│   ├── 规范与约束/\n│   ├── 案例与复盘/\n│   ├── 技能地图/\n│   ├── 新人上手/\n│   └── 自动化脚本/               # 说明文档；.py 在 script/\n├── raw/                          # 人维护：只读来源\n├── script/                       # 运维可执行脚本\n├── tools/                        # 维护本仓的框架工具\n│   ├── index.md                  # 工具总览\n│   └── okf-lint/                 # wiki 体检\n│       ├── README.md\n│       └── okf_lint.py\n├── AGENTS.md                     # 能力索引；细则在 Skill\n└── .cursor/skills/infra-wiki/    # Ingest / Query / Lint\n```\n\n| 面 | 路径 | 谁维护 | 说明 |\n| --- | --- | --- | --- |\n| **知识面** | [`wiki/`](wiki/) | **Agent** | 编译后的知识。人读、提问、过目确认（`verified`）。 |\n| **来源面** | [`raw/`](raw/) | **人** | 投放来源后告诉 Agent 入库。Agent **只读、不改、不删**。 |\n| **框架面** | 仓根 [`index.md`](index.md)、[`AGENTS.md`](AGENTS.md)、[`README.md`](README.md)、[`script/`](script/)、[`tools/`](tools/)、[`.cursor/skills/infra-wiki/`](.cursor/skills/infra-wiki/) | 人（改前先确认） | 约定与工具；**不是**运维知识页。运维脚本在 `script/`，框架工具在 `tools/`，用法写在 `wiki/自动化脚本/`（运维）或 `tools/*/README.md`（框架）。 |\n\n## 在 Code Agent 中使用\n\n用 **Cursor** 或 **Claude Code** 打开本仓库，在 Agent 对话里用自然语言说话。人投放来源、提问、过目确认；Agent 按 Karpathy 的三条操作维护 `wiki/`。禁止脱离 wiki 臆造未写入的细节。\n\n| 产品 | 会读什么 | 你怎么做 |\n|------|----------|----------|\n| [Cursor](https://cursor.com) | [`AGENTS.md`](AGENTS.md)、Rule [`.cursor/rules/infra-wiki.mdc`](.cursor/rules/infra-wiki.mdc)、Skill [`infra-wiki`](.cursor/skills/infra-wiki/) | 打开仓库 → Agent 聊天，直接问 |\n| [Claude Code](https://code.claude.com/docs) | 根目录 [`AGENTS.md`](AGENTS.md) | 在仓库根运行 `claude`；需要更细路由时 `@.cursor/skills/infra-wiki/SKILL.md`，或把该目录拷到 `.claude/skills/infra-wiki/` |\n\n### Ingest（摄入）\n\n把来源编译进 `wiki/`。人先把工单、纪要、旧文档放进 [`raw/`](raw/)，再让 Agent 入库；Agent **不改** `raw/`。故障结论不要只留在聊天里。写入后会更新分组 `index.md` 和 [`wiki/log.md`](wiki/log.md)。\n\n```text\n把 raw/ 里这份工单入库。\n这次故障结案，结论写进 wiki。\n补一页绿区转发代理操作说明。\n```\n\n### Query（查询）\n\n问 `wiki/` 里已有的知识。Agent 先读 [`wiki/index.md`](wiki/index.md)，再打开分组 index，最后读 2–5 篇正文。只知道现象时走 [`wiki/故障排查/`](wiki/故障排查/)。\n\n```text\n磁盘满了怎么处理？\n某服务的入口和负责人在哪？\nHelm 部署失败怎么排查？\n```\n\n### Lint（检查）\n\n检查 frontmatter、`type` 与目录是否一致、断链、过期、index/log 是否跟上。Agent 对话里说「体检一下 wiki」，或本地执行：\n\n```bash\npython tools/okf-lint/okf_lint.py\n```\n\n## wiki 分组\n\n\n| 目录 | `type` | 放什么 |\n| --- | --- | --- |\n| [`资源注册表/`](wiki/资源注册表/) | `Registry` | 资源、入口、环境、负责人、依赖、告警。不存凭证 |\n| [`系统与架构/`](wiki/系统与架构/) | `Architecture` | 系统说明、拓扑、请求/数据链路 |\n| [`操作手册/`](wiki/操作手册/) | `Runbook` | 标准操作或配置说明 |\n| [`故障排查/`](wiki/故障排查/) | `Playbook` | 按症状排查、止损、升级 |\n| [`架构决策记录/`](wiki/架构决策记录/) | `Decision` | 选型、权衡、约束 |\n| [`常见问题/`](wiki/常见问题/) | `FAQ` | 短问答、工具速查、报错释义 |\n| [`规范与约束/`](wiki/规范与约束/) | `Policy` | 命名、权限、变更、安全、CI 规范 |\n| [`案例与复盘/`](wiki/案例与复盘/) | `Incident` | 故障/变更/演练复盘 |\n| [`技能地图/`](wiki/技能地图/) | `Curriculum` | 能力范围、学习路径 |\n| [`新人上手/`](wiki/新人上手/) | `Onboarding` | 接手清单、权限申请、首周任务 |\n| [`自动化脚本/`](wiki/自动化脚本/) | `Automation` | 脚本说明、参数、权限、风险（`.py` 在 `script/`） |\n\n业务域（原 00–08）写在 frontmatter 的 `domain`，不当目录。type / frontmatter 见 Skill [`types.md`](.cursor/skills/infra-wiki/types.md)；入口索引见 [`AGENTS.md`](AGENTS.md)。\n\n## 路线图\n\n\n| 阶段              | 做什么                           |\n| --------------- | ----------------------------- |\n| **Phase 0（当前）** | 框架、schema、Skill、校验脚本 |\n| **Phase 1**     | 按痛点补操作手册、故障排查、资源注册表           |\n| **Phase 2**     | 存量文档落入 11 个目录、打 domain、互相链接   |\n| **Phase 3**     | 补齐系统与架构、技能地图、新人上手、自动化脚本       |\n| **Phase 4（可选）** | Obsidian / MkDocs；再加本地搜索      |\n",
  "bytes": 4339,
  "sha": "421afbde9255d6cbb8d5c06d82fa559cebceeaf09ea671687b2016f4883baa00",
  "repo_slug": "zhanyeye/llm-wiki-okf",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_zhanyeye_llm_wiki_okf_wiki_index_md_d6a79fc8/readme"
}