开源 Agent Skill

看见代码背后的系统。

代码智能工具先为整个仓库建立索引，Coding Agent 再选择并解释与读者有关的路径，最终得到一份清晰且有源码证据的 HTML 系统地图。

打开产品视角案例 安装 Skill

本地代码索引 · Agent 选择性整理 · 单文件 HTML

system-map.html
账号与内容体验产品视角 · 标准颗粒度
账号入口注册、登录与找回入口
身份校验保护用户私有操作判断
自有内容创建并管理用户内容能力
账号恢复重新回到可用状态流程
用户结果安全且可见的反馈输出
从代码仓库到系统说明

三个层级，一条清楚的阅读路径。

先理解系统全貌，再按需进入模块和节点。读者只需要看到真正有助于理解产品或实现的细节。

这里展示的是同一张地图，不是三个案例。选择一个层级，看看读者深入阅读时会多理解什么。

第 01 层 · 系统账号与内容旅程

先看产品故事，以及一条贯穿整个系统的完整路径。

入口账号访问注册、登录、找回
判断身份校验保护私有操作
能力自有内容创建与管理内容
结果可见反馈成功或进入恢复

读者获得：系统目标、主要职责和核心旅程，不必先理解实现细节。

读者决定地图

直接告诉 Agent 你想理解什么。

产品和技术不是两个僵硬模板。Agent 会把自然语言变成实际的模块边界、颗粒度、名称、Prompt、关系与折叠层级。

你

给产品经理看。重点解释每个模块做什么、用户能看到什么，以及真实 Prompt；框架和数据库管线尽量合并。

Agent 设计地图

我会优先展示能力和用户旅程，合并普通基础设施，并把源码证据保留在每个节点的详情中。

你 · 看到第一版后

支付失败恢复再细一点。展示两个 Prompt 分别怎样改变最后回复，但普通 API 接线不用展开。

Agent 修改模型

我会拆分该模块、增加 Prompt 影响关系、保留证据，重新校验完整路径，并只在交付成功后替换 HTML。

三份完整案例页面

真实代码库，不同读者，完整地图。

这些不是装饰性的效果图。每张预览都能打开一份由固定公开 commit 生成的独立 HTML，里面包含系统总览、模块视图、节点证据和可继续修改的 JSON IR。

full-stack-fastapi-template.htmlFull Stack FastAPI Template 的产品视角系统地图
产品视角 · 4 个模块

Full Stack FastAPI Template

理解注册、登录、账号恢复和用户自有内容，不要求读者先学习容器、迁移或生成客户端的内部实现。

适合：产品经理、创始人和跨职能规划讨论。

产品视角16 个节点17 条证据
打开完整页面 →查看源码 ↗
huey.htmlHuey Task Queue 的技术视角系统地图
技术视角 · 5 个模块

Huey Task Queue

理解任务怎样进入队列，Worker 与调度器如何配合，以及重试、失败和结果怎样在运行时中传递。

适合：需要理解执行过程与状态流转的工程师。

技术视角16 个节点19 条证据
打开完整页面 →查看源码 ↗
openai-agents-python.htmlOpenAI Agents Python SDK 的混合视角系统地图
混合视角 · 真实 Prompt

OpenAI Agents Python SDK

把运行循环、工具、Handoff、Guardrail、Session 和 Tracing 联系起来，并查看带准确源码证据的真实 Handoff Prompt。

适合：共同设计 Agent 行为的产品与工程团队。

混合视角12 个节点1 个 Prompt
打开完整页面 →查看源码 ↗
两个专用层

先索引，再解释。

先安装 Codebase Memory 代码智能工具，再把本 Skill 复制到本地 skills 目录。前者负责完整结构索引，已有 Agent 负责按照读者目标整理内容。

安装 Codebase Memory ↗
阅读完整指南 →

git clone https://github.com/farmerzh47/codebase-system-map.git
cd codebase-system-map
$skillPath = Join-Path $env:USERPROFILE ".codex\skills\codebase-system-map"
New-Item -ItemType Directory -Force $skillPath | Out-Null
Copy-Item ".\codebase-system-map\*" $skillPath -Recurse -Force
git clone https://github.com/farmerzh47/codebase-system-map.git
cd codebase-system-map
mkdir -p "$HOME/.codex/skills/codebase-system-map"
cp -R codebase-system-map/. "$HOME/.codex/skills/codebase-system-map/"
使用的开源组件

结构尽量小，依赖必须说清楚。

Codebase Memory 提供详细的仓库智能信息；Node.js 校验并交付地图；Viz.js、Graphviz 和 Expat 在独立 HTML 内渲染图形。

MIT

Codebase Memory

参考代码智能工具，负责仓库索引、架构分析、搜索、路径追踪和有范围限制的源码读取。

MIT

Viz.js 3.29.0

每份生成文档内嵌的 JavaScript 封装和 WebAssembly 图形渲染器。

EPL-2.0

Graphviz

编译进 Viz.js WebAssembly 的 DOT 布局引擎，负责生成图形的 SVG 几何结构。

MIT

Expat

由 Viz.js 对象代码间接包含的 XML 解析器。

Codebase Memory 单独安装，通过它的 Agent Skill 或 MCP 接口使用。网站使用原生 HTML、CSS 和 JavaScript 实现。查看完整第三方说明和许可证文本。

地图来自对话

让决定下一步的人真正读懂代码库。

免费开源、MIT 许可证、跨平台，并且最终只留下一个可以直接分享的文件。

在 GitHub 查看 查看包含 Prompt 的案例