Afrexai Knowledge Management

提供组织知识审计、分类、文档模板、贡献激励与新鲜度维护，助力将隐性经验转化为结构化知识资产。

Install

openclaw skills install @thcjp/afrexai-knowledge-management

核心功能: 本技能提供中文交互等能力。

核心功能: 本技能提供提升工作效率、化工作流场景等能力。

知识管理体系

把团队内部的非正式经验转化为可搜索、可维护的组织智能资产,避免人员流动造成的能力流失.

输入定义

参数名	类型	必填	说明
input	string	是	知识管理体系处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

专业版增值服务

能力	免费版	付费版
基础功能	支持	支持
多租户管理与权限分配	不支持	支持
操作审计与合规日志	不支持	支持
自定义仪表盘与报表	不支持	支持
API开放与第三方集成	不支持	支持

前置条件

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

功能能力

1. 知识审计

对7个维度按1-5分评分,总分35分,定位知识风险等级:

文档覆盖率、可发现性、新鲜度、贡献文化、入职效率、知识留存、跨团队共享
28-35分视为成熟,21-27分为发展期,14-20分为基础期,7-13分为危险期
输出知识风险登记表,标注单点故障人员与补救优先级

2. 知识架构设计

最大3层目录深度,超出需重组
每个主题仅一个规范位置,通过交叉引用而非复制
命名规范遵循 [DOMAIN]-[TYPE]-[TOPIC]-[SPECIFICS],如 eng-howto-deploy-production
每页必须设有所有者和新鲜度日期,6个月内未审查即标记过期

3. 文档模板体系

运行手册模板:面向操作步骤,含验证人、最后验证日期、流程图
参考文档模板:面向查阅,字段、参数、示例完整
架构决策记录(ADR):背景、决策、后果、替代方案
决策树模板:分支条件与跳转路径

4. 贡献系统

所有文档必须通过4C测试:Clear(无术语堆砌)、Correct(实测验证)、Current(反映现状)、Concise(无冗余).

格式规则:标题动作导向、步骤编号、警告前置、命令可复制
贡献激励:模板预填、快速捕获通道、月度贡献者表扬、文档轮值负责人
文化规范:回答过两次的问题必须写文档,PR模板含"文档已更新"检查项

5. 搜索与发现

文档标签schema覆盖domain、type、audience、technology、status、difficulty六维.

搜索结果按新鲜度、验证状态、使用频率、完整度排序
发现机制:上下文链接、FAQ集合、入职路径、聊天机器人、周报摘要、错误页链接

6. 知识捕获工作流

事件后捕获:24小时内原始时间线,5天内根因分析,10天内知识产物
会议后捕获:架构评审产出ADR,流程变更更新运行手册,战略决策写入决策记录
新员工捕获:前30天记录困惑点、未解答问题、过时文档
离职知识转移:识别独有知识、安排提取会话、录制视频、配对交接、重新分配文档所有者

7. 维护与新鲜度

新鲜度策略:季度审查60分钟,含仪表盘回顾、差距分析、陈旧文档分诊、失败搜索复盘
内容健康仪表盘:覆盖率、新鲜度率、质量分、使用率、贡献率、搜索效果

8. 知识驱动自动化

自动触发:事件后自动建文档任务,PR合并触发架构更新,新员工入职触发反馈表单
知识机器人:接入知识库的聊天机器人返回相关文档链接

9. 跨团队知识共享

共享机制矩阵覆盖TIL频道(每日)、午餐学习(双周)、架构评审(月度)、客户洞察分享(月度)、事后复盘(按事件)、季度知识审查.

10. 指标与ROI

KPI目标:文档覆盖率>80%、新鲜度率>85%、月贡献率>40%、搜索成功率>80%、失败搜索率<10%、周使用率>60%、重复问题6个月减少50%、新员工生产力提升30%.

11. 评分与质量

文档质量0-100分,8维加权:准确度20%、完整度15%、清晰度15%、可发现性10%、新鲜度15%、模板合规10%、可操作性10%、所有权5%。90-100为示范级,75-89为达标,60-74为可接受,40-59为低于标准,0-39为需重写.

输出格式

完成响应以Markdown格式返回,包含任务状态(成功/失败)、解析摘要和具体输出数据。失败时返回错误码和错误信息,便于定位问题。- 验证返回数据的完整性和格式正确性

快速入门

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用范围

场景	输入	输出
知识审计	团队现状描述	7维度评分表+风险登记表
架构设计	业务领域列表	3层分类法+导航结构+命名规范
运行手册生成	流程描述	含验证步骤的可复制运行手册
健康检查	知识库快照	健康仪表盘+差距清单
离职转移	人员姓名与职责	提取访谈指南+交接计划

不适用于:需要实时数据抓取的监控场景、纯个人笔记管理.

操作流程

执行知识审计,确认7维度基线分数
基于审计结果设计分类法与导航结构
按模板生成首批运行手册与ADR
建立贡献激励与新鲜度策略
配置搜索标签与发现机制
每季度运行健康审查并迭代

使用范例

示例1:审计输出

text

输入: "审计我们的知识管理"
处理: 运行Phase 1评估
输出:
  Documentation coverage: 3/5 (60% critical processes documented)
  Findability: 2/5 (new hire avg 12 min to find answers)
  Freshness: 2/5 (35% docs updated within 6 months)
  Total: 18/35 — Basic, needs foundational work
  Risk: 2 single-point-of-failure roles identified

示例2:运行手册片段

text

输入: "写部署生产环境的runbook"
输出:
  Owner: 张三
  Last verified: 2026-07-15
  Steps:
    1. 确认构建产物版本号匹配 release-2026.07
    2. 执行 `kubectl apply -f deploy/prod.yaml`
    3. 验证健康检查 `curl -f http://prod-app/healthz`
    4. 回滚命令 `kubectl rollout undo deploy/prod-app`

错误应对

错误场景	原因	处理方式
单点故障人员离职,知识未提取	无离职转移流程	立即安排2小时提取会话,录制视频,配对交接2周
文档陈旧超过6个月未审查	缺乏新鲜度策略	标记needs-review,指派所有者30天内验证或归档
孤立文档无所有者	入职时未分配	季度审查时重新指派所有者与备份负责人
搜索失败率>10%	标签schema缺失或同义词未覆盖	分析失败搜索词,补充同义词与problem-description标签
月贡献率<40%	贡献摩擦大或无激励	预填模板、开设快速捕获通道、纳入绩效评估
跨团队知识孤岛	无共享机制	建立TIL频道与月度跨团队架构评审
合规审计追踪缺失	无版本控制	引入带审计跟踪的版本控制,记录谁在何时改了什么

使用约束

需要LLM支持,无LLM环境无法生成文档内容
文档质量评分依赖人工实测验证,无法完全自动化
跨团队共享需要组织文化配合,工具无法单独解决
合规场景需要额外配置审计跟踪与审批工作流

问题处理指引

错误现象	可能原因	诊断步骤	解决方案
知识审计评分异常低	文档更新不及时或缺失关键流程文档	检查文档更新记录和关键流程清单	定期更新文档，确保关键流程被覆盖
文档模板无法生成	模板配置错误或缺失必要字段	检查模板配置和输入数据	核对模板配置，确保所有必要字段已填写
知识捕获失败	事件未正确记录或知识转移流程缺失	检查事件记录和知识转移流程	确保事件被正确记录，并执行知识转移流程
搜索结果不准确	标签schema不完整或同义词未覆盖	检查标签schema和搜索词	补充缺失的标签和同义词，优化搜索算法
贡献者激励不足	缺乏明确的贡献激励措施	检查贡献激励措施	实施月度贡献者表扬、文档轮值负责人等激励措施

安全准则

风险项	等级	防护措施	验证方法
API Key泄露	高	限制API Key访问权限，使用环境变量存储	定期检查API Key访问日志，确保无未授权访问
数据安全	高	加密存储和传输数据	定期进行安全审计，确保数据加密措施有效
用户权限管理	中	实施最小权限原则，定期审查用户权限	定期审查用户权限，确保权限设置符合最小权限原则
知识库访问控制	中	实施访问控制列表，限制知识库访问	定期审查访问控制列表，确保访问权限设置正确
知识更新安全	中	实施文档更新审批流程	审查文档更新记录，确保更新过程符合安全规范

创新亮点

效率提升量化分析
指标
新员工达到独立产出的时间
重复支持工单减少比例
关键流程文档覆盖率
搜索成功率

差异性对比表格
指标
文档覆盖率
知识更新频率
搜索准确性
贡献者激励
跨团队共享

功能概览

自动化执行: 组织知识审计、分类架构、文档模板、贡献系统与新鲜度维护的完整体系。将组织内隐式经验转化为可搜索、可维护的结构化知识资产。
文件处理: 支持多种文件格式的读取、解析和写入操作
API集成: 通过标准化接口调用外部服务并处理响应
命令执行: 在安全沙箱中执行系统命令并收集结果
信息检索: 快速搜索和过滤目标数据

FAQ

Q1: 知识管理体系支持哪些输入格式？

A1: 组织知识审计、分类架构、文档模板、贡献系统与新鲜度维护的完整体系。覆盖知识审计、分类架构、文档模板、贡献。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

效率量化分析

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

差异化对比

对比维度	知识管理体系	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	组织知识审计、分类架构、文档模板、贡献系统与新鲜度维护的完整体系。将组织内隐式经	通用场景	通用场景

异常恢复流程

针对知识管理体系使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

知识管理体系通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

开始使用

配置API密钥: 在环境变量中设置对应的API Key
初始化连接: 使用提供的凭证建立API连接
调用接口: 传入必要参数执行API调用
准备文件: 确认文件路径正确且格式受支持
执行处理: 调用对应的处理函数
查看结果: 检查输出文件或返回数据
检查环境: 确认运行时和依赖已安装
执行命令: 使用正确的参数格式执行
查看输出: 检查命令输出和退出码

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

知识管理体系通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

知识管理体系通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

知识管理体系通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

Afrexai Knowledge Management

Install

知识管理体系

输入定义

专业版增值服务

前置条件

运行环境

依赖项

API Key 配置

可用性分类

功能能力

1. 知识审计

2. 知识架构设计

3. 文档模板体系

4. 贡献系统

5. 搜索与发现

6. 知识捕获工作流

7. 维护与新鲜度

8. 知识驱动自动化

9. 跨团队知识共享

10. 指标与ROI

11. 评分与质量

输出格式

快速入门

适用范围

操作流程

使用范例

示例1:审计输出

示例2:运行手册片段

错误应对

热门问题

Q1: 知识审计7维度评分如何取证据?

Q2: 分类法超过3层怎么办?

Q3: 文档质量评分60-74分如何提升?

Q4: 离职知识转移需要多长时间?

Q5: 新鲜度策略季度审查60分钟如何分配?

Q6: 如何度量知识管理ROI?

使用约束

问题处理指引

安全准则

创新亮点

功能概览

FAQ

Q1: 知识管理体系支持哪些输入格式？

Q2: 需要配置API Key吗？

Q3: 命令行执行失败怎么办？

效率量化分析

差异化对比

异常恢复流程

知识管理体系通用排查步骤

开始使用

前置条件

知识管理体系通用排查步骤

前置条件

知识管理体系通用排查步骤

前置条件

知识管理体系通用排查步骤

前置条件