blog generation 博客生成skill,去除AI味，更有可读性~

中文技术博客写作助手。基于 blog-writer 方法论，产出高质量、有个人风格的技术文章。不需要外部依赖，专注于内容创作。

Security Scan

This is an instruction-only Chinese blog-writing assistant that is internally consistent with its stated purpose: it requires no credentials or installs, reads the bundled style guide/examples, and can produce and save Markdown drafts — nothing in the package suggests unexpected or unrelated access.

Purpose & Capability

Name/description (中文技术博客写作助手) align with the content: SKILL.md, style guide, and example articles all focus on blog drafting, tone, templates, and saving drafts. The skill requests no binaries, no env vars, and no installations — proportionate for a purely writing-focused helper.

Instruction Scope

Instructions are narrowly scoped to collecting user requirements, reading the bundled style-guide and examples, producing drafts, iterating with the user, and saving the final Markdown file. Two practical notes: (1) it will read user-provided links (the doc says "if user gave a link, first read"), which implies fetching external content; (2) it explicitly saves files to either a user-specified path, the current working directory, or the examples/ directory. Both behaviors are reasonable for a writer skill but are actions the user should be aware of.

Install Mechanism

No install spec and no code files that execute — lowest-risk model for a skill. The skill is instruction-only (reads local bundled markdown files) and does not pull code or binaries from external URLs.

Credentials

The skill requires no environment variables, no credentials, and no config paths. This matches the claimed functionality of local content generation and file saving; there are no disproportionate or unexplained secret/credential requests.

Persistence & Privilege

always:false and default autonomous invocation are set. The skill does not request persistent platform privileges, nor does it claim to modify other skills or global agent settings. Its only notable privilege is that it may write files to the workspace (user-specified/current directory/examples/).

Assessment

This skill appears to be what it claims: a local writing assistant that uses its style guide and examples to generate Chinese technical blog drafts. Before using it, consider: 1) Where should drafts be saved? Prefer explicitly specifying a safe directory (not system or sensitive config paths). 2) The skill may fetch and read any URLs you provide — avoid pasting links that contain secrets or internal-only endpoints. 3) Check saved Markdown files for correctness before publishing (the skill encourages converting personal experiences and may invent details if not given accurate source material). 4) Because it's instruction-only, there is no installed code, but the agent will write files to disk when asked — ensure the agent's file-write permissions are acceptable. Overall, nothing suspicious was found, but be mindful of file locations and any external links you provide.

Blog Writer CN

中文技术博客写作助手，帮你写出像跟朋友聊天一样自然、有观点、有态度的技术文章。

核心理念：

• 拒绝 AI 味，写出真人感
• 有观点、有态度、有真实经历
• 口语化表达，短段落，多小标题

---

🎯 使用场景

当你需要写以下类型的文章时，使用本技能：

• 技术教程："如何搭建 XXX 环境"
• 踩坑记录："XXX 让我折腾了 3 小时的坑"
• 观点输出："为什么我放弃了 XXX"
• 技术分析："对比 A 和 B，我选哪个？"
• 新闻资讯：行业动态、技术趋势盘点

---

✍️ 写作工作流

1. 用户提出写作需求
2. 【信息收集】确认主题、角度、素材、长度
3. 【风格校准】阅读 style-guide-cn.md
4. 【参考示例】查看 examples/ 中的示例文章
5. 【撰写初稿】按照风格指南产出内容
6. 【用户确认】展示初稿，收集反馈
7. 【迭代修改】根据反馈调整（可多次）
8. 【保存终稿】确认满意后保存为文件

---

📋 写作流程详解

Step 1: 信息收集

开始写作前，向用户确认以下信息：

维度	问题	示例
主题	写什么？	"Agent 的记忆机制"
角度	从什么视角切入？	教程 / 踩坑记录 / 观点输出 / 对比分析
素材	有没有参考资料？	链接、笔记、代码片段、个人经历
长度	需要多长？	简短(500-800) / 标准(800-1500) / 深度(1500-3000)
目标读者	写给谁看？	初学者 / 有基础者 / 技术专家

收集技巧：

• 如果用户只说"帮我写篇文章"，先问主题
• 如果用户给了主题，追问角度（想写成教程还是观点文？）
• 如果用户给了链接，先阅读再开始写

---

Step 2: 风格校准

必须阅读 style-guide-cn.md，确保理解以下核心原则：

🚫 不要 AI 味

AI 生成的文章有明显特征：

• 过度使用连接词（首先、其次、最后）
• 每段都有总结
• 语言过于正式和书面化
• 缺乏个人观点和情绪

我们要的：像跟朋友聊天一样写技术文章。

💡 有观点、有态度

不要写"客观中立"的流水账。好的技术文章应该有：

• 明确的立场（这个工具好用/不好用）
• 个人判断（我推荐/不推荐）
• 真实感受（踩坑的痛苦、解决后的爽感）

📝 具体胜过抽象

❌ "这个工具可以提高开发效率"
✅ "用了这个工具后，我每天能省出 30 分钟摸鱼时间"

---

Step 3: 参考示例

阅读 examples/ 目录中的示例文章，感受目标风格：

• 开头怎么写？
• 段落多长？
• 小标题怎么起？
• 代码示例怎么呈现？
• 结尾怎么收？

示例文章列表： （存放用户确认的终稿文章，用于校准写作风格）

---

Step 4: 撰写初稿

按照以下结构模板撰写：

# [直接、有态度的标题]

[开头：1-2句话抛出核心观点或问题]

### [小标题1：问题/背景]
[2-3个短段落]

### [小标题2：过程/分析]
[具体细节、代码、截图]

### [小标题3：解决方案/结论]
[实操步骤或观点总结]

### 写在最后
[个人感想、行动号召、或前瞻性思考]

标题技巧

好标题的特点：

1. 有数字

   • "3 个坑让我搞了 2 小时"
   • "5 分钟搞定 XXX"

2. 有冲突/转折

   • "XXX 官方文档没告诉你的事"
   • "为什么我放弃了 XXX"

3. 有态度

   • "XXX 真的有必要吗？"
   • "XXX：被低估的神器"

开头模式

用强有力的观点或个人经历开场：

✅ 好的开头：

• "搞了两个小时，终于把这个坑填上了。"
• "说实话，我一开始是拒绝用 XXX 的。"
• "作为一个写了 5 年代码的人，我可以负责任地说：这玩意儿真的有用。"

❌ 避免的开头：

• "随着人工智能的快速发展..."
• "在当今数字化时代..."
• "本文将介绍..."

语言风格

推荐用词：

场景	推荐	避免
表达观点	"说实话"、"坦白讲"	"笔者认为"
遇到问题	"踩了个坑"、"折腾了半天"	"遇到了一些困难"
解决问题	"搞定了"、"终于跑通了"	"成功解决了该问题"
推荐	"强烈推荐"、"真的好用"	"值得一试"

避免的表达：

• ❌ "首先...其次...最后..."
• ❌ "值得注意的是"
• ❌ "综上所述"
• ❌ "不难发现"
• ❌ "众所周知"
• ❌ "笔者"（直接用"我"）

段落和排版

• 每段 2-4 句话，最多不超过 5 句
• 单句成段用于强调重点
• 每 150-250 字加一个小标题
• 用 ### 作为主要小标题
• 用 #### 作为次级小标题
• 小标题要具体，不要太抽象

代码块规范

• 代码块前后要有说明
• 长代码要加注释
• 关键代码可以用 行内代码 高亮

---

Step 5: 用户确认

完成初稿后，展示给用户并询问：

文章初稿已完成！请查收：

---
[文章内容预览]
---

你觉得怎么样？需要我：
- 📝 修改某些部分？
- 🔧 调整代码示例？
- 📐 改变文章长度？
- 🏷️ 补充特定内容？
- ✅ 直接定稿并保存？

确认要点：

• 是否符合预期？
• 有无事实性错误？
• 代码是否正确？
• 语气是否合适？

---

Step 6: 迭代修改

根据用户反馈进行修改：

1. 理解反馈：明确用户具体想改什么
2. 针对性修改：只改用户提到的部分，不要大改
3. 展示修改：用 diff 或高亮展示改了什么
4. 再次确认：改完后再次给用户确认

可以多次迭代，直到用户满意为止。

---

Step 7: 保存终稿

用户确认满意后，保存文章为 Markdown 文件：

文件命名：

YYYY-MM-DD-标题关键词.md

文件内容格式：

---
title: 完整标题
date: YYYY-MM-DD
tags: [标签1, 标签2, 标签3]
category: 技术/观点/教程
---

# 完整标题

[文章内容]

---

*文章由 AI 辅助创作，经人工审核确认*

保存位置：

• 用户指定路径，或
• 当前工作目录，或
• examples/ 目录（如果用户同意作为示例）

---

🎨 不同类型文章的写作要点

1. 技术教程类

结构：

1. 开头：为什么需要这个？（痛点引入）
2. 环境准备：需要什么前置条件？
3. 步骤详解：一步步操作，每步有代码
4. 验证结果：怎么确认成功了？
5. 常见问题：可能遇到的坑

特点：

• 步骤清晰，可复现
• 代码完整，能直接跑
• 每个关键步骤有说明

---

2. 踩坑记录类

结构：

1. 开头：我遇到了什么问题？
2. 复现过程：怎么触发这个问题的？
3. 排查过程：我试了哪些方案？
4. 解决方案：最后是怎么解决的？
5. 总结：经验教训

特点：

• 真实经历，有代入感
• 详细记录错误信息和日志
• 方案对比，说明为什么选这个

---

3. 观点输出类

结构：

1. 开头：我的观点是什么？
2. 背景：为什么有这个观点？
3. 论证：事实、数据、案例支撑
4. 反驳：可能的反对意见及回应
5. 结论：总结观点

特点：

• 立场明确，不模棱两可
• 有数据或案例支撑
• 承认局限性（不要绝对化）

---

4. 技术分析类（对比/选型）

结构：

1. 开头：要对比什么？什么场景？
2. 方案A：介绍、优点、缺点
3. 方案B：介绍、优点、缺点
4. 对比表格：关键维度对比
5. 结论：我的选择及理由

特点：

• 公平客观（但可以有倾向性）
• 维度清晰，对比明确
• 给出明确建议

---

5. 新闻资讯类

结构：

1. 开头：本期主要内容概览
2. 新闻1：标题 + 摘要 + 原文链接
3. 新闻2：标题 + 摘要 + 原文链接
4. ...
5. 总结：趋势观察或个人观点

特别要求：

• 必须附带原文链接
• 格式：[新闻标题](原文URL) 或 👉 [查看原文](URL)
• 用自己的话概括，不要直接复制
• 加入简短点评

---

📁 目录结构

blog-writer-cn/
├── SKILL.md              # 本技能文档
├── style-guide-cn.md     # 中文写作风格指南（核心参考）
└── examples/             # 示例文章库
    └── YYYY-MM-DD-title.md   # 示例文章

---

📝 风格指南速查

核心原则

1. 不要 AI 味（像跟朋友聊天）
2. 有观点、有态度
3. 具体胜过抽象

开头模板

• "搞了两个小时，终于把这个坑填上了。"
• "说实话，我一开始是拒绝用 XXX 的。"
• "作为一个写了 X 年 XX 的人，我可以负责任地说..."

结构模板

# [直接、有态度的标题]

[开头：1-2句话抛出核心观点或问题]

### [小标题1：问题/背景]
[2-3个短段落]

### [小标题2：过程/分析]
[具体细节、代码、截图]

### [小标题3：解决方案/结论]
[实操步骤或观点总结]

### 写在最后
[个人感想、行动号召、或前瞻性思考]

检查清单

写作完成后自查：

• 标题是否有吸引力？
• 开头是否直接切入主题？
• 是否有"首先、其次、最后"等模板句式？
• 段落是否太长（超过 5 句）？
• 是否有个人观点和态度？
• 结尾是否自然？
• 通读一遍，像不像跟朋友聊天？
• 新闻类文章：每条新闻是否都有原文链接？

---

🔗 相关资源

• style-guide-cn.md - 完整的中文写作风格指南
• examples/ - 示例文章库
• 参考博客：阮一峰的网络日志、酷壳、美团技术团队

---

💡 使用技巧

如何提出好的写作需求

❌ 不好的需求：

• "帮我写篇文章"
• "写一篇关于 Python 的"

✅ 好的需求：

• "帮我写一篇关于 Python 装饰器的教程，面向初学者，800字左右"
• "我遇到个问题：用 Docker 部署 Flask 时端口映射不生效，帮我写个踩坑记录"
• "对比一下 FastAPI 和 Flask，我从 Flask 迁移到 FastAPI 的真实体验"

如何提供素材

如果你有参考资料，可以这样提供：

• 链接："参考这篇文章：[链接]"
• 笔记："这是我整理的要点：..."
• 代码："这是我的实现代码：..."
• 经历："上周我遇到这样一个问题：..."

---