Skill Forge (SKF):将代码仓库与文档编译为可溯源、版本锁定的 AI Agent 技能
armelhbobdad/bmad-module-skill-forge · A standalone BMAD module that transforms code repositories, documentation websites, and developer discourse into agentskills.io-compliant, version-pinned, provenance-backed agent skills.
ELI5:它是什么,解决什么问题
Skill Forge(SKF)是一个独立的 BMAD 模块,用 Python 实现,可将代码仓库、文档网站与开发者讨论内容转化为符合 agentskills.io 规范、按版本固定且带来源溯源的 agent 技能。每条指令都可回溯到固定 commit 的具体 file:line,或对应的文档 URL,并提供 provenance-map.json、测试与证据报告,便于在 60 秒内人工核验。技能按版本目录存储、可跨 Claude、Cursor、Copilot 等 agent 使用,并提供重命名、弃用、删除、导出等生命周期工具,还支持从文档单独生成技能(无公开代码的场景)。安装需 Node.js ≥ 22、Python ≥ 3.11 与 uv,通过 npx 安装后与 Ferris 智能体交互。
核心能力与快速开始
★ 98 · Python
- 能做什么
- 从代码仓库、文档与开发者讨论中提取真实的函数签名、类型与模式,编译为 agentskills.io 规范技能;每条指令带来源引用(源码为 file:line 加固定 commit,文档为来源 URL);按版本目录存储技能,保证不可变与版本锁定;输出 SKILL.md(触发时加载的完整指令集)与 context-snippet.md(80–120 token 的常驻索引,注入 CLAUDE.md / AGENTS.md / .cursorrules);输出 provenance-map.json 与 metadata.json(source_commit、source_repo)供审计;提供测试、质量评分与证据报告;支持生成技能的重命名、弃用、删除与导出等事务化生命周期操作;支持从同一目标按不同范围编译多个技能,以及跨会话编排多技能(Campaign)。
- 适用场景
- 让 AI 编程 agent 使用正确的库 API,避免臆造函数名与参数;库维护者发布官方、可验证的 agent 指令文件;为依赖庞杂的代码库构建统一的“技术栈技能”;针对无公开源码的 SaaS API 或闭源工具,仅凭文档生成技能;为同一仓库或文档集生成不同用途的多个技能(如核心 API 技能与迁移指南技能);通过 provenance 链在 60 秒内人工核验技能中的声明。
- 项目形态
- 可直接使用的工具
- 部署方式
- 未说明;安装命令为 npx bmad-module-skill-forge install,另有其他安装方式见文档。
- 主要依赖
- 需要 Node.js >= 22、Python >= 3.11 以及 uv(Python 包运行器);支持 Linux、Windows 与 macOS。能力层级(capability tier)取决于本机可用工具,如 GitHub CLI、ast-grep、cocoindex-code、QMD 等。
- 使用限制
- Quick Skill(QS)路径生成的技能不保留 provenance map,无法执行上述引用审计;测试目标为 90% 评分,但 80% 及以上即视为通过并在证据报告中记录差距;各工作流会加载大量上下文,建议在流程之间开启新会话或使用管道模式;材料未说明许可证的实际适用条款(README 徽章标注 MIT,但仓库元数据 license 为 NOASSERTION)。
- 许可证
- NOASSERTION
- 最近推送
- 2026-10-14 06:11
资料检查:2026-10-14 07:00 · 卡片整理:2026-10-14 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证
职业应用
程序员
将代码仓库、文档网站与开发者讨论内容编译为符合 agentskills.io 规范、按版本固定且带来源溯源的 AI Agent 技能,使 AI 编码代理能依据真实函数签名、类型和模式生成代码,避免猜测 API 调用;每条指令可回溯到固定 commit 的具体 file:line 或文档 URL,并提供 provenance-map.json、测试与证据报告,便于在 60 秒内人工核验。
查看内容依据
Skill Forge(SKF)是一个独立的 BMAD 模块,用 Python 实现,可将代码仓库、文档网站与开发者讨论内容转化为符合 agentskills.io 规范、按版本固定且带来源溯源的 agent 技能。
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。