Files
zk-data-agent/docs/task-001-directory-skills.md
T
2026-04-28 10:17:23 +08:00

44 lines
1.4 KiB
Markdown
Raw 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.
# Task 001:目录化 Skills
## 目标
把 skill 内容从 Python 内置字符串迁移到文件目录中,让 data-agent 工作流可以用文件形式开发、review 和维护。
## 范围
- 保持当前 `Skill` 工具和 agent loop 不变。
- 支持从 `src/skills/bundled/*/SKILL.md` 加载内置目录化 skill。
- 保持 Python 动态 skill 可用。
- 使用已有内置 skill 作为迁移样例。
## 第一批切片
- `simplify``debug` 继续保留 Python 实现,因为它们需要读取动态运行时数据。
- `verify``update-config` 迁移到目录化 skill。
- `SKILL.md` 支持简单 front matter
```text
---
name: verify
description: Verify a code change works by running the app and tests.
when_to_use: When the user asks to verify, test, or check that recent changes work.
allowed_tools: read_file, bash, grep_search, glob_search
---
Skill prompt body...
```
## 成功标准
- `/skills` 仍然能列出迁移后的 skills。
- Web UI `/api/skills` 仍然能返回迁移后的 skills。
- `Skill({"skill": "verify"})` 返回 `SKILL.md` 中的 prompt 正文。
- 现有 Python 动态 skills 仍然可用。
## 当前状态
- 目录化 skill loader 已在 `src/bundled_skills.py` 实现。
- `verify` 已迁移到 `src/skills/bundled/verify/SKILL.md`
- `update-config` 已迁移到 `src/skills/bundled/update-config/SKILL.md`
- 动态 skills `simplify``debug` 继续保持 Python 实现。