aspens — Scoped Skills from Your Import Graph

Main

• 用多个小 skill 替代单个大文件：让 agent 只在触达对应领域时加载所需上下文。

• 把 doc impact 当作“上下文新鲜度/覆盖率”的门禁，在 CI 或大改动前先验证再依赖。

• 用 doc sync（或安装 post-commit hook）降低漂移，让 skills 与当前代码/依赖关系保持一致。

Source-backed notes

• README 将 skills 描述为约 35 行的 markdown 文件，并在编辑对应领域文件时触发加载。
• README 给出 aspens doc init --recommended 与 aspens doc impact 作为首要验证闭环。
• README 提供 aspens doc sync，并支持 --install-hook 安装 post-commit 自动同步。

FAQ

• 必须全局安装吗？：不必。README 也提供 npx aspens doc init --recommended 的免安装用法。
• skill 什么时候触发？：README 说明：当 agent 触达匹配的领域/文件时再加载对应 skill，而不是一次性读完整 CLAUDE.md。
• 如何保持同步？：改动后运行 aspens doc sync，或用 --install-hook 安装 post-commit 自动同步。