{
  "markdown": "# AI Knowledge Base Framework\n\n> **企业级元知识底座**：SSOT + 联邦治理，为 AI Agent 提供结构化知识与协作规范。\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/oleewen/ai-knowledge/graphs/commit-activity)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n**结论**：纯文档型底座——无业务运行时；用 Bash 注入任意工程，建立 SDD 协作环境。Agent 契约见 [AGENTS.md](AGENTS.md)；九章地图 [INDEX-GUIDE.md](INDEX-GUIDE.md)；目录索引 [index.md](index.md)。\n\n---\n\n## 简介\n\n| 价值 | 要点 |\n| --- | --- |\n| SSOT | 五视角唯一事实源，跨文件仅 **ID** 引用 |\n| Skills 链 | `docs-*` 构建 × `sdx-*` 交付；产物上行归并 |\n| 联邦 | 公司 → 系统 → 应用；link / pull / distill 对齐 |\n| Agent 友好 | Rules + Skills；Markdown + YAML + Git |\n\n### 为何需要\n\nAgent = LLM + Harness。平台给模型与工具，**工程知识**须由团队以 SSOT + Skills 供给；否则知识缺失/散落/冲突/老化会逼 Agent 靠猜。本仓用契约 + 索引按需下钻，替代碰运气检索。细节与约束见 [AGENTS.md](AGENTS.md)。\n\n---\n\n## 三层联邦架构\n\n| 层级 | 目录 | 职责 |\n| --- | --- | --- |\n| **公司** | [company/](company/README.md) | 顶层架构；`system-{name}/` 镜像槽位 |\n| **系统** | [system/](system/README.md) | 五架构视角；`application-{name}/` 联邦槽位 |\n| **应用** | [application/](application/README.md) | 实现细节与实体 SSOT |\n\n- **SSOT**：实体一处定义，跨文件 **ID** 引用。\n- **联邦**：公司管划分、系统管边界、应用管实现并上行对齐。\n- **闭环**：knowledge ← 归档；solutions → analysis → requirements。\n\n元模型：[application/DESIGN.md](application/DESIGN.md)、[system/DESIGN.md](system/DESIGN.md)、[company/DESIGN.md](company/DESIGN.md)。\n\n---\n\n## 从零选型\n\n**口诀**：有应用仓 → bootstrap + build；有多应用 → 中央 link + pull/distill；只有 legacy → extract → archive → build。\n\n场景 A–D 逐步操作见 [quick-start.md](quick-start.md)。\n\n---\n\n## 快速开始\n\n**预备**：Bash 5.0+、Git；推荐 `rsync`（脚本可回退 `cp`）。\n\n### 1. 手动安装（克隆后执行）\n\n```bash\ngit clone https://github.com/oleewen/ai-knowledge.git\ncd ai-knowledge\n./scripts/docs-bootstrap.sh --doc-target=/path/to/your-project/docs\n```\n\n### 2. 远程 Bootstrap（无需克隆）\n\n```bash\ncd /path/to/your-project\ncurl -sL \"https://raw.githubusercontent.com/oleewen/ai-knowledge/main/scripts/docs-bootstrap.sh\" | bash -s -- --doc-target /path/to/your-project/docs --agents cursor,trae\n```\n\n### 3. Agent 自动化安装\n\n> 根据 [ai-knowledge README](https://github.com/oleewen/ai-knowledge) 的说明，初始化知识库到当前工程 `./docs`。\n\n技术栈与仓库元信息见 [INDEX-GUIDE.md](INDEX-GUIDE.md) §1.2。\n\n---\n\n## 项目结构\n\n> 与 [INDEX-GUIDE.md](INDEX-GUIDE.md) §2.1 一致（目录树唯一起源）。\n\n```text\n./\n├── README.md / AGENTS.md / INDEX-GUIDE.md / index.md / quick-start.md\n├── changelogs/           # 根输出组 INDEXING-LOG\n├── application/          # 应用层 SSOT + SDD（knowledge、阶段产物、changelogs）\n├── system/               # 系统库：knowledge/ + overview、application-{name}/ 槽位、SDD\n├── company/              # 公司库：knowledge/ + overview、system-{name}/ 槽位\n├── scripts/              # docs-install、agent-install、docs-link、docs-bootstrap + tests/\n├── agent/                # skills/（18）、rules/、knowledge/、references/、scripts/、hooks.json\n├── docs/                 # .docsconfig 的 DOC_DIR；会话稿 superpowers/（通常未入库）\n└── .gitignore\n```\n\n---\n\n## Agent 工作流\n\n`docs-*` 维护知识库，`sdx-*` 产出规约；OKF 见 `/docs-okf`。推进口径与禁止事项见 [AGENTS.md](AGENTS.md)；Skill 清单仅 [agent/skills/README.md](agent/skills/README.md)。场景分步 [quick-start.md](quick-start.md)。\n\n```mermaid\nflowchart TD\n    subgraph KB[\"知识库构建链 docs-*\"]\n        direction LR\n        KB_CO[\"company\"] -. push .-> KB_SYS[\"system\"] -. push .-> KB_APP[\"application\"]\n        KB_APP -. pull .-> KB_SYS -. pull .-> KB_CO\n    end\n    subgraph RD[\"需求交付链 sdx-*\"]\n        direction LR\n        RD1[\"/sdx-solution → /sdx-analysis\"] --> RD2[\"/sdx-prd → /sdx-architect\"] --> RD3[\"/sdx-design → /sdx-test\"]\n    end\n    subgraph SDD[\"SDD 实现链\"]\n        direction LR\n        SDD1[\"脑暴\"] --> SDD2[\"探索\"] --> SDD3[\"实现\"] --> SDD4[\"归档\"]\n    end\n    RD -. 知识提纯 .-> KB\n    KB --> RD --> SDD\n```\n\n---\n\n## 文档导航\n\n| 需求 | 文档 |\n| --- | --- |\n| 从零落地（场景 A–D） | [quick-start.md](quick-start.md) |\n| 九章地图 / 目录索引 | [INDEX-GUIDE.md](INDEX-GUIDE.md) · [index.md](index.md) |\n| Agent 契约与查阅顺序 | [AGENTS.md](AGENTS.md) |\n| 三层元模型 | [application/DESIGN.md](application/DESIGN.md)、[system/DESIGN.md](system/DESIGN.md)、[company/DESIGN.md](company/DESIGN.md) |\n| 初始化脚本 | [scripts/README.md](scripts/README.md) |\n| 共享推进契约 | [agent/references/](agent/references/) |\n| 根索引运行日志 | [changelogs/INDEXING-LOG.md](changelogs/INDEXING-LOG.md) |\n| OKF / Skill 清单 | [docs-okf/SKILL.md](agent/skills/docs-okf/SKILL.md) · [agent/skills/README.md](agent/skills/README.md) |\n\n---\n\n## 参与贡献\n\n1. [INDEX-GUIDE.md](INDEX-GUIDE.md) — 路径地图  \n2. [application/DESIGN.md](application/DESIGN.md) — 五视角元模型  \n3. [application/CONTRIBUTING.md](application/CONTRIBUTING.md) — 贡献流程与门禁  \n\n**许可**：[Apache-2.0](LICENSE)。\n",
  "bytes": 4585,
  "sha": "482b0f5262eda5dce2414fd797a2ddaa80b7113bf9f813356a9d25da93453ded",
  "repo_slug": "oleewen/ai-knowledge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_oleewen_ai_knowledge_system_index_md_95fd1d15/readme"
}