> 功能说明: 本技能涵盖 提升工作效率、化工作流场景 等核心能力。
> 功能说明: 本技能涵盖 营销文案 等核心能力。
博客写作助手
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 博客写作助手处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
专业版增强能力
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 多源数据聚合与去重 | 不支持 | 支持 |
| 语义搜索与智能摘要 | 不支持 | 支持 |
| 定时监控与变化推送 | 不支持 | 支持 |
| 研究结论结构化导出 | 不支持 | 支持 |
依赖与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- 操作系统: Windows / macOS / Linux
依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
需要配置对应API Key，详见上文环境配置章节
可用性分类
- 分类: MD+EXEC（）
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
能力总览
1. 作者风格捕捉
- 参考
references/blog-examples/中的示例文章校准语气、用词、结构与长度 - 直白且有观点:清晰陈述立场,包括反主流观点
- 对话式:像与同事交流,平易但不简化
- 领先人称分享经验时自然使用"我"
- 真实的怀疑态度:必要时批评趋势
2. 研究材料整合
- 审阅并整合用户提供的任何信息、研究材料或链接
- 自然融入研究材料,不作块引用堆砌
- 保留作者视角,材料服务于论点而非主导
3. 用户指令遵循
- 严格遵循用户对主题、角度、重点的具体要求
- 默认目标长度 800-1500 字,可按用户要求调整
- 在开始写作前充分审阅所有提供的材料
4. 真实写作产出
- 强势开场:以清晰的、常为大胆的陈述开篇
- 子标题贯穿:每 2-3 段使用
###格式拆分内容 - 短段落:极少超过 3-4 句
- 个人轶事穿插:用真实例子说明观点
- 实用要点:提供可操作洞察,不止于理论
- 反思性结尾:以行动号召或前瞻性希望收尾
5. 笔记平台发布
草稿完成后(即使尚未定稿)发布到笔记平台的 TS Notes 数据库:
- 数据库数据源 ID: 04a872be-8bed-4f43-a448-3dfeebc0df21
- Type 属性设为 Writing
- Project(s) 属性链接到 My Writing 项目,页面 URL: https://notes.example.com/2a5b4629bb3780189199f3c496980c0c
- Note 属性填博客标题
- Content 填完整文章的笔记平台 Markdown 格式
6. 示例库维护
用户确认定稿后:
- 保存到 references/blog-examples/,文件名格式 YYYY-MM-DD-slug-title.md
- 示例: 2025-11-25-why-ai-art-is-useless.md
- 超过 20 篇时,征求用户许可删除最旧的 5 篇(按文件名日期前缀排序)
7. 词汇标记校准
- 使用 "leverage" 指代工具/技术
- 使用 "that said" 做过渡
- 接受 "this is useless" 或 "boy was I wrong" 等直白表达
- 自然使用缩约形式(I've, doesn't, won't)
- 避免企业黑话但保持专业度
8. 主题元素对齐
- AI 作为工具而非替代
- 实践优于理论
- 以人为中心的技术
- 对有效与无效的诚实评估
使用方法
- 收集主题、角度、研究材料、目标长度
- 参考
references/style-guide.md与示例校准风格 - 起草内容,强势开场、短段、子标题、反思结尾
- 提交草稿并迭代至用户满意
- 发布到笔记平台 TS Notes 数据库(Type=Writing, Project=My Writing)
- 用户确认定稿后保存到
references/blog-examples/
实际示例
示例1:笔记平台发布属性
{
"Note": "为什么大多数 AI 工具都在解决错误的问题",
"Type": "Writing",
"Project(s)": "[\"https://notes.example.com/2a5b4629bb3780189199f3c496980c0c\"]"
}
示例2:风格化段落
输入: "写一段关于过度自动化的开场"
输出:
### 自动化不是答案,问题是问题
# ...
我们花了三个月搭建一个自动化部署流水线,结果上线领先周就炸了三次.
boy was I wrong — 我以为自动化本身能解决问题,但真正的问题是我们根本没搞清楚要解决什么.
that said, 自动化没错,错的是我们把工具当成了策略.
示例3:定稿归档
输入: 用户确认终稿 "Why AI Art Is Useless"
处理: 保存到 references/blog-examples/
输出: 2025-11-25-why-ai-art-is-useless.md
示例库当前数量: 18/20
错误应对策略
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 笔记平台发布失败,数据源ID无效 | API token 过期或权限不足 | 重新认证,确认数据源 04a872be-8bed-4f43-a448-3dfeebc0df21 可访问 |
| 文章长度超出 800-1500 字范围 | 研究材料过多或论点发散 | 按 2-3 段一个子标题拆分,删除与主旨无关的轶事 |
| 风格偏离作者语气 | 未充分校准示例库 | 重新阅读 references/blog-examples/ 前 3 篇,对比词汇标记与段落长度 |
| 研究材料整合生硬成块引用 | 直接粘贴而非改写 | 用作者领先人称视角改写材料,融入个人经验 |
| 示例库超过 20 篇未清理 | 缺少归档流程 | 按文件名日期前缀排序,征求用户许可删除最旧 5 篇 |
| 笔记平台 Project 链接错误 | 项目页面 ID 不匹配 | 确认 Project(s) 值为数组格式,包含完整页面 URL |
| 子标题密度不足,段落过长 | 未遵循每 2-3 段一个 ### |
在长段落间插入动作导向的子标题,如 "Deploy to Production" |
常见疑问汇编
Q1: 如何校准作者风格?
A: 阅读 references/blog-examples/ 中的已发表作品,记录词汇标记(leverage、that said、缩约形式)、段落长度(2-4句)、子标题密度(每2-3段)、开场方式(大胆陈述)、结尾方式(行动号召).
Q2: 笔记平台发布是必须的吗?
A: 是。草稿完成(即使未定稿)必须发布到 TS Notes 数据库,Type=Writing,Project=My Writing。未发布视为失败。数据库数据源 ID 为 04a872be-8bed-4f43-a448-3dfeebc0df21.
Q3: 示例库达到 20 篇怎么办?
A: 按文件名日期前缀排序识别最旧文件,征求用户许可删除最旧的 5 篇。不要自动删除,必须获得明确授权.
Q4: 目标长度 800-1500 字如何把握?
A: 默认范围 800-1500 字。短文聚焦单一观点配 1-2 个轶事;长文覆盖多角度但每段保持 2-4 句。用户可显式指定长度,如 "写 2000 字深度文章".
Q5: 研究材料如何自然融入?
A: 不作块引用堆砌。用作者领先人称视角改写材料核心观点,融入个人经验作为佐证。材料服务于论点,而非主导结构.
Q6: 定稿归档的文件名格式是什么?
A: YYYY-MM-DD-slug-title.md,日期为定稿日期,slug 为 URL 友好的标题缩写。示例: 2025-11-25-why-ai-art-is-useless.md.
使用约束
- 需要LLM支持,无LLM环境无法生成内容
- 笔记平台发布依赖有效的 API token 与数据源访问权限
- 风格校准依赖
references/blog-examples/中至少 3 篇示例 - 示例库维护需要文件系统写权限
- 不适用于学术写作、新闻稿、纯技术文档
创新亮点
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 信息收集 | 1小时 | 10分钟 | 50分钟 | 30% |
| 文章起草 | 2小时 | 30分钟 | 1.5小时 | 25% |
| 审查迭代 | 1小时 | 15分钟 | 45分钟 | 20% |
| 笔记平台发布 | 30分钟 | 5分钟 | 25分钟 | 15% |
| 示例库维护 | 1小时 | 10分钟 | 50分钟 | 30% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 风格一致性 | 高 | 低 | 中 | 高 |
| 速度 | 高 | 低 | 中 | 高 |
| 数据整合能力 | 高 | 低 | 中 | 高 |
| 自动化程度 | 高 | 低 | 中 | 高 |
| 成本 | 低 | 中 | 中 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 风格不统一 | 博客文章风格不一致，影响阅读体验 | 广泛读者 | 捕捉作者风格，自动调整 | 20%提升满意度 |
| 写作效率低 | 手动写作耗时过长，影响产出 | 个人及团队 | 自动化写作，提高效率 | 50%时间节约 |
| 内容质量差 | 内容质量参差不齐，影响品牌形象 | 企业品牌 | 严格审查迭代，保证质量 | 30%提升内容质量 |
问题处理指引
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 无法启动技能 | API Key未配置或配置错误 | 检查API Key配置 | 重新配置API Key |
| 输出内容错误 | 输入数据格式不正确 | 检查输入数据格式 | 修正输入数据格式 |
| 无法发布到笔记平台 | 笔记平台配置错误 | 检查笔记平台配置 | 修正笔记平台配置 |
| 示例库维护失败 | 文件保存路径错误 | 检查文件保存路径 | 修正文件保存路径 |
| 词汇标记错误 | 词汇标记规则错误 | 检查词汇标记规则 | 修正词汇标记规则 |
安全忠告
- [与「博客写作助手」相关的安全注意事项]
- 确保API Key安全，避免泄露到公共或版本控制系统中。
- 定期检查输入数据，防止恶意内容被自动化处理。
- 对输出内容进行审查，确保内容符合道德和法律标准。
- 限制技能的访问权限，防止未授权使用。
- 定期更新技能，修复已知安全漏洞。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置，禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令，避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议，验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限，实施认证机制 | 定期审计访问日志 |
| ## 应用场景 | |||
| - 团队协作: 统一团队工作方式,减少重复劳动和沟通成本 | |||
| - 接口集成: 对接第三方API服务,实现数据自动获取和处理 | |||
| - 内容生成: 自动生成文档、代码或结构化数据 | |||
| - 文件批处理: 批量处理文件内容,支持多格式转换和解析 | |||
| - 环境管理: 批量管理开发环境和部署流程 | |||
| - 信息检索: 快速搜索和过滤目标数据 | |||
| - 数据管道: 构建ETL流程,实现数据自动化流转 |
