关于 ignore
ignore 是用于管理 `lint-relative-paths` 全局忽略项的 skill,适合有意在 Markdown 中使用相对路径的仓库。它支持添加、查看和删除按子串匹配的工作区路径模式。
主要功能
- 01添加工作区忽略模式
- 02查看已配置模式
- 03删除模式
- 04按子串匹配工作区路径
- 05核实忽略文件变更
适用场景
- 01将仓库排除在相对路径检查之外
- 02查看现有全局忽略项
- 03删除过时的工作区模式
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill ignore安装后在 Claude Code 中输入/ignore确认已加载。
附带文件references/evolution-log.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 流程
工作流
- 检查当前状态:运行
list以显示现有模式 - 选择操作:使用 AskUserQuestion 选择操作:
- “添加新模式” -> 提示输入模式
- “移除现有模式” -> 显示当前模式供选择
- “仅查看当前模式” -> 显示并退出
- 输入模式:对于添加或移除操作,使用 AskUserQuestion 并提供示例
- 执行:运行管理脚本
- 验证:确认更改已应用
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 检查文件权限 |
| 找不到脚本 | 未安装插件 | 从市场重新安装插件 |
执行后反思
此技能完成后,在结束前检查:
- 命令是否成功? — 如果没有,请修复导致失败的说明或错误表。
- 参数或输出是否发生变化? — 如果底层工具的接口发生变化,请更新用法示例和参数表,使其保持一致。
- 是否需要采用变通方法? — 如果不得不临时调整(使用不同标志、增加步骤),请更新此 SKILL.md,避免下次调用时再次需要相同的变通方法。
仅在问题真实且可复现时更新,不要基于猜测进行更新。
评论
支持 Markdown