写作助手基础版

核心能力: 内容创作领域的专业化 AI 辅助工具,提供核心基础功能支持. 适用场景: 个人用户与轻量级场景,涵盖日常操作、自动化工作流与智能决策辅助. 差异化: FREE 版本,面向个人用户提供核心功能、简洁操作与社区支持. 适用关键词: 写作, 助手, 文档, 内容, 风格, 质量检查, 编辑

概述

本工具是 内容创作 领域的 FREE 版本 AI Skill,专为个人用户与轻量级场景设计。通过自然语言指令驱动 AI Agent 执行任务,提供核心功能与简洁易用的操作体验. FREE 版本与 PRO 版本完全兼容,可在需要时升级至 PRO 版本获取高级功能、批量操作与团队协同能力.

版本定位

维度	FREE 版本	PRO 版本
目标用户	个人用户	企业团队
功能范围	核心功能	全部功能
批量操作	不支持	支持
团队协作	不支持	支持
技术支持	社区支持	优先响应
数据分析	基础统计	高级分析

核心能力

FREE 版本提供以下能力:

研究协调

研究协调:收集与整合素材

处理: 解析研究协调的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回研究协调的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

结构规划

结构规划:设计文章大纲与逻辑

处理: 解析结构规划的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结构规划的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

风格匹配

风格匹配:根据样本调整写作风格

处理: 解析风格匹配的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回风格匹配的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

质量检查

质量检查:语法、逻辑与可读性

处理: 解析质量检查的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回质量检查的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

多轮迭代

多轮迭代:支持修改直到满意

处理: 解析多轮迭代的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回多轮迭代的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

功能详情

本版本提供 5 项核心能力,覆盖 内容创作 的常见使用场景。如需批量操作、团队协作、数据分析等高级功能,可升级至 PRO 版本. FREE 版本核心功能清单:

• 研究协调:收集与整合素材
• 结构规划:设计文章大纲与逻辑
• 风格匹配:根据样本调整写作风格
• 质量检查:语法、逻辑与可读性
• 多轮迭代:支持修改直到满意

PRO 版本扩展功能预览:

• 品牌语调管理:多品牌风格配置
• 多人协作审稿:草稿->审阅->修改->定稿
• 内容库治理:归档、去重与版本控制
• 发布管道:一键发布至多平台
• SEO 与可读性双重评分
• 内容日历与选题建议引擎

处理: 解析功能详情的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回功能详情的响应数据,包含状态码、结果和日志. 技术参数：使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：写作团队负责人、协调研究、风格与质量检查、产出高质量文档、内容创作领域的专、辅助工具、提供核心基础功能等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景 1: 撰写技术文档

协调研究、结构、风格与质量检查产出技术文档

输入格式

参数名	类型	必填	说明
input	string	是	写作助手基础版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

bash

# 工作流
1. 研究: 收集技术资料与参考链接
2. 结构: 设计文档大纲
   - 概述
   - 架构设计
   - 实现细节
   - 测试方案
3. 写作: 按结构撰写内容
4. 质量检查: 语法/逻辑/可读性
5. 迭代: 修改直到满意

场景 2: 品牌内容创作

按照品牌语调撰写营销内容

bash

# 输入: 品牌风格指南 + 主题
# 输出
- 匹配品牌语调的内容
- 符合品牌视觉规范的结构
- SEO 优化建议
- 多平台适配版本

快速开始

1. 环境准备

确保已安装并配置好 AI Agent 环境(Claude Code / Cursor / Codex / Gemini CLI 等),本 Skill 通过 SKILL.md 指令驱动 Agent 执行任务. 系统要求:

• 操作系统: Windows / macOS / Linux
• Agent 平台: 支持 SKILL.md 格式的任意 AI Agent
• 运行时: Python 3.8+ 或 Node.js 18+(视具体操作需求)

2. 配置参数

bash

# 写作助手配置
{
  "voice": "professional, clear, engaging",
  "target_audience": "technical professionals",
  "word_count": "1500-3000",
  "quality_checks": ["grammar", "logic", "readability", "seo"],
  "iteration_limit": 5
}

3. 验证配置

配置完成后,可通过以下方式验证是否正常工作:

bash

# 验证环境变量是否设置
echo "配置检查:"
env | grep -E "API|KEY|TOKEN|SECRET" | sed "s/=.*/=***/"  # Linux/macOS
# 或 PowerShell
# Get-ChildItem Env: | Where-Object {$_.Name -match "API|KEY|TOKEN"} | Format-Table

4. 开始使用

在 AI Agent 对话中描述你的需求,Agent 会根据本 Skill 的指令自动执行对应操作.

text

请帮我撰写技术文档

Agent 将自动:

1. 解析你的自然语言指令
2. 调用相应的工具或 API
3. 执行操作并返回结果
4. 返回执行结果供你确认

示例

基础配置

bash

# 写作助手配置
{
  "voice": "professional, clear, engaging",
  "target_audience": "technical professionals",
  "word_count": "1500-3000",
  "quality_checks": ["grammar", "logic", "readability", "seo"],
  "iteration_limit": 5
}

可选配置

json

{
  "edition": "free",
  "auto_retry": false,
  "max_concurrent": 1,
  "log_level": "info",
  "cache_enabled": true,
  "timeout": 30
}

FREE 配置项说明:

配置项	类型	默认值	说明
auto_retry	bool	false	失败后自动重试
max_concurrent	int	1	最大并发数(FREE 限制为1)
log_level	string	info	日志级别
cache_enabled	bool	true	启用结果缓存
timeout	int	30	操作超时时间(秒)

最佳实践

1. 先确定结构再展开写作
2. 风格匹配需要提供样本文章
3. 质量检查覆盖语法逻辑与可读性
4. 多轮迭代确保内容质量

个人使用建议

• 从简单任务开始熟悉工具行为,逐步扩展到复杂场景
• 定期备份配置文件与数据,防止意外丢失
• 遇到问题先查阅常见问题章节,再寻求社区帮助
• 保持配置简洁,只启用必要的功能选项
• 定期更新工具版本以获取最新功能与修复
• 记录常用操作命令,提高日常使用效率

常见问题

Q: 支持哪些文档类型?

A: 技术文档、博客文章、营销文案、产品说明、报告等多种类型.

Q: 可以多人协作吗?

A: FREE 版不支持;PRO 版支持多人协作审稿与版本管理.

Q: 如何升级到 PRO 版本?

A: 升级到 PRO 版本非常简单:

1. 获取 PRO 版本授权
2. 安装 PRO 版本 Skill
3. 原有配置自动迁移,无需额外操作
4. 即可使用批量操作、团队协作等高级功能

已知限制

A: FREE 版本主要限制:

• 不支持批量操作(每次只能处理一个任务)
• 不支持团队协作(仅限个人使用)
• 不支持高级数据分析
• 技术支持依赖社区 如需这些功能,建议升级至 PRO 版本.

Q: FREE 版本的数据安全吗?

A: FREE 版本所有数据本地存储,不上传云端,确保隐私安全。建议定期备份配置文件与数据目录.

依赖说明

运行环境

• Agent 平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 运行时: Python 3.8+ 或 Node.js 18+(视具体操作需求)
• 网络: 部分功能需要网络连接访问外部 API

依赖详情

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由 Agent 内置 LLM 提供
curl	CLI 工具	推荐	系统自带或包管理器安装
jq	JSON 处理	推荐	apt install jq / brew install jq
Python 3.8+	运行时	视需求	python.org 下载
Node.js 18+	运行时	视需求	nodejs.org 下载

API Key 配置

FREE 版本支持单一 API Key 配置,满足个人使用需求:

• 环境变量:通过环境变量配置 API Key
• 配置文件:支持配置文件方式存储 API Key
• 安全提醒:切勿将 API Key 硬编码到脚本或提交到版本控制系统

可用性分类

• 分类: MD+EXEC(纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
• 说明: 基于 Markdown 的 AI Skill,通过自然语言指令驱动 Agent 执行任务
• FREE 特性: 支持单次执行、基础配置与社区支持
• 安全等级: 基础,数据本地存储,建议定期备份
• SLA: 社区支持,尽力响应

---

快速开始

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

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

版本信息

项目	值
版本号	1.0.0
版本类型	FREE
许可证	MIT
兼容性	可升级至 PRO 版本

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

输出格式

json

{
  "success": true,
  "data": {
    "result": "写作助手基础版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "writing assistant"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}