SuperAPI AI 工具集

setup-gitignore

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:为当前仓库初始化或幂等地修订 .gitignore,仅限单个仓库,不读写 ~/.gitignore、~/.config/git/ignore,也不运行 git config --global。

主要能力:按顺序组合四类来源——gitignore.io 模板(需联网,按检测到的语言/框架取键)、内置 AI 工具模式(references/AI-TOOLING.md)、内置 IDE/编辑器模式(references/IDE-EDITOR.md)、以及来自 git status 并需用户交互确认的未跟踪路径。

使用方式:先检测仓库根 git rev-parse --show-toplevel,非 git 仓库则报错退出;再检测语言,依据 references/LANGUAGE-DETECTION.md 的清单到 gitignore.io 键表映射,扫描 fd --max-depth 2 -t f,匹配后生成逗号分隔键列表(如 rust,node,typescript),无匹配则用空键列表。若 .gitignore 已存在,先快照 cp .gitignore /tmp/gitignore-snapshot-$(date +%s).bak。用 git status -s -uall | rg '^??' | rg -v '^?? .gitignore' 展示未跟踪路径,按顶层目录或扩展名聚类并等待用户明确确认,未确认不添加任何经验模式。运行 scripts/compose-gitignore.sh <csv> 获取并合并 gitignore.io 模板;网络失败时告知用户并询问是否仅用内置模式继续。随后按顺序追加内置块:AI TOOLING、IDE / EDITOR、EMPIRICAL。无 .gitignore 时直接写入;已存在时按 # === SECTION === 块幂等合并,已存在模式去重(先出现者优先),保留区段标题外的所有用户内容,用 difft 展示完整差异并在用户确认后才写入。最后用 git status -s -uall | rg '^??' | wc -l 对比前后未跟踪数量,列出仍未被忽略的路径。

适用场景:需要为当前仓库统一维护 .gitignore,兼顾语言/工具特定规则与经验噪声。

限制:幂等契约要求对已运行过的仓库重跑不产生差异;区段标题作为稳定合并锚点,区段外用户内容永不修改;未提供官方文档、收费与价格等信息。