mcpField
I
ignore

ignore

github.com/terrylica测试与质量291 次安装1 天前更新
代码仓库

关于 ignore

ignore 是用于管理 `lint-relative-paths` 全局忽略项的 skill,适合有意在 Markdown 中使用相对路径的仓库。它支持添加、查看和删除按子串匹配的工作区路径模式。

主要功能

  1. 01添加工作区忽略模式
  2. 02查看已配置模式
  3. 03删除模式
  4. 04按子串匹配工作区路径
  5. 05核实忽略文件变更

适用场景

  1. 01将仓库排除在相对路径检查之外
  2. 02查看现有全局忽略项
  3. 03删除过时的工作区模式

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill ignore

安装后在 Claude Code 中输入/ignore确认已加载。

附带文件references/evolution-log.md

详细介绍

导航:Plugin CLAUDE.md | Root CLAUDE.md

全局忽略模式

管理 lint-relative-paths 检查器的全局忽略模式。

自进化技能:此技能会在使用过程中不断改进。如果说明有误、参数发生变化,或需要采用变通方法,请立即修复此文件,不要拖延。仅针对真实且可复现的问题进行更新。

用途

某些代码仓库会有意在 Markdown 中使用相对路径(例如 ../docs/file.md),而不是以仓库根目录为基准的路径(例如 /docs/file.md)。此命令用于管理全局忽略文件,以跳过匹配工作区的路径验证。

操作

操作说明示例
add向全局忽略文件添加模式/statusline-tools:ignore add my-repo
list显示当前模式/statusline-tools:ignore list
remove从忽略文件中移除模式/statusline-tools:ignore remove my-repo

模式匹配

模式使用子字符串匹配。如果工作区路径包含某个模式,该模式就会匹配。

示例:模式 my-project 可匹配:

  • /Users/user/projects/research-repo
  • /Users/user/eon/research-repo.worktree-feature-x
  • /home/user/code/research-repo-v2

忽略文件位置

~/.claude/lint-relative-paths-ignore

以 # 开头的行是注释。

执行

跳过逻辑
  • 如果提供了操作和模式 -> 直接执行
  • 如果仅提供了 list -> 立即显示模式
  • 如果未提供参数 -> 使用 AskUserQuestion 流程
工作流
  1. 检查当前状态:运行 list 以显示现有模式
  2. 选择操作:使用 AskUserQuestion 选择操作:
    • “添加新模式” -> 提示输入模式
    • “移除现有模式” -> 显示当前模式供选择
    • “仅查看当前模式” -> 显示并退出
  3. 输入模式:对于添加或移除操作,使用 AskUserQuestion 并提供示例
  4. 执行:运行管理脚本
  5. 验证:确认更改已应用
AskUserQuestion 流程(无参数)

不带参数调用时,以交互方式引导用户:

Question: "What would you like to do with lint-relative-paths ignore patterns?"
Options:
  - "Add pattern" -> "Add a new repository pattern to skip path linting"
  - "List patterns" -> "Show all current ignore patterns"
  - "Remove pattern" -> "Remove an existing pattern from the ignore list"

对于“添加模式”:

Question: "Enter the repository pattern to ignore"
Note: Patterns use substring matching. Example: 'research-repo' matches any path containing 'research-repo'.
直接执行(带参数)

解析 $ARGUMENTS 并运行管理脚本:

/usr/bin/env bash << 'IGNORE_SCRIPT_EOF'
PLUGIN_DIR="$(cc-plugin-root statusline-tools)"
bash "$PLUGIN_DIR/scripts/manage-ignore.sh" $ARGUMENTS
IGNORE_SCRIPT_EOF

手动编辑

也可以手动编辑忽略文件:

# View current patterns
cat ~/.claude/lint-relative-paths-ignore

# Add a pattern manually
echo "my-repo-pattern" >> ~/.claude/lint-relative-paths-ignore

故障排除

问题原因解决方案
模式未匹配子字符串匹配严格使用更宽泛的模式(例如,使用 forge 而不是 research-repo)
找不到忽略文件~/.claude 不存在使用 mkdir -p ~/.claude 创建
权限被拒绝文件不可写使用 ls -la 检查文件权限
找不到脚本未安装插件从市场重新安装插件

执行后反思

此技能完成后,在结束前检查:

  1. 命令是否成功? — 如果没有,请修复导致失败的说明或错误表。
  2. 参数或输出是否发生变化? — 如果底层工具的接口发生变化,请更新用法示例和参数表,使其保持一致。
  3. 是否需要采用变通方法? — 如果不得不临时调整(使用不同标志、增加步骤),请更新此 SKILL.md,避免下次调用时再次需要相同的变通方法。

仅在问题真实且可复现时更新,不要基于猜测进行更新。

评论

支持 Markdown