AI导哈

代码上下文打包工具

为Claude Code和OpenAI Codex从代码库中准备最优化的任务特定上下文包。

  • by anup4khandelwal
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 anup4khandelwal/context-pack

使用说明

上下文包

从Claude Code和OpenAI Codex的存储库中准备一个最佳的、特定于任务的上下文包。

安装

npm install -g context-pack

快速入门

全局安装：

npm install -g context-pack
context-pack bundle --task "Add Reddit OAuth + ingest pipeline" --budget 14000

npx：

npx -y context-pack bundle --task "Add Reddit OAuth + ingest pipeline" --budget 14000

输出

生成 .context-pack/ 在回购中：

  • bundle.md → LLM的复制/粘贴友好上下文
  • bundle.json → 结构化表示
  • explain.md → 为什么每个文件都包含在内

为什么它存在

当给定太多文件、无关文件、缺少入口点或嘈杂的差异时，LLM的性能会很差。 context-pack 在严格的令牌预算内确定地选择、排名和打包最相关的文件。

它是如何工作的（最小）

启发式（v1）：

  • Git相关性：最近更改、共同更改的文件
  • 语义相关性：文件名/路径/符号与任务文本匹配
  • 依赖接近度：导入关系
  • 结构重要性：入口点、配置、清单
  • 噪声消除：.gitignore、构建输出、node_modules、默认排除的测试

代币预算：

  • 估计每个文件的令牌数
  • 达到预算时停止
  • 优雅降级：满→ 修剪过的→ 仅签名

命令

  • context-pack bundle --task "<task>" [--budget N]
  • context-pack scan --task "<task>"
  • context-pack explain

例子

context-pack bundle --task "Add Reddit OAuth + ingest pipeline" --budget 1000
context-pack scan --task "Refactor config loader" --limit 25
context-pack explain

看 docs/examples/ 用于样本输出。

故障排除

  • 确保你跑了 npm run build 在从调用CLI之前 dist/.
  • 如果捆绑包为空，请尝试增加 --budget 或细化任务描述。

如何发布

看 RELEASE.md 查看完整的检查表。

文档

  • 食典工作流程： docs/codex.md
  • Claude Code插件包装器： docs/claude-plugin.md
  • 发布清单： RELEASE.md

集成

  • MCP服务器： integrations/mcp/README.md
  • 克劳德代码： integrations/claude-code/README.md
  • 食典工作流程： integrations/codex/README.md

相关 MCP