tizhuang-local-banklisted
Install: claude install-skill weishao2/tizhuang-agent-skills
# 题庄 · 我的本地题库(教师版)
教师自用的本地工具:Markdown 是唯一真源,SQLite 只是可重建索引。Obsidian 与插件都是可选的。不创建学生账号、在线作答或作业。
## 先做这三件事(每次会话开头)
1. **定位工具**:以本 SKILL.md 所在目录的 `scripts/local_bank.py` 为 `<cli>`,用独立虚拟环境的 Python 为 `<python>`(Python 3.10+;优先读 `.tizhuang-install.json` 里的 `runtime.python`)。不要写死开发者的机器路径,不要把依赖装进别的 skill 环境。
2. **定位题库**:只用老师指定的目录;没有就建议在当前工作区新建 `题庄本地题库`。不猜已有 vault,不扫整盘。
3. **体检**(严格只读:`doctor.py`、`status`、`show`、`search` 都不写任何文件,不刷新索引;要刷新首页/索引用 `dashboard`):
```text
<python> <skill>/scripts/doctor.py --vault <vault>
```
环境缺失时它只依赖标准库也能运行,并给出修复命令;环境正常则带出题量、待核对、待分类、知识树和**下一步建议**。需要安装/升级/修复时读 [安装](references/install.md);安装完成后必须再体检一次,通过才算装好。老师自己也可在插件设置里点“检查环境”。
所有命令格式:`<python> <cli> --vault <vault> <命令> ...`,输出 JSON。`ok:false` 或退出码非 0 就是失败:读 `error` 与 `hint`,修好原因再继续,**不要静默放宽筛选条件,不要重复执行写入命令**。V1 是中文子串+结构化检索,不要声称有向量/语义检索;单写入者,写操作要串行。
## 怎么跟老师说话
- 用老师的话汇报:“已存入 12 道题,其中 3 道还没有答案”,而不是贴 JSON、ID 或命令。
- 一次只问阻塞性的问题(学科学段、教材版本、题库位置);能从 `status` 和已有数据判断的不要问。
- 每次写入后回报三件事:做了什么、文件/题目在哪、还差什么(待核对?待分类?)。路径用老师的真实 vault 路径。
- 不确定就如实说“不确定”,并把原因写进待核对,不要编。
- 对话示例与常见问题话术见 [对话指南](references/conversation-guide.md);给新老师做使用介绍时分享 [图文说明](https://github.com/weishao2/tizhuang-agent-skills/blob/main/docs/local-bank/USER_GUIDE.md)(起步包内有离线 `先看这里.html`)。
## 常见任务 → 怎么走
| 老师想做的事 | 做法 |
| --- | --- |
| 初始化 / 整理旧题库 | `init`;已有中文题库 `organize`(自动完整备份);`dashboard` 刷新首页;`repair-papers` 修复旧打印稿入口。英文旧目录先 `migrate-cn`。不要自己搬文件夹。→ [教师工作台](references/teacher-workspace.md) |
| 下载知识树 / 教材章节 | `catalog` → `tree` / `editio