Sub-skills 参考
Sub-skills 是 AutoPku 的功能原子单元，按职责分为 Tasks（任务流）、Tools（可复用工具）和 Runtime（运行时抽象）三类。
Tasks 任务执行流
Tasks 面向终端用户意图，每个 task 对应一个完整的端到端工作流。
| 任务 | 文件 | 说明 |
|---|---|---|
| 同步通知 | tasks/sync-notices.md |
获取作业/公告，生成摘要，并行处理课程 |
| 完成作业 | tasks/do-homework.md |
解析 PDF → 解答 → 渲染 → 询问用户 → 提交 |
| 撰写笔记 | tasks/write-notes.md |
从课件提取数学核心，去除噪声 |
💡 扩展指南：新增 Task
在 sub-skills/tasks/ 下新建 <your-task>.md，描述触发条件、执行步骤、输入输出。然后在 skill.md 主入口中注册意图匹配规则。
Tools 可复用工具
Tools 提供底层能力封装，供 Tasks 或开发者直接调用。
| 工具 | 文件 | 说明 |
|---|---|---|
| pku3b 配置 | tools/pku3b-setup.md |
安装、登录、命令参考 |
| 数据解析 | tools/data-parser.md |
ANSI 颜色码处理、正则提取 |
| PDF 读取 | tools/pdf-reader.md |
PyMuPDF / pdfplumber 代码示例 |
| Agent 模板 | tools/agent-helpers.md |
Coordinator / Parser / Solver / Writer / Submitter Prompts |
💡 扩展指南：新增 Tool
在 sub-skills/tools/ 下新建工具文档，提供可复用的代码片段、配置模板或封装函数。建议在文档顶部标注依赖版本。
Runtime 运行时抽象
Runtime 层屏蔽不同 AI 平台的语法差异，使上层 Tasks 无需关心当前运行在哪个环境中。
| 运行时 | 文件 | 说明 |
|---|---|---|
| 环境检测 | runtime/_detect.md |
自动检测 Claude / Codex / Kimi / Fallback |
| Agent 创建 | runtime/create-agent.md |
统一跨平台 Agent 创建接口 |
| Claude Team | runtime/claude-team.md |
Claude Code Agent Team 语法 |
| Codex Subagent | runtime/codex-subagent.md |
Codex native subagent 语法 |
| Kimi Team | runtime/kimi-team.md |
Kimi Code CLI Agent Team 语法 |
💡 扩展指南：新增 Runtime
当未来出现新的 AI 运行时时，在 sub-skills/runtime/ 下新增平台适配文档，并更新 _detect.md 的检测逻辑和 create-agent.md 的统一接口。
文件命名规范
- 使用小写字母，单词间用连字符
-分隔 - 运行时检测文件使用下划线前缀：
_detect.md - 每个 sub-skill 文件应自包含：说明、示例、边界条件