OKF_WIKI 知识体系

Open Knowledge Format v0.1 — Agent 可读知识库
136 Markdown 文件 6 层级架构 4 活跃技能域 64 外部参考源 10 架构决策记录
136
知识条目
136 .md 文件
8
Agent 指南
Codex · Cursor · Claude · OpenCode · Copilot
4
活跃项目
Finance · 供应商 · 家庭 · OKF 自身
27
外部技能
McKinsey · Matt Pocock · Anthropic · Karpathy
64
参考来源
Agent 框架 · 工具库 · 平台
10
ADR 决策
架构决策记录 (001–010)

六层知识架构

8
🧠

01-Agent

Agent Guide / Memory

Agent 行为指南与长期记忆。跨 agent 共享的启动上下文和用户偏好。

  • memory.md — 核心记忆 & 偏好
  • karpathy-guidelines.md — 行为准则
  • cursor.md / claude.md / codex.md / opencode.md / github-copilot.md
20
📊

02-Project

Project

项目上下文、架构描述与焦点追踪。总控面板 + 独立项目空间。

  • current-focus.md — 总控工作焦点
  • architecture.md — OKF 架构设计
  • Supply Chain Finance Agent
  • Supplier Service Tracking (paused)
  • Family Digital Brain (paused)
67
📚

03-Reference

Reference

技术参考、外部来源与架构决策。64 个 GitHub 星标仓库索引。

  • design-decisions.md — 10 条 ADR
  • sources/ — 64 外部参考 (CrewAI, Dify, n8n...)
  • Karpathy LLM Wiki 模式参考
2
📏

04-Standard

Standard

编码规范与硬约束。定义 brain/body 边界、YAML frontmatter 要求。

  • coding-conventions.md — 规范 & 约束
  • Python / TypeScript 代码风格
  • 保存到 OKF 写入协议
5
📋

05-Playbook

Playbook

操作流程与手册。从踩坑记录到可执行的检查清单。

  • project-setup.md — 项目初始化 (FastAPI / Node)
  • deploy-flow.md — Cloud Run / Docker 部署
  • okf-ingest.md — 资料摄入流程
  • okf-health-check.md — 健康检查
28
🎯

06-Skills

Skill (OKF 扩展)

从 npx skills 生态系统收集的外部 agent 技能。按用例分类。

  • McKinsey / BCG 咨询方法论
  • Matt Pocock 工程框架
  • Anthropic Financial Services
  • UI/UX · 教学 · 交易 · 系统思维

🧬 核心架构模式:Brain / Body 分离

🧠

OKF Wiki = 2nd Brain

策略 · 范围 · 决策 · 记忆 · 规范。Agent 每次对话必读的长期上下文。YAML frontmatter + Wikilinks 构成知识图谱。

💻

项目 Repo = Project Body

代码 · 测试 · 部署配置 · CI/CD。OKF 指向 repo 路径(指针),不复制代码逻辑。Hot path 留在聊天,Cold path 写入 OKF。

🛡️

保存协议:先提案再写入

Agent 不得擅自写入 OKF。必须建议目标文件 + 草稿 + 理由,等待用户确认后再写入。防止知识污染。

项目状态总览

Supply Chain Finance Analysis Agent

ACTIVE

CFO-grade 供应链金融分析 Agent。确定性财务引擎 (NPV/IRR/ROI) + LLM Advisor 解读层。V1 模块:Capex ROI、Cost-to-Serve、Inventory & Working Capital。

Supplier Service Tracking System

PAUSED

Python FastAPI + Cloud SQL PostgreSQL + Cloud Run。供应商服务事项、问题与状态追踪。已完成 Discovery 阶段。

Family Digital Brain

PAUSED

家庭财务追踪、项目管理和 IGCSE 学习支持的数字工作流。

OKF_WIKI 自身

ACTIVE

持续演进的知识库框架。136 个文件、10 条 ADR、27 个外部技能、64 个参考源。每日维护与优化。

技能生态系统

Matt Pocock Skills Anthropic Skills Karpathy Guidelines McKinsey / BCG 咨询 Vercel npx Skills UI/UX Pro Max Socrates Skill Anthropic Financial Services Qian Xuesen 系统思维 Garry Tan GBrain Dean Peters PM PPT Master Diagram Design Options Trading Unreal Engine Nature Journal Charts Business Diagnosis

外部参考源云

CrewAI 54k★ AutoGPT 185k★ MetaGPT 69k★ Dify 146k★ n8n 194k★ Open WebUI 143k★ OpenCode 179k★ Agency-Agents 116k★ Hermes Agent 203k★ ECharts 66k★ Anime.js 70k★ MarkItDown 159k★ Stirling PDF 84k★ Build Your Own X 520k★ Awesome 479k★ Multica 38k★ Google ADK Scrapling 66k★

知识工作流

1
📥 资料摄入
外部文章 · 调研 · 问答
2
📝 结构化沉淀
YAML frontmatter · Wikilinks
3
🔗 知识链接
交叉引用 · 知识图谱
4
🤖 Agent 消费
必读 · 按需调用
5
🔄 持续迭代
log.md · 健康检查 · 更新

快速演化时间线

2026-06-26
🚀 初始化 OKF v0.1 框架 —— 创建 5 层目录结构、memory、current-focus、coding-conventions 模板
2026-06-27
📈 大规模扩展:90 个 GitHub 仓库收录、27 个外部技能、多项目支持、启动上下文优化 P0→P2
2026-06-28
⚡ FINBP 财务 Agent + 三个项目并行推进、OKF 迁回本地、Cursor MCP 集成、ADR-007~010
2026-06-29
🧬 Supply Chain Finance Agent 立项、OKF brain/body 原则定型、Anthropic FS 技能收录、git 提醒规则
一个 .md 文件 = 一个概念 · YAML frontmatter = 文档类别 · [[链接]] = 知识图关系 · Agent 读文件 = 无需 SDK
🧠 OKF_WIKI — Your 2nd Brain for AI Agents