AI 编程AI 资源
CodeCartographer：面向 Pi 与 MCP 编码 Agent 的代码库逆向分析与人工确认的软件规划
HuginnIndustries/CodeCartographer · Evidence-backed reverse engineering and human-gated software planning for Pi and MCP coding agents.
ELI5：它是什么，解决什么问题
CodeCartographer 通过 AI Agent 对不熟悉的代码库进行逆向分析，产出分层架构、行为契约、缺陷报告和与语言无关的重实现规范，支持 Pi 扩展、MCP 服务器和可直接拷贝的模板三种使用方式。其特点是分阶段流水线，以文件系统（.codecarto/findings/）作为持久记忆，阶段间设有验证闸门，每条结论带有证据等级标签（观察事实、强推断、可移植性风险、外部行为声明、开放问题），并支持从产品愿景与已确认规范反向合成项目实施计划。
核心能力与快速开始
★ 4 · JavaScript
- 能做什么
- 以阶段化流水线分析代码库：架构映射 → 缺陷扫描 → 行为契约 → 协议与状态 → 移植包 → 重实现规范；每阶段输出带模板、证据等级标签和验证表，验证闸门在 FAIL 或缺失输出时拒绝推进；进度与状态记录于 workflow/status.yaml，支持跨会话续接与上下文压缩后恢复；提供按阶段 token 用量统计、HTML 仪表盘、可选的 LLM 引导下一阶段种子提示；支持发布重实现规范到库，并通过 synthesis 流水线将产品愿景与人工确认的规范合成带来源追溯的项目计划；提供 Pi 扩展、MCP 服务器和 drop-in 模板三种入口，共享同一 core/。
- 适用场景
- 用于理解陌生代码库并产出可据以重建的验证规范；在 Claude Code、Codex、Cursor、Claude Desktop 等 MCP 兼容编码 Agent 中作为分析流水线运行；以 drop-in 方式在不安装任何组件的仓库中做一次性评估；将已确认的库规范与产品愿景合成为实施就绪的项目计划。
- 项目形态
- 开发框架
- 部署方式
- 三种方式：Pi 扩展（pi install npm:codecartographer-pi）、全局安装 MCP 服务器（npm install --global codecartographer-pi，宿主配置 command: codecarto-mcp）或直接拷贝 .codecarto 模板目录；需 Node >= 20。
- 主要依赖
- Node.js >= 20；语言为 JavaScript；使用 MCP 模式需宿主支持 MCP；Pi 扩展模式需 Pi TUI 编码 Agent；drop-in 模式需可读写文件的 LLM 会话。
- 使用限制
- drop-in 模式仅支持分析流水线，库与 synthesis 工作流需通过 Pi 或 MCP 的可执行代码；单个超大阶段内部仍受上下文窗口限制，压缩为有损蒸馏，MCP/drop-in 的压缩完全由宿主控制；验证依赖模型对自身完成标准的自评加两项机械检查，而非重新评判标准本身。
- 许可证
- MIT
- 最近推送
- 2026-09-19 07:00
资料检查：2026-09-20 07:00 · 卡片整理：2026-09-20 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容
讨论 0
登录后参与讨论，阅读资讯无需注册。
还没有评论，来分享第一个看法。