codespaces
为AI编程助手提供代码库架构感知与变更影响分析能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：codespaces。 它的用途是：为AI编程助手提供代码库架构感知与变更影响分析能力 完整的 Skill 内容见：https://321skill.com/skills/codespaces/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我需要修改用户认证模块，请先用 codespaces skill 帮我分析一下影响范围。首先搜索 `auth` 相关的模块。' 它会先执行 `search "auth"` 找到模块ID，然后运行 `analyze <module-id>` 和 `rdeps <module-id>`，最终告诉你需要阅读哪几个关键文件，以及改动可能会影响到哪些其他服务，从而确保变更的精准和安全。
介绍
Codespaces Skill 旨在解决开发者在面对复杂或陌生代码库时，因缺乏全局架构认知而导致的盲目阅读和修改问题。它通过 tree-sitter 解析 Python 和 TypeScript 代码，构建一个可查询的代码库“信念地图”，清晰展示模块边界、依赖关系和架构层级。
使用时，开发者或AI助手只需通过简单的命令行查询，即可快速定位目标模块、分析其依赖与影响范围、检查架构违规，从而将需要阅读的代码文件范围精确到几个“边界文件”，极大提升代码理解和修改的效率。
这个 Skill 特别适合需要频繁在不同项目间切换、进行代码审查、重构或负责维护大型遗留系统的开发者。它让AI编程助手具备了“架构师视角”，能更智能地规划代码变更。
建议在开始任何非平凡代码修改前，先使用该 Skill 进行边界和影响分析。注意，其分析基于静态代码解析，对于高度动态或运行时生成的代码结构可能无法完全覆盖，且目前主要支持 Python 和 TypeScript/TSX。
核心特点
与同类代码分析工具相比，它专为驱动AI编程助手（Agent）而设计，输出结构化的S表达式事实，便于AI直接理解和推理；同时，它强调“查询优先于阅读”的工作流，直接回答“需要读哪几个文件”和“改动会波及谁”这类工程实践中的核心问题，而非仅仅生成可视化图表。
注意事项
不适合分析高度依赖运行时特性或动态生成的代码结构，且目前主要支持 Python 和 TypeScript/TSX 语言。
常见问题
这个 Skill 能分析哪些编程语言？
目前主要支持 Python、TypeScript 和 TSX（React）。
如何为我的代码库生成信念地图？
在项目根目录运行 `python3 scripts/build_belief_map.py` 即可增量构建地图。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/codespaces/raw/index.md 读取 codespaces 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/codespaces/raw/index.md（查看排版版本）