✨ feat(skills_linker): 添加一键安装脚本。

This commit is contained in:
--global committed 2026-10-02 01:00:09 +08:00
1 parent 2ce3f0173d
commit 707a6f1ef1
3 files changed
+445 -3

No files matched your search

+21 -3
View File
@@ -33,7 +33,7 @@
- 🧩 **开箱即用**:每个技能自带完整提示词(`SKILL.md`)与接口策略(`agents/openai.yaml`),复制即用、无需额外依赖。
- 🗂️ **分层分类**:按「开发与规范 → 测试与修复 → 交付与部署 → 全自动化」四层递进组织,形成完整质量闭环。
- 🔗 **技能互链**:技能之间通过 `/技能名` 相互调用(如 `ci-cd-pipeline` 可串联 13 个子技能),可组装成自动化流水线。
- 🚀 **一键安装**:`skills_linker.sh` 将分类目录下全部技能软链接到 `~/.agents/skills/`,全局可用。
- 🚀 **一键安装**:`skills_linker.sh`(Linux / macOS)与 `skills_linker.bat`(Windows)将分类目录下全部技能链接到 `~/.agents/skills/`,全局可用。
- 📊 **可观测可审计**:每个技能输出带时间戳的结构化 Markdown 报告(`*_<timestamp>.md`),全程留痕、便于审计。
- 🛡️ **安全优先**:内置强制安全规则——生产环境保护、敏感信息脱敏、最小权限、人工确认点。
@@ -43,7 +43,8 @@
```text
AgentSkills/
├── skills_linker.sh # 一键安装脚本(软链接到 ~/.agents/skills/)
├── skills_linker.sh # 一键安装脚本 Linux/macOS(软链接到 ~/.agents/skills/)
├── skills_linker.bat # 一键安装脚本 Windows(junction / 符号链接)
├── README.md # 项目说明(本文件)
├── development-and-standards/ # ① 开发与规范(6 个技能)
│ ├── readme-generator/ # README 生成器
@@ -115,6 +116,23 @@ chmod +x skills_linker.sh
>
> `skills_linker.sh` 会跳过指向不同目标的同名已存在链接(打印警告),不会覆盖非符号链接目录,可安全重复执行。
#### 🪟 Windows
在仓库根目录双击 `skills_linker.bat`,或在 cmd / PowerShell 中执行:
```bat
skills_linker.bat :: 链接全部技能(默认目标 %USERPROFILE%\.agents\skills)
skills_linker.bat /n :: 预演,只打印计划,不写入不删除
skills_linker.bat /u :: 卸载,只删除指向本仓库的链接
skills_linker.bat /? :: 查看全部选项
```
> [!NOTE]
>
> Windows 版优先使用目录联接(junction),无需管理员权限或开发者模式;不可用时自动回退到符号链接,网络路径请用 `/c` 复制模式。已存在且指向同一技能会跳过、指向别处会替换、同名普通目录只告警不覆盖,同样可安全重复执行。
>
> 脚本输出为纯 ASCII 英文:cmd.exe 按**当前控制台代码页**解码批处理文件,中文 Windows 的 936 控制台(含资源管理器双击)与 PowerShell 7 的 65001 控制台无法用同一份非 ASCII 字节同时正确显示,而纯 ASCII 在任何代码页下都一致。
### 3️⃣ 在 Agent 中调用
在支持 Skills 的 AI 编码工具(如 Claude Code、VS Code Copilot Chat 等)中,直接以技能名唤起即可,例如 `/blackbox-tester`、`/ci-cd-pipeline`。
@@ -247,7 +265,7 @@ flowchart LR
1. 每个技能放在对应分类目录下,包含 `SKILL.md` 与 `agents/openai.yaml`。
2. `SKILL.md` 至少包含:角色与描述、工作流程、行为准则、输出格式。
3. 涉及破坏性或副作用操作的技能,务必在 `openai.yaml` 中设置 `require_confirmation: true`。
4. 新增技能后,可运行 `./skills_linker.sh` 验证安装脚本兼容性。
4. 新增技能后,可运行 `./skills_linker.sh`(Windows 上运行 `skills_linker.bat /n` 预演)验证安装脚本兼容性。
<!-- TODO: 补充 CONTRIBUTING.md 与具体的贡献模板 -->