diff --git a/.gitmodules b/.gitmodules index 0665e11..1b3e92c 100644 --- a/.gitmodules +++ b/.gitmodules @@ -4,3 +4,6 @@ [submodule "libs/external/tmux"] path = libs/external/tmux url = https://github.com/tmux/tmux.git +[submodule "libs/external/claude-official-skills"] + path = libs/external/claude-official-skills + url = https://github.com/anthropics/skills.git diff --git a/libs/external/AGENTS.md b/libs/external/AGENTS.md new file mode 100644 index 0000000..b36926c --- /dev/null +++ b/libs/external/AGENTS.md @@ -0,0 +1,27 @@ +# libs/external/ 目录 Agent 指南 + +本目录用于收纳 **外部工具/第三方项目**(含 Git submodule),保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新。 + +## 目录结构(约定) + +```text +libs/external/ +├── AGENTS.md # 本文件(目录级行为准则) +├── README.md # 外部工具索引 +├── .tmux/ # submodule:oh-my-tmux 配置 +├── tmux/ # submodule:tmux 源码 +└── claude-official-skills/ # submodule:Claude 官方 skills 仓库(Anthropic) +``` + +## 操作规范 + +### 允许 + +- 新增外部依赖(优先 Git submodule,确保可复现) +- 更新 submodule 指针(明确记录上游来源与用途) + +### 禁止 / 不推荐 + +- 直接复制粘贴大型第三方仓库内容到主仓库(优先 submodule) +- 将 submodule 替换为本地绝对路径软链接(会导致他人环境不可用) + diff --git a/libs/external/claude-official-skills b/libs/external/claude-official-skills new file mode 160000 index 0000000..1ed29a0 --- /dev/null +++ b/libs/external/claude-official-skills @@ -0,0 +1 @@ +Subproject commit 1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563 diff --git a/skills/AGENTS.md b/skills/AGENTS.md index fb98206..0d13206 100644 --- a/skills/AGENTS.md +++ b/skills/AGENTS.md @@ -17,6 +17,11 @@ skills/ └── skills-skills/ # 元技能:生成/校验/脚手架化其它技能 ``` +## 外部仓库引用(约定) + +- 允许在 `skills/` 下放置“只读引用”的软链接,用于引入外部权威仓库的内容(便于统一索引与检索)。 +- 为保证可复现性:软链接目标必须落在仓库内,并优先使用 Git submodule 管理(避免链接到个人机器的绝对路径)。 + ## 模块职责与边界 - 每个 `/` 必须以 `SKILL.md` 作为入口,明确: @@ -45,3 +50,4 @@ skills/ - `skills/sop-generator/`:SOP 生成与规范化 - `skills/markdown-to-epub/`:Markdown → EPUB 稳定构建 - `skills/skills-skills/`:元技能(技能生成/校验/脚手架) +- `skills/claude-official-skills/`:Claude 官方 skills 仓库(Anthropic)的软链接入口 diff --git a/skills/README.md b/skills/README.md index 8f599ee..31af88b 100644 --- a/skills/README.md +++ b/skills/README.md @@ -54,6 +54,11 @@ |:---|:---| | [markdown-to-epub](./markdown-to-epub/SKILL.md) | Markdown 转 EPUB 电子书 | +## 外部技能仓库(软链接) + +- `skills/claude-official-skills/`:来自 Claude 官方 skills 仓库(Anthropic)。本仓库以 Git submodule 的形式落在 `libs/external/claude-official-skills/`,并通过软链接暴露到 `skills/` 下便于浏览与复用。 +- 初始化/更新方式:`git submodule update --init --recursive` + ## 快速使用 ```bash diff --git a/skills/claude-official-skills b/skills/claude-official-skills new file mode 120000 index 0000000..db4fcfb --- /dev/null +++ b/skills/claude-official-skills @@ -0,0 +1 @@ +../libs/external/claude-official-skills \ No newline at end of file