用途:为仓库建立并维护无向量(vectorless)的分层概念文档库,覆盖概念、架构与决策,避免重复描述代码如何工作。文档以 git 原生、可链接的“文档格”形式组织,智能体与人类按角色和问题导航,再跳转到代码、示例和测试了解行为。
主要能力:核心规则是三个事实来源——代码行为以代码、示例、测试为准,文档只链接(Authoritative source: path/),不转述实现;为何选择某方案以 ADR、DESIGN_FAQ 为准,只压缩决策与权衡;如何使用产品以 DX_FAQ、指南、技能为准,讲模式与命令,API 细节交给示例。若某段文档可被读文件或跑示例替代,就删除该段并加链接。
文档格分层:Router(docs/start_here/docs_map.mdx,表格“我想要…”→一个链接)、Charter(docs/NORTH_STAR.mdx,产品边界与扩展模型)、Decisions(docs/decisions/ 或 decisions/,ADR)、Concepts(docs/core/、docs/start_here/why_,架构心智模型、流程、术语表)、Agent ops(docs/ai_agents/、AGENTS.md)、Programs(可选,docs/superpowers/,含 specs/、plans/、tracker/.yaml、closure/、evals/、WHATS_NEXT.md)、Skills(skills/、plugin/skills/)、Published guides(docs/guides/)。只构建仓库需要的层。
概念文档应写:边界、不变量与失败模式、智能体/人类角色、组件与数据流图。不应写:逐行函数讲解、会漂移的复制粘贴 schema、在 README 中重复 ADR 理由。ADR 采用 MADR 风格,短小、只追加、链接权威源路径,含 id、标题、状态、发布版本索引表。
引导流程:加 Router(docs_map)与 Quick Router 表;加 NORTH_STAR(≤1 屏);加 decisions/ 与索引;加 AGENTS.md 说明哪个问题读哪份文档;根 QUICK_START.md 只放指针;如有公开站点则接发布配置。变更后按类型维护:架构边界/权衡→ADR;公共 API 用法→DX_FAQ 或指南;智能体流程→skill SKILL.md;程序阶段完成→closure/ + tracker YAML + WHATS_NEXT;行为细节变化→先改代码/测试/示例,文档只链接。
与 faq-driven-docs 的关系:本技能负责仓库级文档格、ADR、章程与智能体程序;faq-driven-docs 负责按包压缩 DESIGN_FAQ 与 DX_FAQ,两者可并用。
安装:npx skills add arenukvern/skill_steward --skill concept-doc-store
限制:无向量指发现依赖结构、链接与 git 内搜索,而非对粘贴代码做 RAG;可选 GitNexus/图工具只是辅助,不是文档库本身。tracker YAML 是状态,closure 是证据,plans/archive 是历史,不要执行已归档计划;计划过期时依据 tracker 与 spec 重新生成。触碰技能时在 skill_steward 中运行 pnpm run validate。其余细节暂未提供。