blog-writer

当以作者独特的写作风格撰写博客文章、文章或长篇内容时，应该使用这项技能。它产生真实的、有主见的内容，与作者的声音相匹配——直接、对话式，并且基于个人经验。该技能处理从研究审查到概念发布的完整工作流程。使用此技能起草博客文章、思想领导力文章或任何旨在反映作者对人工智能、生产力、销售、营销或技术主题观点的文章。

## 概述（中文）

当以作者独特的写作风格撰写博客文章、文章或长篇内容时，应该使用这项技能。它产生真实的、有主见的内容，与作者的声音相匹配——直接、对话式，并且基于个人经验。该技能处理从研究审查到概念发布的完整工作流程。使用此技能起草博客文章、思想领导力文章或任何旨在反映作者对人工智能、生产力、销售、营销或技术主题观点的文章。

## 原文

# Blog Writer

## Overview

This skill enables writing blog posts and articles that authentically capture the writer's distinctive voice and style. It draws on examples of the writer's published work to produce content that is direct, opinionated, conversational, and grounded in practical experience. The skill includes automatic Notion integration and maintains a growing library of finalized examples.

## When to Use This Skill

Trigger this skill when:
- The user requests blog post or article writing in "my style" or "like my other posts"
- Drafting thought leadership content on AI, productivity, marketing, or technology
- Creating articles that need the writer's authentic voice and perspective
- The user provides research materials, links, or notes to incorporate into writing

## Core Responsibilities

1. **Follow the writer's Writing Style**: Match voice, word choice, structure, and length of example posts in `references/blog-examples/`
2. **Incorporate Research**: Review and integrate any information, research material, or links provided by the user
3. **Follow User Instructions**: Adhere closely to the user's specific requests for topic, angle, and emphasis
4. **Produce Authentic Writing**: Create content that reads as genuinely the writer's voice, not generic AI-generated content

## Workflow

### Phase 1: Gather Information

Request from the user:
- Topic or subject matter
- Any specific angle or thesis to explore
- Research materials, links, or notes (if available)
- Target length preference (default: 800-1500 words)

Review all provided materials thoroughly before beginning to write.

### Phase 2: Draft the Content

Reference the style guide at `references/style-guide.md` and examples in `references/blog-examples/` for calibration.

When writing:
1. Start with a strong opening statement establishing the thesis
2. Use personal voice and first-person perspective where natural
3. Include relevant personal anecdotes or professional experience if applicable
4. Structure with clear subheadings (###) every 2-3 paragraphs
5. Keep paragraphs short (2-4 sentences)
6. Weave in research materials naturally, not as block quotes
7. End with reflection, call-to-action, or forward-looking statement

### Phase 3: Review and Iterate

Present the draft and gather feedback. Iterate until the user confirms satisfaction.

### Phase 4: Publish to Notion (REQUIRED)

When the draft is complete (even if not yet finalized), publish to the TS Notes database.

**Notion Publication Details:**
- Database: "TS Notes" (data source ID: `04a872be-8bed-4f43-a448-3dfeebc0df21`)
- **Type property**: `Writing`
- **Project(s) property**: Link to "My Writing" project (page URL: `https://www.notion.so/2a5b4629bb3780189199f3c496980c0c`)
- **Note property**: The title of the blog post
- **Content**: The full blog post content in Notion-flavored Markdown

**Example Notion API call properties:**
```json
{
  "Note": "Blog Post Title Here",
  "Type": "Writing",
  "Project(s)": "[\"https://www.notion.so/2a5b4629bb3780189199f3c496980c0c\"]"
}
```

**CRITICAL**: The outcome is considered a **failure** if the content is not added to Notion. Always publish to Notion as part of the workflow, even for drafts.

### Phase 5: Finalize to Examples Library (Post-Outcome)

When the user confirms the draft is **final**:

1. Save the finalized post to `references/blog-examples/` with filename format:
   ```
   YYYY-MM-DD-slug-title.md
   ```
   Example: `2025-11-25-why-ai-art-is-useless.md`

2. Check the examples library count:
   - If exceeding 20 examples, ask user permission to remove the 5 oldest
   - Sort by filename date prefix to identify oldest files

The post-outcome is considered **successful** when the final draft is saved to the skill folder.

## Success Criteria

| Outcome | Success | Failure |
|---------|---------|---------|
| Primary | User receives requested content AND it is added to TS Notes with Type=Writing and Project=My Writing | Content delivered but NOT added to Notion |
| Post-outcome | Final draft saved to `references/blog-examples/` | Final draft not saved when user confirms it's final |

## the writer's Writing Style Profile

### Voice & Tone
- **Direct and opinionated**: State positions clearly, even contrarian ones
- **Conversational**: Write like speaking to a colleague—accessible without being simplistic
- **First-person when sharing experience**: Use "I" naturally for personal insights
- **Authentic skepticism**: Willing to criticize trends when warranted

### Structure Patterns
- **Strong opening thesis**: Open with a clear, often bold statement
- **Subheadings throughout**: Use `###` format liberally to break up content
- **Short paragraphs**: Rarely more than 3-4 sentences
- **Personal anecdotes woven in**: Illustrate points with real examples
- **Practical takeaways**: Provide actionable insights, not just theory
- **Reflective conclusion**: End with call-to-action or forward-looking hope

### Length & Format
- Target: 800-1500 words
- Markdown format with headers and emphasis
- Minimal bullet points in prose—prefer flowing sentences

### Vocabulary Markers
- Uses "leverage" for tools/technology
- Says "that said" for transitions
- Comfortable with direct statements like "this is useless" or "boy was I wrong"
- Uses contractions naturally (I've, doesn't, won't)
- Avoids corporate jargon while maintaining professionalism

### Thematic Elements
- AI as tool, not replacement
- Practical over theoretical
- Human-centered technology
- Honest assessment of what works and what doesn't

## Resources

### references/style-guide.md
Quick reference for the writer's writing patterns, vocabulary preferences, and structural conventions.

### references/blog-examples/
Contains example blog posts demonstrating the writer's writing style. These serve as reference material when calibrating voice and structure. New finalized posts expand this library over time.

## Notion API Reference

To create a page in TS Notes:

```
Database data source ID: 04a872be-8bed-4f43-a448-3dfeebc0df21

Properties:
- "Note": (title) - The blog post title
- "Type": "Writing"
- "Project(s)": ["https://www.notion.so/2a5b4629bb3780189199f3c496980c0c"]

Content: Full blog post in Notion-flavored Markdown
```

The "My Writing" project page ID is: `2a5b4629-bb37-8018-9199-f3c496980c0c`

---

## 中文说明

# Blog Writer

## 概述

本技能能够撰写真实地捕捉作者独特声音和风格的博客文章与文章。它借鉴作者已发表作品的范例，产出直接、有主见、对话式且基于实践经验的内容。该技能包含自动 Notion 集成，并维护一个不断扩充的定稿范例库。

## 何时使用本技能

在以下情况触发本技能：
- 用户要求以"我的风格"或"像我其他文章一样"撰写博客文章或文章
- 起草关于 AI、生产力、营销或技术的思想领导力内容
- 创作需要体现作者真实声音和观点的文章
- 用户提供研究材料、链接或笔记以纳入写作

## 核心职责

1. **遵循作者的写作风格**：匹配 `references/blog-examples/` 中范例文章的声音、用词、结构和长度
2. **纳入研究**：审阅并整合用户提供的任何信息、研究材料或链接
3. **遵循用户指令**：严格遵守用户对主题、角度和重点的具体要求
4. **产出真实写作**：创作读起来真正属于作者声音的内容，而非通用的 AI 生成内容

## 工作流程

### 阶段 1：收集信息

向用户索取：
- 主题或题材
- 任何要探讨的具体角度或论点
- 研究材料、链接或笔记（如有）
- 目标长度偏好（默认：800-1500 字）

在开始写作之前，彻底审阅所有提供的材料。

### 阶段 2：起草内容

参考 `references/style-guide.md` 的风格指南以及 `references/blog-examples/` 中的范例进行校准。

写作时：
1. 以确立论点的有力开场陈述开始
2. 在自然处使用个人化的声音和第一人称视角
3. 如适用，加入相关的个人轶事或职业经验
4. 每 2-3 段使用清晰的子标题（###）进行结构化
5. 段落保持简短（2-4 句）
6. 自然地穿插研究材料，而非以块引用形式呈现
7. 以反思、行动号召或前瞻性陈述收尾

### 阶段 3：审阅与迭代

呈现草稿并收集反馈。迭代直至用户确认满意。

### 阶段 4：发布到 Notion（必需）

草稿完成后（即使尚未定稿），发布到 TS Notes 数据库。

**Notion 发布详情：**
- 数据库："TS Notes"（data source ID：`04a872be-8bed-4f43-a448-3dfeebc0df21`）
- **Type 属性**：`Writing`
- **Project(s) 属性**：链接到 "My Writing" 项目（page URL：`https://www.notion.so/2a5b4629bb3780189199f3c496980c0c`）
- **Note 属性**：博客文章的标题
- **Content**：以 Notion 风格 Markdown 编写的完整博客文章内容

**Notion API 调用属性示例：**
```json
{
  "Note": "Blog Post Title Here",
  "Type": "Writing",
  "Project(s)": "[\"https://www.notion.so/2a5b4629bb3780189199f3c496980c0c\"]"
}
```

**关键**：如果内容未添加到 Notion，则视为**失败**。务必将发布到 Notion 作为工作流程的一部分，即便是草稿。

### 阶段 5：定稿至范例库（产出后）

当用