zk-data-agent/docs/task-001-directory-skills.md

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：

---
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 实现。