关于 commit-context
用于从代码位置追溯 Git 提交及关联 Agent 会话的技能,帮助开发者查看变更背景,并避免作出查询结果不支持的意图判断。
主要功能
- 01用 git blame 或 log 查找提交
- 02查询提交及关联会话
- 03呈现会话观察记录
- 04处理未关联会话的提交
适用场景
- 01追溯某行或函数对应的提交
- 02查看变更记录的会话背景
MCP 相关
工作流使用 `memory_commit_lookup`,并可选用 `memory_recall` 获取提交和会话信息。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rohitg00/ agentmemory --skill commit-context安装后在 Claude Code 中输入/commit-context确认已加载。
附带文件EXAMPLES.mdTROUBLESHOOTING.md
详细介绍
用户希望了解以下内容的提交上下文:$ARGUMENTS
快速开始
git blame -L 40,52 src/auth/refresh.ts # -> SHA 9a1b2c3d
memory_commit_lookup { "sha": "9a1b2c3d4e5f60718293a4b5c6d7e8f901234567" }
预期输出:
9a1b2c3 on main by dev: "rotate refresh tokens"
Linked session 7f3a9c2 "Auth refresh rework", 14 obs.
原因
只报告 git 和查询结果。当查询返回 commit: null 时,表示该提交早于会话关联;不要凭空编造意图。
工作流
- 查找 SHA:针对行范围,使用
git blame -L <start>,<end> <file>;针对函数,使用git log -L :<function>:<file>;针对普通路径,使用git log -n 1 -- <file>。 - 查询:
memory_commit_lookup { "sha": "<full-sha>" }。 - 展示提交(sha、短 sha、分支、作者、消息)、关联的会话(id、项目、开始/结束时间、观察条目数、摘要),以及可用时通过
memory_recall获取的重要性 >= 7 的观察条目。
反例
错误:查询返回 { "commit": null },你却仅凭差异内容描述“Agent 正在重构身份验证”。
正确:“此提交早于会话关联,因此没有记录的 Agent 会话。根据 git show:它修改了 refresh.ts 中的令牌轮换逻辑。”
检查清单
- SHA 来自 git blame/log,而非猜测。
- 将
commit: null报告为“早于关联”,不编造会话。 - 会话详情逐字引用查询响应。
- 不声称观察条目未提及的意图。
另请参阅
commit-history:一次列出多个与 Agent 关联的提交。recall:深入了解关联会话的观察条目。
故障排除
如果 memory_commit_lookup 不可用,请参阅 TROUBLESHOOTING.md。
评论
支持 Markdown