用途:规范 docs/learned/ 下面向智能体的文档写作与重组,包括新建文档、更新 frontmatter、维护分类索引与 AGENTS.md 路由表。
主要能力与结构:每篇 markdown(index.md 除外)必须含 YAML frontmatter 的 title 与 read_when 字段;read_when 用动名词短语、具体化,建议 2-4 条条件。文档按层级分类组织,分类索引由 frontmatter 自动生成。根级与分类目录下存在 index.md,AGENTS.md 中含快速路由表。
用法要点:新建文档使用给定模板;重组时用 git mv 移动文件,用 grep -r 查找旧引用并修正相对链接,更新受影响索引与 AGENTS.md;提交前运行 make fast-ci 校验 frontmatter、必填字段与 Markdown 格式。
生成文件:docs/learned/index.md、各分类 index.md 与 tripwires.md、tripwires-index.md 为自动生成,禁止直接编辑;应改源 frontmatter 后运行 erk docs sync 再提交。
分类区分:cli/ 关注用户交互模式(快路径、输出样式、脚本模式、命令组织);architecture/ 关注内部实现(Gateway ABC、依赖注入、dry-run 包装类、Shell 集成约束、Protocol 与 ABC 取舍)。
限制:资料未提供该技能的收费、平台与更细的使用步骤,缺失信息暂未提供。