agentic-wiki

让 AI 以「资深研发 + 产品策划」身份，基于飞书文档与 GitLab 代码库回答项目问题。

安装

npx @apowo/agentic-wiki init --gitlab-host <你的GitLab域名>

示例：

npx @apowo/agentic-wiki init --gitlab-host code.apowo.com

安装完成后，编辑 .agentic-wiki/config.yml，填入项目信息（Wiki 地址、仓库路径等），然后把 .agentic-wiki/SYSTEM_PROMPT.md 喂给你的 Agent。

详细安装与 Agent 接入指南见 QUICKSTART.md。

前置条件

• Node.js >= 18
• glab：agentic-wiki init 会自动按平台下载到 .agentic-wiki/bin/，无需预装
• lark-cli：固定使用 npx -y @larksuite/[email protected]

lark-cli 初始化

# 登录飞书（bot + user 双身份）
npx -y @larksuite/[email protected] auth login

# 验证认证状态
npx -y @larksuite/[email protected] auth status

按提示完成 OAuth 登录即可。

glab 初始化

# 登录 GitLab（选择 Token 方式，粘贴只读 Access Token：scope read_api + read_repository）
.agentic-wiki/bin/glab auth login --hostname <你的GitLab域名>

# 验证认证状态
.agentic-wiki/bin/glab auth status

也可以使用系统已安装的 glab（brew install glab），安装后在 .agentic-wiki/config.yml 中修改 glab.bin 路径。但注意 agentic-wiki init 每次都会覆盖该配置。

使用

问一个问题试试：

X 功能为什么这样设计？

Agent 会自动查询飞书文档和 GitLab 代码库，给出带来源引用的回答。

更新

发布新版后，在已安装项目里升级物料：

npx @apowo/agentic-wiki update

只刷新模板物料（SYSTEM_PROMPT / orchestration / guardrails / tools / memory/README），保留你的记忆、config 值、认证态与 glab 二进制。若安装来自旧版本，update 还会自动把存量数据迁移到当前格式（索引行补 · type、frontmatter 校验补齐等），迁移前自动备份到 .agentic-wiki/.backups/。--dry-run 可先预览，--no-migrate/--no-backup 可分别跳过迁移/备份。init/doctor/update 运行时会检查 npm 最新版并在有新版时提示。详见 QUICKSTART.md。

更多文档

• 快速开始指南 — 详细安装、Agent 接入与故障排查
• 架构设计 — 系统架构与设计决策
• 工具约定：lark-cli
• 工具约定：glab
• 开发指南 — 开发方法论、项目结构与研发路线图
• 问答编排 — Agent 问答流程规范

许可证

MIT