# 通用skill

**Repository Path**: djsijdbxbsjs/universal-skill

## Basic Information

- **Project Name**: 通用skill
- **Description**: java编码通用skill
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Universal Skill Library

个人 Agent 技能仓库：技能源码集中存放于此，通过软链接分发到
`~/.agents/skills/`（Qoder / Claude Code 等 harness 的技能发现目录），
一处修改、处处生效。

## 架构：平铺 + 领域路由（两级）

技能对 Agent 的可见性由「注入」决定：每个被链接的技能，其 frontmatter 的
name + description 会注入每次会话的系统提示（常驻成本）；SKILL.md 全文只在
命中后才加载。本仓库用两种形态控制注入成本：

| 形态 | 结构 | 注入成本 | 适用 |
|---|---|---|---|
| 平铺技能 | 直接链接的普通技能目录 | 每技能 1 行 | 高频技能（如编码规范、代码审查） |
| 领域 router | 目录自身含 SKILL.md（正文为路由表），子技能不链接 | 每领域 1 行 | 长尾领域，子技能可无限扩展 |

Agent 检索路径：系统提示里的技能列表 → 命中后加载该技能 SKILL.md 全文 →
router 再按路由表用 Read 加载子技能全文执行。子技能保持零注入，
整体注入成本 = O(领域数) 而非 O(技能数)。

## 技能清单

下表由 `./gen-readme.sh` 从各 SKILL.md 的 frontmatter 自动生成，请勿手改表格内容；
新增或调整技能后运行该脚本刷新。

<!-- SKILLS:BEGIN -->
| 技能 | 类型 | 能力 | 位置 |
|---|---|---|---|
| coding-standards | 平铺 | 代码生成强制规范。任何产出或改动代码的任务（新功能、修 Bug、重构、写脚本、实现需求、优化代码）都必须先加载本技能再动手。 | `ai-code/coding-standards` |
| code-review | 平铺 | 多维度代码审查与质量评估。在合并任何变更前使用。 | `ai-code/code-review` |
| tech-design | 平铺 | 技术方案生成规范。编码前的方案设计技能：新功能、重构、技术选型、跨模块改造等需要"先出方案再动手"的任务， 先加载本技能产出决策完备的技术方案文档，经用户评审确认后再转交 /coding-standards 实施。 | `ai-code/tech-design` |
| use-playwright | 平铺 | 统一使用 browser-use MCP（Chrome DevTools MCP 类工具集）处理所有需要浏览器访问的场景，包括访问本地文档、网页浏览、页面交互、截图、获取页面内容等。 | `use-playwright` |
| grill-me | 平铺 | 通过交互式问答（Interview）与用户对齐设计方案，梳理和解决设计决策与依赖关系。 | `ai-code/grill-me` |
| security | router（1 子技能） | 安全领域路由器：功能测试与安全审计任务的统一入口。 | `ai-code/security` |
| └ security-scan-report | 子技能 | 分析安全扫描报告（阿里云 Flow 等平台）中的中高危问题并定位代码根因。覆盖报告读取 （需登录态平台走本地 Chrome CDP）、危险项清单化、代码取证、归因分类与修复建议输出。 | `ai-code/security/security-scan-report` |
| office-tools | router（2 子技能） | 办公工具领域路由器：企业导入导出（Excel）与语雀文档同步任务的统一入口。 | `ai-code/office-tools` |
| └ excel-generate | 子技能 | Implements import/export via the enterprise Import/Export Center and busyming-import-export-api. Covers layer structure, naming conventions, template download, import/export task APIs, callback validation, failed rows, and paginated export. | `ai-code/office-tools/excel-generate` |
| └ yuque-paste | 子技能 | 通过 Playwright MCP 将 Markdown 内容粘贴到语雀文档中。 当需要将代码、文档、skill 等 Markdown 内容同步到语雀时使用。 | `ai-code/office-tools/yuque-paste` |
<!-- SKILLS:END -->

## 分发（link-skills.sh）

```bash
./link-skills.sh                # 按 skills.manifest 链接到 ~/.agents/skills/
./link-skills.sh --dry-run      # 预览将要执行的操作
./link-skills.sh --undo         # 删除本仓库建立的软链接
./link-skills.sh /path/to/dir   # 链接到指定目录
```

`skills.manifest` 每行一个条目，两种语义（脚本自动判定）：直接含 SKILL.md 的
目录（平铺技能或 router），或类别目录（递归其子目录）。
**router 的子技能永远不写进 manifest**——一旦被平铺链接就会恢复顶层注入，
破坏零注入设计。

注意：`~/.qoder/skills/`（Qoder 全局技能目录）与 `~/.agents/skills/` 是两个
独立注册源。技能收进 router 后，记得清理另一处的旧注册副本，否则它仍会被
顶层注入。

## 新增技能

**新增平铺技能：**

1. 建目录，写 `SKILL.md`（frontmatter `name` 必须等于目录名）；
2. `skills.manifest` 追加该目录路径；
3. 执行 `./link-skills.sh && ./gen-readme.sh`。

**新增 router 子技能：**

1. 在对应 router 目录下建子目录，写 `SKILL.md`；
2. router 的路由表追加一行（「任务特征」写用户真实会说的词汇，含中英文关键词
   与代码符号），并把关键词同步补进 router frontmatter 的 description；
3. 执行 `./gen-readme.sh` 刷新清单。

（不改 manifest、不跑 link-skills.sh——router 目录已整体链接，子技能经
相对路径即达。）