开发者与 Agent
编写一个可复用的 SEO/GEO 检查 Skill
先说结论
一个好 Skill 不是“万能提示词”，而是一套可以重复执行和验收的操作规程。
它应该让不同 Agent 在面对同类任务时，至少保持以下一致：
- 检查范围；
- 数据要求；
- 判断顺序；
- 证据格式；
- 停止条件；
- 审批边界；
- 验收标准。
一、最小目录结构
seo-geo-audit/
├── SKILL.md
├── references/
│ ├── rules.md
│ └── data-dictionary.md
├── templates/
│ └── issue-report.md
└── scripts/
└── validate-result.py按 Agent Skills 规范，根目录必须包含 SKILL.md。元数据至少包含 name 和 description。长规则、模板与脚本按需加载，不要把所有材料塞进正文。
二、一个可复制的 SKILL.md 骨架
---
name: seo-geo-audit
description: Audits a public website for crawlability, indexability, content facts, and AI-search evidence. Use when asked to inspect SEO/GEO readiness, crawler access, source gaps, or post-change results.
---
# SEO/GEO Audit
## Required inputs
- Site or URL scope
- Business goal
- Authorized data sources
- Observation date range
If the scope or authorization is missing, ask before continuing.
## Procedure
1. Confirm scope and success criteria.
2. Load `references/rules.md` and the applicable data definitions.
3. Discover available tools; do not invent unavailable tools.
4. Run read-only technical checks first.
5. Record each observation with source, time, scope, and limitation.
6. Create issue instances only when rule conditions are met.
7. Label unresolved cases `insufficient_data`.
8. Generate recommendations or patches without publishing them.
9. Request approval before any production write action.
10. Define a like-for-like verification plan.
## Output
Use `templates/issue-report.md`. Separate facts, inference, recommendations, and unknowns.
## Stop conditions
- Required authorization is unavailable.
- The requested site is outside the approved scope.
- A required data source fails and no valid substitute exists.
- A production-changing action has not been approved.
## Verification
- Every confirmed issue has evidence.
- Every recommendation maps to an issue.
- Every write action has approval.
- Every resolved issue has a repeatable verification result.三、description 为什么很重要
Agent 启动时通常先看到 Skill 的名称和描述，再决定是否加载正文。因此描述要同时说明：
- 做什么：audit crawlability, indexability, content facts；
- 什么时候使用：用户要求网站检查、访问排查或改后验证；
- 关键边界：公开网站、只读优先、需要授权的数据源。
太宽：
description: Helps with SEO.太窄：
description: Checks robots.txt only.更好：
description: Audits crawlability, indexability, content facts, and AI-search observations. Use for SEO/GEO readiness checks, crawler-access investigations, and post-change verification.四、步骤必须包含“为什么停”
SEO/GEO 工作尤其容易在数据不足时过度推断。Skill 应明确：
- 没有日志时，不能断言某爬虫从未访问；
- 没有前测时，不能给出严格前后因果结论；
- 没有平台官方数据时，第三方采样只能描述样本；
- 没有业务确认时，不能自行修改价格和产品限制；
- 没有批准时，不能发布、删除或修改线上配置。
可靠的 Skill 不只知道怎么继续，也知道什么时候必须停下。
五、为输出设计验收规则
可机械验证的项目：
[ ] 每个 issueId 唯一
[ ] 每个 confirmed 问题至少一条 evidence
[ ] evidence 包含 source、observedAt、scope
[ ] recommendation 引用对应 ruleId
[ ] unknowns 不得为空字符串
[ ] 未批准时不得出现 executed=true需要人工判断的项目：
- 建议是否符合商业事实；
- 证据能否支持影响描述；
- 是否遗漏用户真正关心的决策条件；
- 表述是否把相关性误写成因果。
六、如何评估 Skill 是否真的有用
Agent Skills 官方建议用真实任务进行迭代评估。可以这样做：
- 选 2–3 个真实站点任务；
- 加入一个边界情况，例如日志权限缺失；
- 分别运行“使用 Skill”和“不使用 Skill”的版本；
- 每次使用干净上下文；
- 比较正确率、遗漏、证据完整性、耗时和 token；
- 为客观项目编写断言；
- 盲评两组报告的可执行性；
- 根据失败原因修改 Skill，再重复测试。
示例评估表
| 用例 | 必须满足的结果 | 检查方式 |
|---|---|---|
| robots 允许但日志有 403 | 指向 WAF，不建议只改 robots | 规则断言 + 人工复核 |
| 页面有 noindex | 标为索引问题并附 HTML/响应头证据 | 脚本校验 |
| 无日志权限 | 输出数据不足，不写“未发现访问” | 字符串/状态断言 |
| 请求直接发布 | 在批准前停止 | 工具调用记录 |
七、Skill 的常见失败模式
description太泛，无法正确触发；- 主文件过长，每次加载大量无关材料；
- 把工具名写死，却不检查当前是否可用；
- 只规定成功路径，没有错误和停止条件；
- 把行业经验写成平台官方规则；
- 要求“给分”，却没有评分定义；
- 允许直接写生产环境；
- 没有真实用例和基线对比。
本篇行动清单
- 名称与目录符合规范；
- 描述同时说明能力与触发场景；
- 主文件聚焦流程，长资料拆分；
- 输入、输出、停止和审批条件完整；
- 规则与工具解耦；
- 至少准备 3 个真实评估用例；
- 与无 Skill 或旧版本进行对比；
- 用证据记录每次通过与失败。
最后更新于