https://github.com/fengyunzaidushi/markmap-skill
生成先整体后局部、每层默认最多 5 个分支的内容优先 Markmap 思维导图
https://github.com/fengyunzaidushi/markmap-skill
agent-skills codex-skill content-first knowledge-map learning-tools markdown markmap mindmap repo-analysis skills-sh
Last synced: about 18 hours ago
JSON representation
生成先整体后局部、每层默认最多 5 个分支的内容优先 Markmap 思维导图
- Host: GitHub
- URL: https://github.com/fengyunzaidushi/markmap-skill
- Owner: fengyunzaidushi
- Created: 2026-06-22T06:59:49.000Z (21 days ago)
- Default Branch: main
- Last Pushed: 2026-07-05T13:01:42.000Z (8 days ago)
- Last Synced: 2026-07-05T15:03:19.913Z (8 days ago)
- Topics: agent-skills, codex-skill, content-first, knowledge-map, learning-tools, markdown, markmap, mindmap, repo-analysis, skills-sh
- Language: Python
- Homepage: https://skills.sh/fengyunzaidushi/markmap-skill
- Size: 144 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 内容优先 Markmap Skill
[](https://skills.sh/fengyunzaidushi/markmap-skill)
这是一个 Codex 可用的 agent skill，用来把项目、文档、代码库或概念整理成内容优先的 Markmap 思维导图。
它的重点不是用类别凑结构，而是让材料本身成为导图结构：先整体后局部，避免空泛分类标题，并把每个父节点的直接子节点默认控制在最多 5 个。只有用户明确允许更多分支时，才放宽这个上限。
## 安装
安装到当前项目的 Codex 技能目录：
```bash
npx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -y --copy
```
全局安装到 Codex：
```bash
npx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -g -y --copy
```
安装到当前项目里所有检测到的 agent：
```bash
npx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap --all --copy
```
安装完成后不应该只有 `SKILL.md`。这个 skill 至少应包含：
```text
SKILL.md
agents/openai.yaml
references/analogy-structure.md
scripts/validate_and_render.py
```
## 更新
推荐刷新当前项目的 Codex 安装：
```bash
npx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -y --copy
```
刷新全局 Codex 安装：
```bash
npx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -g -y --copy
```
刷新当前项目里所有检测到的 agent：
```bash
npx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap --all --copy
```
如果当前项目的 `skills-lock.json` 状态正常，也可以尝试：
```bash
npx skills update markmap-analogy-mindmap
```
项目级和全局级快捷命令：
```bash
npx skills update markmap-analogy-mindmap --project -y
npx skills update markmap-analogy-mindmap --global -y
```
如果 `skills update` 出现 `Failed to check for deleted skills` 或 `Failed to update`，使用上面的 `skills add ... -y --copy` 刷新命令。
## 使用
示例提示词：
```text
使用 $markmap-analogy-mindmap 分析这个仓库，按先整体后局部生成内容优先的 Markmap HTML。
```
这个 skill 会：
- 先检查源材料，再总结。
- 起草 Markmap 可用的 Markdown。
- 让每个节点优先使用材料里的真实概念、系统、流程、文件路径、API、主张或职责。
- 避免空泛分类标题。
- 将每个父节点的直接子节点默认控制在最多 5 个；只有用户明确允许更多分支时，才提高上限。
- 校验 Markdown 结构。
- 在可用时用 `markmap`、`npx markmap-cli` 或本机 Markmap checkout 渲染 HTML。
## 目录结构
```text
.
├── README.md
├── skills.sh.json
├── skills/
│ └── markmap-analogy-mindmap/
│ ├── SKILL.md
│ ├── agents/openai.yaml
│ ├── references/analogy-structure.md
│ └── scripts/validate_and_render.py
└── examples/
├── hindsight-analogy-markmap.md
└── hindsight-analogy-markmap.html
```
## 校验
校验 skill 元数据：
```bash
python3 /root/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/markmap-analogy-mindmap
```
校验生成的思维导图：
```bash
python3 skills/markmap-analogy-mindmap/scripts/validate_and_render.py examples/hindsight-analogy-markmap.md --validate-only
```
如果用户明确允许更多分支，可以在校验时指定上限：
```bash
python3 skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md --max-children 7 --validate-only
```
渲染 Markmap HTML：
```bash
python3 skills/markmap-analogy-mindmap/scripts/validate_and_render.py examples/hindsight-analogy-markmap.md -o examples/hindsight-analogy-markmap.html
```
## 示例
仓库内置示例把 Hindsight 记忆系统从整体目标展开到具体工作流和包结构：
- Hindsight 作为长期记忆系统
- Retain、Recall、Reflect 工作流
- 服务运行与存储层
- monorepo 包结构
- 对长篇小说记忆 agent 的启发
见 [`examples/hindsight-analogy-markmap.md`](examples/hindsight-analogy-markmap.md) 和 [`examples/hindsight-analogy-markmap.html`](examples/hindsight-analogy-markmap.html)。
## Topics
`codex-skill`, `agent-skills`, `skills-sh`, `markmap`, `mindmap`, `markdown`, `content-first`, `knowledge-map`, `repo-analysis`, `learning-tools`