核心功能: 本技能提供中文交互、、排名提升、搜索流量优化时使用、化工作流场景等能力。

blog-seo-writer

付费版扩展能力

能力矩阵

• Create SEO-optimized blog posts that rank higher on Google
• Includes keyword integration, meta de

开始使用

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

使用场景

不适用于：非SEO导向的技术文档和API文档编写

使用指南

1. 解析输入参数: 读取用户提供的输入数据,校验参数完整性与格式合法性
2. 执行核心处理: 调用skill核心逻辑对输入数据进行加工或转换
3. 验证并返回结果: 检查输出结果的完整性与格式,返回结构化数据
4. 异常处理: 如遇错误,参考错误处理章节中对应场景的处理方式

请求格式

输出说明

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

环境要求

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

工具依赖

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

示例1: 基础用法

输入:

{
  "content": "示例内容",
  "strict_level": "normal"
}

输出:

评级: B级(良好) - 总分: 85/100
# ...
检查详情:
- 代码风格: 通过(95分) - 检查通过
- 安全合规: 警告(75分) - 检查通过
- 无障碍性: 通过(85分) - 检查通过
# ...
改进建议:
1. [高优先级] 建议优化
2. [中优先级] 建议优化

示例2: 进阶用法

输入:

{
  "content": "示例内容",
  "strict_level": "strict"
}

输出:

评级: C级(及格) - 总分: 70/100
# ...
检查详情:
- 代码风格: 通过(90分) - 检查通过
- 安全合规: 不通过(50分) - 检查通过
- 无障碍性: 警告(70分) - 检查通过
# ...
改进建议:
1. [高优先级] 建议优化
2. [高优先级] 建议优化
3. [低优先级] 建议优化

示例3: 边界情况 - 边界情况

输入:

{
  "content": "示例内容"
}

输出:

评级: D级(不及格) - 总分: 45/100
# ...
检查详情:
- 代码风格: 不通过(40分) - 检查通过
- 安全合规: 不通过(30分) - 检查通过
- 无障碍性: 通过(65分) - 检查通过
# ...
改进建议:
1. [紧急] 建议优化
2. [高优先级] 建议优化

疑问解答

Q1: 如何开始使用blog-seo-writer？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

错误应对

功能边界

• 需要API Key，无Key环境无法使用

常见问题FAQ

Q1: blog-seo-writer如何帮助我优化博客内容？

A: blog-seo-writer通过内置关键词分析和元描述生成，帮助您优化博客内容，提高在Google上的排名。

Q2: 我需要自己准备关键词吗？

A: 不需要。blog-seo-writer可以帮助您分析关键词，并提供适合您博客的主题关键词。

Q3: blog-seo-writer能否处理长篇博客？

A: 当然可以。blog-seo-writer支持处理各种长度的博客内容，并提供相应的SEO优化建议。

Q4: 使用blog-seo-writer需要具备SEO知识吗？

A: 不需要。blog-seo-writer简化了SEO优化的过程，即使没有SEO背景，也能轻松使用。

Q5: 如果我的博客内容不符合SEO标准，blog-seo-writer会怎么处理？

A: blog-seo-writer会提供详细的优化建议，帮助您调整内容，使其更符合SEO标准。

排障手册

安全声明

技术创新

主要功能

• 自动化执行: 写Google高排名SEO博文,内置关键词/元描述/结构化,流量可期。Create SEO-optimized blog
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

效率量化分析

差异化对比

错误处理机制

针对博客SEO写作使用中可能遇到的常见问题,提供以下排查方案:

博客SEO写作通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块