geo-doctor
CLAUDE.md0 starsChanged 4 months agoApache-2.0View on GitHub
开源 GEO（Generative Engine Optimization）审计 CLI。TypeScript + Node ≥20 + pnpm，Apache-2.0。 .claude/skills/ 下有 14 份技能文档，覆盖变更管控/调试/事故考古/架构契约/诊断/验收。 入口：skill-map——按症状路由，动手前先查。 最常触碰的三条硬约束（详情见对应文档）： 用户可见文案一律双语（Bilingual 类型强制）；代码注释英文；工程文档中文。
In this repository14 other files it gives its agents.
- acceptance-gatesSkill
- architecture-contractsSkill
- bilingual-docs-contractSkill
- debug-audit-pipelineSkill
- debug-site-quirksSkill
- debug-test-failuresSkill
- diagnostic-commandsSkill
- evidence-registry-contractSkill
- failure-archaeologySkill
- release-versioning-controlSkill
- rule-change-controlSkill
- security-boundariesSkill
- showcase-refresh-protocolSkill
- skill-mapSkill
The file
Files
GEODoctor — 项目指引
开源 GEO（Generative Engine Optimization）审计 CLI。TypeScript + Node ≥20 + pnpm，Apache-2.0。
工程文档体系
.claude/skills/ 下有 14 份技能文档，覆盖变更管控/调试/事故考古/架构契约/诊断/验收。
入口：skill-map——按症状路由，动手前先查。
最常触碰的三条硬约束（详情见对应文档）：
- 改规则/阈值 → 必读 rule-change-control（33 合同、fixture 25 词余量、showcase 快照失效链）
- 触碰站点数据 → 必读 security-boundaries（SSRF/终端注入/XSS 三道防线、UA 不许伪装）
- 验证命令禁止
test | tail && commit管道写法——退出码会被吞（failure-archaeology 案 1）
常用命令
pnpm typecheck && pnpm test # 合入前门禁(CI 不跑 coverage,本地 pnpm test:coverage)
pnpm build # 调试跑 dist/,改完 src 必须重建
node dist/cli.js audit <url> --json /tmp/r.json # 现网诊断入口语言约定
用户可见文案一律双语（Bilingual 类型强制）；代码注释英文；工程文档中文。
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
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.