SuperAPI AI 工具集

investigating-repository-history

通用与其它

查看项目

更新于 10-15 19:50

技能介绍

用途:在修改 API 兼容性、安全、并发、持久化、迁移、性能、生成接口、特性开关或含义不明的遗留代码前,先重建代码背后的历史意图,回答“这段代码为什么这样写”“能否删除或简化该约束”“哪个 PR 引入了该行为或回归”等问题。无既有行为依赖的全新代码不适用。

主要能力:收集本地 Git 历史(git blame -w -M -C -C -C、git log --follow、-S、-G),把提交映射到 GitHub PR,抓取 PR 正文、文件、提交、评审与行内评论、issue 评论,并把证据提炼为约束、兼容性要求、安全不变量、性能约束、被否决方案、测试要求等“决策原子”。输出包含范围、相关证据、决策原子、风险等级、置信度、未知项与计划影响的精简历史说明。证据分高(精确提交到 PR 关联、补丁等价、评论可重映射)、中(同符号或路径且有 PR 讨论)、低(仅语义或标题匹配、路径匹配、过时或被回滚的证据)三档;证据弱时须标注 UNKNOWN 并降置信度,不得仅凭语义匹配臆测意图。

使用方式:可用脚本采集,例如 python3 scripts/history_context.py inspect --repo-dir /path/to/repo --path path/to/file.ext --start 120 --end 160 --question "Can I remove this constraint?" --format markdown;也支持 --symbol 与 --format json。另有 scripts/compact_pr.py 提取单个或多个 PR 的精简证据,scripts/validate_skill.py 校验技能结构。按需查阅 references 下 ANOMALIES、GH_CLI、DECISION_ATOMS、OUTPUT_SCHEMA、EVALUATION。

限制:git blame 只是线索而非真相,格式化提交、移动、压缩合并与重构会掩盖来源;压缩合并常需补丁或 hunk 匹配;路径不构成身份,需追踪文件谱系与符号指纹;被回滚的 PR 属过时证据;大型 gh api 响应可能被截断,此时证据应标记为不完整。其余安装与具体平台细节资料暂未提供。