agentleFS
comkocscomkocs/md-workflow/.agents/skills/doc-pointer-check/SKILL.md

doc-pointer-check

Skill3 starsChanged 8 days agoApache-2.0View on GitHub

当文档改版、搬家、改名或大批改路径后,要查 md 里闸号、版本号、路径、单号、文件:行五类引用断了没,或要只核相对上一跑的新增悬空、复核别人报的指针结论时使用。凡遇到这些情况,先读本 skill 再动手。

The file

Files
SKILL.md

这个 skill 是干什么的(人话)

这个 skill 帮你查文档里的断引用:md 里写的闸号、版本号、路径、单号、文件:行五类指针,到底还指不指得到真东西,断了就一条条列出来修。不用它,改名搬家的改动面上很容易留下看着像真的死指针,下游照着走空。

分类

分类:装 core/ 即可用

用前填这几个名字

  • {{核对命令}}:指针核对脚本入口,在仓根跑;例:python -X utf8 core/tools/check_pointers.py
  • {{两仓根}}:私库根与办公仓根;默认自动探测,不在默认位置才用 --repo、--office 覆盖。

有 python 用 python;没有时将核对命令的 python -X utf8 换成 py -X utf8,其余参数不变。

什么时候用

  • 改版、搬家、改名或大批改路径之后,要查 md 引用断了没。
  • 交报告前要证明改动面上没有新增悬空指针。
  • 别人报「指针都好的」,要换一条路复核。
  • 只想核某几个目录,不做两仓全扫。

步骤

  1. 装法:只拷产品 core/ 一个目录即可用;纯标准库、全程只读,被扫文件绝无写模式。
  2. 全量跑:{{核对命令}} --out <报告目录>(不存在则建),报告里是悬空清单;私库与办公仓两仓默认都扫,台面库目录另有默认值,可用 --tickets-data 覆盖。
  3. 只看新增:再加 --baseline <上一跑例目录>,与上次的悬空清单比增量;上次清单缺失只记一行、跳过增量,不报错。
  4. 直扫模式:--paths 给出显式扫描根(可多值)后不做默认扫描、不印两仓头,适合只核改动面或外部目录。
  5. 读报告:退出码恒 0,别拿退出码当结果;悬空逐条修——指针改指真源,或修正目标件名与行号——修完重跑到清零。
  6. 参数细节以 core/tools/check_pointers.py --help 为准。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.