skills/README.txt

41 lines
1.8 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Personal Agent Skills Incubator
本项目是个人 AI Agent 技能的孵化器。
## 技能用途
编写的技能不绑定特定项目业务逻辑,而是通用能力,可移植到多种 AI Agent 平台:
- **Claude Code** — 放在 `~/.claude/skills/<skill-name>/SKILL.md`
- **Cursor** — 放在 `.cursor/skills/<skill-name>/SKILL.md`
- **OpenClaw / Workbuddy / Codex** — 遵循各自技能目录规范
## 移植方式
将技能文件夹从本项目复制到目标 Agent 的技能目录下即可,**不需要删除本项目中的技能**。
本项目是技能的"母版库",每次移植都是借鉴复制到目标环境,源文件保留不动。
## 技能列表
### 日志查询类
| 技能名 | 说明 | 环境变量 |
|--------|------|----------|
| `bms-log-test-query` | 查询 BMS 测试 (bms-sit) 应用日志,通过 Kibana (`http://172.17.12.18:8000`) 代理访问 ES索引 `bms-test-*`,日均 200 万条 | `BMS_LOG_TEST_*` |
| `bms-log-prd-query` | 查询 BMS 生产 (bms-prod) 日志,通过 Kibana (`https://kiblog.qx.com`) 代理访问 ES索引 `bmslog-bms-prod-*`,日均 1000 万条 | `BMS_LOG_PRD_*` |
### 数据库查询类
| 技能名 | 说明 |
|--------|------|
| `bms-mysql-test` | 连接 BMS 测试 MySQL 数据库,支持 SELECT 直接执行INSERT/UPDATE/DELETE/DDL 需 Windows 弹窗确认 |
| `bms-mysql-prd` | 连接 BMS 生产 MySQL 数据库,只读模式,禁止任何写操作/DDL |
## 新增技能规范
1. **在当前项目根目录下创建**`<skill-name>/SKILL.md`(直接在项目根目录建文件夹)
2. 编写 `SKILL.md`,包含连接信息、查询模板、使用规则
3. 凭据统一存放在 `~/.env` 中,不在技能文件里写密码
4. 环境变量加技能名前缀(如 `BMS_LOG_TEST_*`、`BMS_LOG_PRD_*`),避免冲突
5. 完成后同步复制到 `~/.claude/skills/` 使全局生效