chore: skills - link claude official skills repo
This commit is contained in:
parent
bc1c9c284e
commit
bb971fe8f9
|
|
@ -4,3 +4,6 @@
|
||||||
[submodule "libs/external/tmux"]
|
[submodule "libs/external/tmux"]
|
||||||
path = libs/external/tmux
|
path = libs/external/tmux
|
||||||
url = https://github.com/tmux/tmux.git
|
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
|
||||||
|
|
|
||||||
|
|
@ -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 替换为本地绝对路径软链接(会导致他人环境不可用)
|
||||||
|
|
||||||
|
|
@ -0,0 +1 @@
|
||||||
|
Subproject commit 1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563
|
||||||
|
|
@ -17,6 +17,11 @@ skills/
|
||||||
└── skills-skills/ # 元技能:生成/校验/脚手架化其它技能
|
└── skills-skills/ # 元技能:生成/校验/脚手架化其它技能
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## 外部仓库引用(约定)
|
||||||
|
|
||||||
|
- 允许在 `skills/` 下放置“只读引用”的软链接,用于引入外部权威仓库的内容(便于统一索引与检索)。
|
||||||
|
- 为保证可复现性:软链接目标必须落在仓库内,并优先使用 Git submodule 管理(避免链接到个人机器的绝对路径)。
|
||||||
|
|
||||||
## 模块职责与边界
|
## 模块职责与边界
|
||||||
|
|
||||||
- 每个 `<skill-name>/` 必须以 `SKILL.md` 作为入口,明确:
|
- 每个 `<skill-name>/` 必须以 `SKILL.md` 作为入口,明确:
|
||||||
|
|
@ -45,3 +50,4 @@ skills/
|
||||||
- `skills/sop-generator/`:SOP 生成与规范化
|
- `skills/sop-generator/`:SOP 生成与规范化
|
||||||
- `skills/markdown-to-epub/`:Markdown → EPUB 稳定构建
|
- `skills/markdown-to-epub/`:Markdown → EPUB 稳定构建
|
||||||
- `skills/skills-skills/`:元技能(技能生成/校验/脚手架)
|
- `skills/skills-skills/`:元技能(技能生成/校验/脚手架)
|
||||||
|
- `skills/claude-official-skills/`:Claude 官方 skills 仓库(Anthropic)的软链接入口
|
||||||
|
|
|
||||||
|
|
@ -54,6 +54,11 @@
|
||||||
|:---|:---|
|
|:---|:---|
|
||||||
| [markdown-to-epub](./markdown-to-epub/SKILL.md) | Markdown 转 EPUB 电子书 |
|
| [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
|
```bash
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1 @@
|
||||||
|
../libs/external/claude-official-skills
|
||||||
Loading…
Reference in New Issue