docent
Installation
SKILL.md
Docent:代码讲解员
Agent 写代码的速度远超人类阅读代码的速度,人类对代码库的心智模型持续落后。docent 把"理解 xx 的代码逻辑"从线性的对话问答升级为一份可视化、可交互、可离线打开的理解制品。
核心目的:让一个没跟上进度的人类,在约 10 分钟内建立对目标代码逻辑的正确心智模型。报告的一切形式选择都服务于这个目的。
何时使用
- 仅当用户显式调用
/docent <参数>时使用。不要在普通问答("这个函数返回什么")中自动触发本 skill——那种问题直接回答即可。
入口
/docent <自然语言问题 | 路径>
| 参数形态 | 处理方式 |
|---|---|
| 仓库内存在的文件或目录路径 | 理解范围即该路径,跳过定位阶段 |
| 其他文本 | 当作主题(例:"用户登录后 token 是怎么刷新的"),由子代理先定位相关代码 |
| 无参数 | 先问用户想理解什么(AskUserQuestion / request_user_input),不要凭空猜测范围 |