mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-11 03:00:45 +08:00
oliver
5f68afa963
自动安装/创建的 workspace 技能统一落在 _workspace 目录，并在启用受信开关时自动启用和绑定到 manager+各专家；同时补充 API 返回状态与回归测试。 Made-with: Cursor
65 lines
2.3 KiB
Markdown
65 lines
2.3 KiB
Markdown
# skills 目录说明
|
||
|
||
本目录是项目内默认 Skills 根目录（中文优先）。
|
||
|
||
## 约定
|
||
- 每个技能建议独立子目录，目录内放 `SKILL.md`。
|
||
- `SKILL.md` 建议包含 frontmatter（`name`、`description`、`metadata`）。
|
||
- 技能说明正文请优先使用中文，便于团队统一维护。
|
||
|
||
## 示例结构
|
||
- `oclaw/runtime/skills/<skill_name>/SKILL.md`
|
||
|
||
## 目录分层（重要）
|
||
- **主目录**：`oclaw/runtime/skills/<skill_name>/`
|
||
用于官方/手工管理的稳定技能（安装、维护、评审都在这层）。
|
||
- **自写目录**：`oclaw/runtime/skills/_workspace/<skill_name>/`
|
||
用于 agent 自写/自动安装技能，和主目录隔离，避免混放。
|
||
|
||
说明：
|
||
- `auto_install_skill_from_payload` 产物默认落在 `_workspace` 下。
|
||
- 这样可以把“生产稳定技能”和“实验/自写技能”分开治理，便于审计与回滚。
|
||
|
||
## 兼容说明
|
||
- 运行时优先读取 `oclaw/runtime/skills`。
|
||
- 若设置了环境变量 `AIA_SKILLS_ROOT`，以该变量为准。
|
||
- 为兼容旧工程，仍可回退读取旧路径 `oclaw/runtime/skills/`（如存在）。
|
||
|
||
## 推荐实用 Skills（workspace）
|
||
|
||
以下为当前已落地并可直接在 Admin `Test run` 使用的实用技能：
|
||
|
||
### 1) `incident_triage`
|
||
- **用途**：对报错/日志做故障归因（timeout、permission、network 等）并给出行动建议。
|
||
- **输入参数示例**：
|
||
```json
|
||
{
|
||
"error": "TimeoutError: connection refused to upstream service"
|
||
}
|
||
```
|
||
- **典型输出**：`category`、`severity`、`summary`、`action_items`、`confidence`。
|
||
|
||
### 2) `release_checklist`
|
||
- **用途**：发版前门禁检查，输出是否可发版和阻塞项。
|
||
- **输入参数示例**：
|
||
```json
|
||
{
|
||
"tests_passed": true,
|
||
"lint_passed": true,
|
||
"migration_reviewed": true,
|
||
"rollback_plan_ready": true,
|
||
"monitoring_ready": true
|
||
}
|
||
```
|
||
- **典型输出**：`release_ready`、`failed_checks`、`missing_required_inputs`、`action_items`。
|
||
|
||
### 3) `data_extract_summary`
|
||
- **用途**：从文本/日志中抽取重点、统计级别并生成摘要建议。
|
||
- **输入参数示例**：
|
||
```json
|
||
{
|
||
"text": "INFO boot complete\nWARN cache miss\nERROR timeout connecting service",
|
||
"max_lines": 8
|
||
}
|
||
```
|
||
- **典型输出**：`summary`、`line_count`、`level_counts`、`top_keywords`、`action_items`。
|