roam-code
为AI编码代理提供本地代码库智能分析与变更证据的底层工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：roam-code。 它的用途是：为AI编码代理提供本地代码库智能分析与变更证据的底层工具 完整的 Skill 内容见：https://321skill.com/skills/roam-code/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请分析当前项目src/utils/目录下的代码结构，并评估修改`dataParser.js`中的`parse`函数对下游模块的影响。”，AI会通过roam-code查询代码依赖图，给出精确的影响范围报告。或者，在AI完成一次代码重构后，
对AI说：“为刚才的修改生成变更证据包”，roam-code会打包本次修改的上下文、变更内容和风险分析，生成一个可验证的证据文件。
介绍
roam-code 旨在解决AI编码代理在修改代码时缺乏上下文和可信证据的问题。它通过本地分析代码库，构建知识图谱，为AI代理提供精准的代码上下文，并生成包含变更范围、潜在风险和政策决策的加密证据包，确保每次修改都可追溯、可审计。
使用时，开发者通过命令行或MCP服务器将其集成到AI编码工具（如Cursor）中。AI代理在修改代码前，会先通过roam-code查询代码结构、依赖关系和潜在影响，并在修改后生成一个包含完整证据链的ChangeEvidence数据包，供代码审查或合规检查使用。
它非常适合需要AI辅助进行复杂代码重构、遗留系统维护或对代码变更安全性、合规性有高要求的开发团队。智能体开发者也能利用其构建更可靠、可解释的自动化编码流程。
需要注意的是，roam-code的核心优势在于本地分析和证据生成，对于需要实时联网搜索最新库文档或进行云端协同编码的场景，可能需要结合其他工具。初次安装时会下载语法解析包，请确保网络通畅。
核心特点
与同类工具相比，roam-code的核心区别在于其“凭证免费、本地优先”的设计哲学，以及能生成防篡改的`ChangeEvidence`证据包，将AI的代码变更行为（谁、基于什么权限、改了哪里、有何风险等）完整记录并加密链式存储，为代码审查和合规审计提供了机器可验证的底层证据。
注意事项
不适合需要频繁依赖云端最新知识库或进行实时在线协作的轻量级、快速原型开发场景。
常见问题
roam-code会偷偷上传我的代码吗？
不会。roam-code设计为本地分析，默认不自动上传源代码或遥测数据，网络操作均需显式启用并在文档中列明。
如何与Cursor/AI编码工具集成？
可通过其内置的MCP服务器功能集成，让AI助手在编码时调用roam-code的命令来获取代码上下文和生成变更证据。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/roam-code/raw/index.md 读取 roam-code 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/roam-code/raw/index.md（查看排版版本）