SuperAPI AI 工具集

soia-pkm-clip-github-repo

通用与其它

查看项目

更新于 10-16 08:37

技能介绍

用途:把散落的 GitHub 开源仓库调研沉淀为 Obsidian vault 内可筛选、可跳转的「开源项目图书馆」索引层。代码本体保留在 vault 外的本机 git clone 目录,vault 只存索引:一仓一张项目卡加一篇调研笔记骨架。

主要能力:

  1. 单仓归档:解析仓库 URL,若 upstream 目录下不存在则 git clone,失败(私有仓库、无权限、网络问题)时跳过 clone,仅用 URL 生成最小卡并提示手动处理;随后建/更新项目卡,并新建调研笔记骨架(已有则跳过),通过 关联仓库 字段与卡片「## 关联调研」形成双向链接。
  2. 批量刷新:扫描 upstream 下每个子目录,逐仓生成或更新项目卡,幂等刷新自动字段,不覆盖人工字段。
  3. 字段分工:自动字段(github、分类、语言、本地路径、访问链接、最近提交、正文简介、关联调研)每次重跑刷新;人工字段(用途、状态、stars、正文「## 我的笔记」)不被覆盖。分类未命中映射表时按 README 或仓名启发式归类,兜底「工具其他」;正文简介取自 README 首句叙述性句子,抓不到留 (待补描述)。

使用方式: 安装技能:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-clip-github-repo -y 单仓归档:python3 scripts/gen_repo_catalog.py --add https://github.com/<owner>/<repo> --upstream <upstream目录> --vault <vault路径> 批量刷新:python3 scripts/gen_repo_catalog.py --upstream <upstream目录> --vault <vault路径> 可用 --notes-dir <相对路径> 覆盖调研笔记目录(默认 60_开源项目/10_调研笔记)。

前置与配置:需要 Obsidian vault 及 60_开源项目/00_图书馆/项目卡/、60_开源项目/10_调研笔记/ 两个子目录;本机一个存放 clone 仓库的 upstream 目录;Python 3,纯 stdlib,无第三方依赖。vault 定位优先级为命令行 --vault 高于环境变量 OBSIDIAN_VAULT;upstream 定位为 --upstream 高于私有配置中的 SOIA_REPO_UPSTREAM_DIR。私有配置可选,路径优先级为 SOIA_PKM_CLIP_GITHUB_REPO_CONFIG_FILE(兼容别名 SOIA_PKM_CLIP_REPO_CONFIG_FILE、SOIA_PKM_CLIP_REPO_ENV_FILE)高于 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-clip-github-repo/config.yml;密钥、cookie、session 只能放私有配置或环境,不得写入仓库、vault 正文或日志。

适用场景:需要把看过或调研过的开源项目集中成可筛选索引、并区分机器自动维护字段与人为判断字段的 Obsidian 用户。

限制:深度调研(填满笔记正文)不在本技能自动化范围,需后续单独完成;不适用于 upstream 之外、不打算 clone 的项目;未指定 vault 与 upstream 且私有配置未设时报错提示,不静默使用写死路径;涉及删除、覆盖、发送、发布等动作应先预览或确认;价格、收费、平台支持等资料暂未提供。