PID0 文档站 — Claude 工作指南
@AGENTS.md项目背景
- 站点：pid0.cn，面向中文用户的 AI 工具与建站实用教程
- 平台：Mintlify，配置入口
docs.json - 内容语言：中文（简体），代码/命令保持英文原文
- 当前栏目：AI 工具（MCP 系列）、Claude 使用手册、建站
术语规范
| 使用 | 避免 |
|---|---|
| MCP 服务器 | MCP server（正文中） |
| Claude Code | Claude code / claude code |
| 公众号 | 微信公众号（首次出现后简称） |
使用已安装的 Skills
优先调用 Skill，不要手动重复其逻辑：文档与站点
| 任务 | Skill |
|---|---|
| 新建/修改 Mintlify 页面、配置导航 | mintlify |
| 规划站点页面层级与导航结构 | site-architecture |
| 前端组件/界面开发 | frontend-design |
内容创作
| 任务 | Skill |
|---|---|
| 规划内容选题、决定写什么 | content-strategy |
| 撰写/改写落地页、功能页文案 | copywriting |
| 优化已有文案/文档表达 | copy-editing |
| 将一篇内容转化为多种格式 | content-repurposing |
| 社交媒体内容（Twitter/LinkedIn 等） | social-content |
SEO
| 任务 | Skill |
|---|---|
| AI 搜索优化（被 LLM 引用） | ai-seo |
| 关键词调研与聚类 | keyword-research |
| SEO 诊断与技术问题排查 | seo-audit |
| 批量生成 SEO 落地页 | programmatic-seo |
| 添加/修复结构化数据 Schema | schema-markup |
增长与转化
| 任务 | Skill |
|---|---|
| 优化营销页转化率 | page-cro |
| 优化注册/激活流程 | signup-flow-cro |
| 优化新用户引导与 time-to-value | onboarding-cro |
| 设计/优化弹窗与横幅 | popup-cro |
| 优化非注册表单（线索获取等） | form-cro |
| 设计付费墙/升级弹窗 | paywall-upgrade-cro |
| 用户留存与流失防治 | churn-prevention |
| 定价策略与套餐设计 | pricing-strategy |
| 推荐/裂变计划设计 | referral-program |
| 线索磁铁设计 | lead-magnets |
| A/B 测试规划与实施 | ab-test-setup |
营销推广
| 任务 | Skill |
|---|---|
| 获取营销创意与策略灵感 | marketing-ideas |
| 竞品分析与功能对比 | competitor-teardown |
| 竞品对比/替代品落地页 | competitor-alternatives |
| 产品上市策略 | launch-strategy |
| 广告素材生成与迭代 | ad-creative |
| 付费广告投放策略 | paid-ads |
| B2B 冷邮件与跟进序列 | cold-email |
| 邮件自动化序列 | email-sequence |
| 销售材料（pitch deck、一页纸等） | sales-enablement |
| 营销心理学原则应用 | marketing-psychology |
| 免费工具策略（SEO/获客） | free-tool-strategy |
| 产品营销上下文文档 | product-marketing-context |
| RevOps 与线索生命周期 | revops |
| 分析埋点与追踪设置 | analytics-tracking |
Claude Code 工具链
| 任务 | Skill |
|---|---|
| 配置 Claude Code hooks/settings | update-config |
| 自定义快捷键 | keybindings-help |
| 代码质量审查与简化 | simplify |
| Review Pull Request | code-review |
| 用 Claude API/Anthropic SDK 开发 | claude-api |
| 按间隔循环执行命令 | loop |
| 创建定时 Agent 任务 | schedule |
| 发现并安装新 Skill | find-skills |
文档写作规则
- 句子简短，一句一意；标题用句子式大小写
- 粗体用于 UI 元素：点击设置
- 代码格式用于命令、路径、文件名
- 禁止：营销词汇（强大的、无缝的）、废话开头、总结段
- 新建页面后必须同步更新
docs.json导航 - 所有代码块必须标注语言
短链替换规则
生成文章前，读取docs.json 的 redirects 数组，提取所有 source 路径（如 /vultr、/aliyun）。
写作时，将正文中匹配到的关键词替换为对应短链：
- 链接格式：
https://www.pid0.cn{source}，例如/vultr→https://www.pid0.cn/vultr - 关键词匹配规则：
source去掉前缀/后即为关键词，匹配大小写不敏感（如vultr、Vultr、VULTR均匹配/vultr） - 同一关键词全部替换
- 已在链接中的文本（
[文字](url)或<a href=...>）不重复替换
验证清单（提交前）
- frontmatter 包含
title和description - 内部链接使用根相对路径，无文件后缀
-
mint broken-links通过 -
mint validate无报错