用途:为仓库从零初始化一套结构化知识体系 .knowhow/(AI 编写、人工审核),仅在 workspace 尚无 .knowhow/ 且用户要首次创建时使用;触发语如 “init knowhow”“setup”。
主要能力与流程:
- 收集信息:询问知识库名称、领域描述,以及是否按项目/客户/活动运作;若按项目则额外在 SCHEMA 的 Page Types 加入 project 页类型。
- 建目录:执行 mkdir -p .knowhow/{raw,inbox,archive/inbox,wiki,skills,workflows}。
- 生成 SCHEMA.md:基于 references/schema-template.md,替换项目名、描述与日期占位符。
- 生成内容文件:wiki/index.md、wiki/log.md、skills/registry.md、workflows/registry.md,以及顶层 schema-signals.md(记录 no-fit-type、adhoc-section、query-miss、promote-candidate 等信号,append-only)。
- 写入 agent 配置:仅向根目录 AGENTS.md 插入带 <!-- knowhow:start --> / <!-- knowhow:end --> 标记的片段,脚本对已存在文件、已有标记、无标记三种情况做幂等处理。
- 记录完成并建议首个 capture 到 inbox/。
三层结构:Raw(原始、不可变)、Wiki(结构化互链知识)、Skills & Workflows(可执行复用知识)。Skill 为闭环可复用操作,Workflow 为跨步骤流程并可调用多个 Skill。
限制:仅初始化,不负责后续知识积累;其他配置文件(如 CLAUDE.md、GEMINI.md)需用户自行处理;分类与价格等信息暂未提供。