{"id":51621429,"url":"https://github.com/fengyunzaidushi/markmap-skill","last_synced_at":"2026-07-12T20:30:57.134Z","repository":{"id":366542664,"uuid":"1276645635","full_name":"fengyunzaidushi/markmap-skill","owner":"fengyunzaidushi","description":"生成先整体后局部、每层默认最多 5 个分支的内容优先 Markmap 思维导图","archived":false,"fork":false,"pushed_at":"2026-07-05T13:01:42.000Z","size":147,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-05T15:03:19.913Z","etag":null,"topics":["agent-skills","codex-skill","content-first","knowledge-map","learning-tools","markdown","markmap","mindmap","repo-analysis","skills-sh"],"latest_commit_sha":null,"homepage":"https://skills.sh/fengyunzaidushi/markmap-skill","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fengyunzaidushi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-22T06:59:49.000Z","updated_at":"2026-07-05T13:02:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fengyunzaidushi/markmap-skill","commit_stats":null,"previous_names":["fengyunzaidushi/markmap-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fengyunzaidushi/markmap-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengyunzaidushi%2Fmarkmap-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengyunzaidushi%2Fmarkmap-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengyunzaidushi%2Fmarkmap-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengyunzaidushi%2Fmarkmap-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fengyunzaidushi","download_url":"https://codeload.github.com/fengyunzaidushi/markmap-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengyunzaidushi%2Fmarkmap-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35402741,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-12T02:00:06.386Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","codex-skill","content-first","knowledge-map","learning-tools","markdown","markmap","mindmap","repo-analysis","skills-sh"],"created_at":"2026-07-12T20:30:55.963Z","updated_at":"2026-07-12T20:30:57.122Z","avatar_url":"https://github.com/fengyunzaidushi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 内容优先 Markmap Skill\n\n[![skills.sh](https://skills.sh/b/fengyunzaidushi/markmap-skill)](https://skills.sh/fengyunzaidushi/markmap-skill)\n\n这是一个 Codex 可用的 agent skill，用来把项目、文档、代码库或概念整理成内容优先的 Markmap 思维导图。\n\n它的重点不是用类别凑结构，而是让材料本身成为导图结构：先整体后局部，避免空泛分类标题，并把每个父节点的直接子节点默认控制在最多 5 个。只有用户明确允许更多分支时，才放宽这个上限。\n\n## 安装\n\n安装到当前项目的 Codex 技能目录：\n\n```bash\nnpx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -y --copy\n```\n\n全局安装到 Codex：\n\n```bash\nnpx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -g -y --copy\n```\n\n安装到当前项目里所有检测到的 agent：\n\n```bash\nnpx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap --all --copy\n```\n\n安装完成后不应该只有 `SKILL.md`。这个 skill 至少应包含：\n\n```text\nSKILL.md\nagents/openai.yaml\nreferences/analogy-structure.md\nscripts/validate_and_render.py\n```\n\n## 更新\n\n推荐刷新当前项目的 Codex 安装：\n\n```bash\nnpx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -y --copy\n```\n\n刷新全局 Codex 安装：\n\n```bash\nnpx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap -a codex -g -y --copy\n```\n\n刷新当前项目里所有检测到的 agent：\n\n```bash\nnpx skills add fengyunzaidushi/markmap-skill --skill markmap-analogy-mindmap --all --copy\n```\n\n如果当前项目的 `skills-lock.json` 状态正常，也可以尝试：\n\n```bash\nnpx skills update markmap-analogy-mindmap\n```\n\n项目级和全局级快捷命令：\n\n```bash\nnpx skills update markmap-analogy-mindmap --project -y\nnpx skills update markmap-analogy-mindmap --global -y\n```\n\n如果 `skills update` 出现 `Failed to check for deleted skills` 或 `Failed to update`，使用上面的 `skills add ... -y --copy` 刷新命令。\n\n## 使用\n\n示例提示词：\n\n```text\n使用 $markmap-analogy-mindmap 分析这个仓库，按先整体后局部生成内容优先的 Markmap HTML。\n```\n\n这个 skill 会：\n\n- 先检查源材料，再总结。\n- 起草 Markmap 可用的 Markdown。\n- 让每个节点优先使用材料里的真实概念、系统、流程、文件路径、API、主张或职责。\n- 避免空泛分类标题。\n- 将每个父节点的直接子节点默认控制在最多 5 个；只有用户明确允许更多分支时，才提高上限。\n- 校验 Markdown 结构。\n- 在可用时用 `markmap`、`npx markmap-cli` 或本机 Markmap checkout 渲染 HTML。\n\n## 目录结构\n\n```text\n.\n├── README.md\n├── skills.sh.json\n├── skills/\n│   └── markmap-analogy-mindmap/\n│       ├── SKILL.md\n│       ├── agents/openai.yaml\n│       ├── references/analogy-structure.md\n│       └── scripts/validate_and_render.py\n└── examples/\n    ├── hindsight-analogy-markmap.md\n    └── hindsight-analogy-markmap.html\n```\n\n## 校验\n\n校验 skill 元数据：\n\n```bash\npython3 /root/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/markmap-analogy-mindmap\n```\n\n校验生成的思维导图：\n\n```bash\npython3 skills/markmap-analogy-mindmap/scripts/validate_and_render.py examples/hindsight-analogy-markmap.md --validate-only\n```\n\n如果用户明确允许更多分支，可以在校验时指定上限：\n\n```bash\npython3 skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md --max-children 7 --validate-only\n```\n\n渲染 Markmap HTML：\n\n```bash\npython3 skills/markmap-analogy-mindmap/scripts/validate_and_render.py examples/hindsight-analogy-markmap.md -o examples/hindsight-analogy-markmap.html\n```\n\n## 示例\n\n仓库内置示例把 Hindsight 记忆系统从整体目标展开到具体工作流和包结构：\n\n- Hindsight 作为长期记忆系统\n- Retain、Recall、Reflect 工作流\n- 服务运行与存储层\n- monorepo 包结构\n- 对长篇小说记忆 agent 的启发\n\n见 [`examples/hindsight-analogy-markmap.md`](examples/hindsight-analogy-markmap.md) 和 [`examples/hindsight-analogy-markmap.html`](examples/hindsight-analogy-markmap.html)。\n\n## Topics\n\n`codex-skill`, `agent-skills`, `skills-sh`, `markmap`, `mindmap`, `markdown`, `content-first`, `knowledge-map`, `repo-analysis`, `learning-tools`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffengyunzaidushi%2Fmarkmap-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffengyunzaidushi%2Fmarkmap-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffengyunzaidushi%2Fmarkmap-skill/lists"}