codecall
用你 AI 智能体刚写的代码出题，检测你是否真正理解了这次改动。
- Star 数
- ★ 16
- 最近更新
- 7 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 刚让 Claude Code 加上登录中间件的开发者，想确认自己真的理解鉴权边界而不是只看到代码通过。
- 不适合
- 只想让 AI 多写代码、不愿花时间做理解检测的开发者
- 工作区长期有未提交改动、无法提供干净 Git 树的团队
- 源码审查
- 55/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
codecall 是一个面向 AI 编程助手的技能（Skill），在智能体完成一次改动后，用你自己的代码讲解背后的 2 到 4 个概念，并通过两两成对的检查确认你能解释它们，最后生成一份单页 HTML 回执。它提供三种模式：Learn（对刚完成的改动做约 4 分钟的问答）、Trace（从入口到响应逐行追踪一个请求）、Drill（在你自己的项目里植入一个 bug，让你做调试练习）。它支持 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Kiro 和 Copilot，通过 Skills CLI、npm 或 Claude Code 插件安装。整个流程不调用网络、不需要 API key 或账号，唯一的产物是项目内 ./codecall/ 目录下的回执文件；Drill 会临时修改一个文件，结束后用 Git 恢复。
Learn 模式以 /codecall 触发：codecall 读取智能体刚做出的改动，先给出学习机会与预计时长，等待你选择 Start Learning 或 Skip，再按你的自评（Expert / Comfortable / Heard of it / Never learned）调整讲解，用你的代码解释概念，并对每个概念做两次检查；答对则下一题更难，答错会指出缺口、重新讲解并换一道题。Trace 模式为 /codecall trace <flow>（如 POST /login），逐条给出 file:line 路径，最后对最可能藏 bug 的 2 到 3 步做检查，且不改动代码。Drill 模式为 /codecall drill <area> <easy|medium|hard>，植入一个真实 bug（off-by-one、缺少 await、未处理的空值、错误状态码等），只给症状与复现方式，提示按“看哪里、打什么日志、哪个函数、哪一行”逐级收窄，结束后展示植入的改动并用 Git 还原文件。此外，约 80 个后端概念的映射表会在概念缺失时于回执中追加一行 Go deeper，链接到 Sriniously 的免费视频章节与 MDN、OWASP 或 PostgreSQL 文档。每次会话结束在 ./codecall/ 生成自包含 HTML 回执，记录改动的单行描述、日期、每个概念的通过与否以及 Could explain N of M 得分。
- 刚让 Claude Code 加上登录中间件的开发者，想确认自己真的理解鉴权边界而不是只看到代码通过。
- 准备调试面试的候选人，希望在自己熟悉的项目里做一轮有提示、有答案复盘的实战练习。
- 接手陌生代码库的工程师，用 trace 从请求入口一路跟到响应，快速建立调用链认知。
- 技术负责人希望团队在 AI 生成代码后留下可核查的理解证据，而不是只看合并记录。
- 后端学习者遇到缓存、队列、webhook 等概念缺口时，通过回执中的 Go deeper 链接补课。
如何安装或部署这个 Agent？
任选一种方式安装，安装后需重启智能体或新开会话：
npx skills add GAURAV-1313/codecall或通过 npm 全局安装（适用于 Claude Code 与 Codex）：
npm install -g codecall或使用 Claude Code 插件市场（唯一会在有意义改动后自动提示会话的方式）：
/plugin marketplace add https://github.com/GAURAV-1313/codecall
/plugin install codecall@codecallCodex 用户改用插件方式：
codex plugin marketplace add https://github.com/GAURAV-1313/codecall
codex plugin add codecall@codecall如何使用这个 Agent？
安装方式决定你输入的指令：Skills CLI 或 npm 安装后用 /codecall，Claude Code 插件用 /codecall:codecall，Codex 用 $codecall。
对刚完成的改动做理解检测：
/codecall追踪一个请求流程：
/codecall trace POST /login在指定目录做指定难度的调试练习（需要 Git 且工作区干净）：
/codecall drill src/orders medium会话结束后回执位于项目内的 ./codecall/ 目录，删除该目录即可清除全部记录。
这个 Agent 有哪些优点和局限？
- 检查以你自己的代码为素材，而不是通用题库，回执能直接对应到具体改动。
- 答错会指出概念缺口、重新讲解并换题，形成自适应而非一次性测验。
- 完全本地运行，无 API key、无账号、无网络调用，回执是唯一写入的文件。
- Drill 只在单个文件上植入 bug 并用 Git 还原，不 commit、不 stash、不建分支，边界清晰。
- Trace 模式逐条给出 file:line，适合快速建立陌生代码库的调用链认知。
- Drill 要求 Git 且工作区干净，有未提交改动时无法启动，需要先 commit 或 stash。
- 自动提示会话只有 Claude Code 插件提供，其他安装方式需要自己手动输入命令。
- 后端概念映射仅覆盖约 80 个服务端概念，范围外的改动按普通模式处理，不追加 Go deeper。
- 回执以 HTML 文件存放，没有集中管理或团队汇总视图，需要自行收集。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| codecall 当前 | 55 · 缺口较多 | Agent 插件 / 技能免费 | ★ 16 | 7 天前 | TypeScript | Codex · Claude Code |
| Waza 技 | 63 · 存在缺口 | 命令行工具免费 | ★ 7.5k | 3 天前 | Python | Codex · Claude Code |
| Self-Learning Skills | 56 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 973 | 1 个月前 | — | Codex · Claude Code |
| Loop Library: 可复用 AI Agent 工作流库 | 61 · 存在缺口 | Agent 插件 / 技能免费 | ★ 3.2k | 1 个月前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 与 SECURITY.md 明确声明无网络、无 API key、仅写 ./codecall/ 收据，drill 仅改一个文件并用 git checkout 恢复，插件 hook 只返回文本提醒；这些声明与 package.json 的 postinstall 安装脚本、bin 入口一致，属于最小权限与用户确认（Start Learning / Start Drill）的合理设计。但敏感数据处理仅停留在“不收集”的声明层面，未说明收据 HTML 中是否包含源码片段或路径，也未给出脱敏策略；依赖安全方面 devDependencies 全部使用 latest，且 postinstall 在全局安装时执行脚本，存在供应链与可复现性风险；外部效应与回滚有 Git 恢复机制，但 drill 依赖干净工作树，若用户未提交则无法回滚，且 README 建议“不读就批准植入编辑”，削弱了用户确认的严谨性。综合扣分：敏感数据与依赖安全证据不足，用户确认在 drill 场景被弱化。
README 对命令、安装方式、故障排查（重启、命令找不到、drill 需干净工作树）描述一致，SECURITY.md 与 README 对网络、文件写入、drill 行为的描述互相印证，自洽性较好。但依赖可用性方面，package.json 的 devDependencies 使用 latest，且 postinstall 依赖 dist/install-skill.js 在安装时存在，若构建产物缺失则安装失败；测试文件 test/cli.test.ts 直接调用 dist/cli.js，未在测试前构建，存在环境依赖风险。失败消息方面，README 的 Troubleshooting 覆盖常见失败，但代码层面未展示具体错误消息，证据有限。
README 明确支持 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Kiro、Copilot，并给出各安装方式对应的命令差异，场景覆盖 Learn/Trace/Drill 三种模式，受众定位清晰。能力边界方面，声明 trace 不编辑代码、drill 只改一个文件、插件 hook 只加提醒，边界较清楚。但触发精度方面，自动 offer 依赖插件 hook，README 未说明 hook 的触发条件与误触发处理，且“不读就批准”的建议可能降低触发安全性；环境适配方面，要求 Node >=20、Git 干净工作树，对非 Git 项目或未提交状态支持有限。
README 结构清晰，包含 Features 表、Install 表、命令对照表、Learn/Trace/Drill 示例、隐私、Troubleshooting、Contributing、License，信息架构良好；安装说明覆盖多种方式并给出重启提示；命名稳定（codecall 统一）；示例与 FAQ 较充分。但已知限制仅零散提及（drill 需 Git、干净工作树），未集中列出；版本化仅有 SECURITY.md 的 1.5.x 支持表，无 CHANGELOG；维护责任方面，发布者未经验证，SECURITY.md 给出报告渠道与 7 天回复承诺，但无明确维护者身份或更新路径。许可证为 MIT，完整。
输出可用性方面，收据为自包含 HTML，包含变更摘要、概念掌握标记、分数与要点，可直接使用；边际价值在于将 AI 生成代码转化为学习与调试练习，对目标用户有明确增益。但成本效益方面，每次会话约 4 分钟、生成 HTML 文件、drill 需 Git 操作，对高频变更场景可能产生文件堆积与时间成本；且自动 offer 依赖插件 hook，可能增加干扰。证据未展示收据模板的实际内容质量，扣分。
README 的声明（无网络、仅写收据、drill 恢复）与 SECURITY.md 互相印证，但均为项目自述，缺少第三方或代码级证据；测试文件覆盖 backend-map 校验、CLI help、安装脚本，但未覆盖网络调用、文件写入范围、drill 恢复等关键声明，claim_traceability 有限。cross_source_corroboration 仅限仓库内文档互证，无外部独立来源。fact_inference_separation 方面，README 将“无网络”等声明与功能描述混写，未区分已验证事实与设计意图，扣分。
- README 建议在 drill 植入编辑时“不读就批准”，这可能削弱用户对文件修改的确认意识，建议用户仍审阅变更。
- devDependencies 全部使用 latest，且 postinstall 在全局安装时执行脚本，存在供应链与可复现性风险，建议锁定版本并审查安装脚本。
- 收据 HTML 可能包含源码片段或路径，README 未说明脱敏策略，敏感项目使用前应检查 ./codecall/ 内容。
- drill 依赖干净 Git 工作树，未提交的更改无法通过 git checkout 恢复，使用前应提交或暂存。
- 发布者身份未经验证，维护责任与更新路径不明确，长期使用需关注仓库活跃度与安全公告。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.3.0 codecall v1.3.0
发布说明摘录
Every session now ends in a one-page receipt (./codecall/NNNN-<slug>.html) with the score "Could explain N of M" and a streak line. SKILL.md trimmed and re-led with the slot; one-line install: npx skills add GAURAV-1313/codecall. Test pins fixed.在 GitHub 查看 ↗ -
v1.2.2 codecall v1.2.2
发布说明摘录
Small patch release - README now links the [landing page](https://codecall-theta.vercel.app/), npm, and GitHub at the top. - Lockfile refresh (no dependency changes, just pruned stale optional-platform variants). No behavior changes for any install path.在 GitHub 查看 ↗ -
v1.2.1 codecall v1.2.1
发布说明摘录
Small patch release - README: added a second worked example (retry/backoff logic) alongside the existing auth example, so it's clear codecall isn't just for security-flavored code. - Fixed a high-severity dev-dependency advisory (nanoid, GHSA-2v37-7h3g-55p8) — dev-only, never shipped to users, but fixed for repo hygiene. - Removed a stray self-referential codecall dependency that had crept into package.json/package-lock.json from a local install in this directory — never actually published, but worth cleaning up. No behavior changes for any install path.在 GitHub 查看 ↗