name: ctx-blog description: “生成博客文章草稿。用于记录项目进展、分享学习心得或撰写开发经验。”
根据近期项目活动生成博客文章草稿。
开始写作前
两个问题——如果任何答案为“否”，请重新考虑：
- “是否有叙事弧线？” → 博客文章需要一个故事（问题→方法→结果），而不仅仅是变更列表
- “项目外的人能学到东西吗？” → 如果见解仅对内部有用，请改用 LEARNINGS.md
何时使用
- 记录重要的项目进展时
- 公开分享学习心得时
- 用户希望撰写开发经验时
何时不使用
- 仅供内部使用的笔记（使用会话保存或 LEARNINGS.md）
- 工作仍在进行中且尚无明确见解时
- 用于变更日志（改用
/ctx-blog-changelog）
输入
用户可以指定：
- 时间范围：
上周、自周一以来、一月 - 主题焦点：
重构、新功能、经验教训 - 或者直接运行以分析近期活动
分析来源
从多个来源收集上下文：
# 近期提交
git log --oneline -30
# 近期决策
head -100 .context/DECISIONS.md
# 近期学习心得
head -100 .context/LEARNINGS.md
# 近期完成的任务
grep -A2 "\[x\]" .context/TASKS.md | head -50
# 日志条目（如果可用）
ls -la .context/journal/*.md 2>/dev/null | tail -10
博客文章结构
前言
---
title: "描述性标题：本文内容"
date: YYYY-MM-DD
author: [询问用户]
topics:
- 主题一
- 主题二
- 主题三
---
正文
# 标题
> 开篇引子或问题
[引言：设定场景，说明为何重要]
## 第一部分：背景/问题
[导致此项工作的情境]
## 第二部分：我们做了什么
[工作的叙述，包含代码示例]
## 第三部分：我们学到了什么
[关键见解、陷阱、发现的模式]
## 第四部分：下一步计划
[未来工作、开放性问题]
风格指南
- 个人语气：使用“我”、“我们”，分享历程
- 展示而非讲述：包含实际代码、提交、引用
- 使用表格进行比较：前后对比、发现的模式
- 诚实地面对失败：包含出错的地方及原因
- 具体示例：引用特定文件、提交、决策
- 不使用破折号：使用
:、;或重构句子 - 仅使用直引号：使用“直引号”（
"、'），切勿使用印刷/花引号 - 80字符行宽：散文在约80字符处换行；表格、代码块和URL除外
流程
- 收集来源（git、决策、学习心得、日志）
- 识别叙事弧线（故事是什么？）
- 起草大纲供用户批准
- 撰写完整草稿
- 请求修订
- 保存到
docs/blog/YYYY-MM-DD-slug.md - 更新
docs/blog/index.md— 在顶部添加条目，遵循现有模式：
### [文章标题](YYYY-MM-DD-slug.md)
*作者 / 日期*
2-3句话简介。
**主题**：主题一，主题二，主题三
---
示例调用
/ctx-blog 关于我们刚构建的冷却功能
/ctx-blog 上周的重构工作
/ctx-blog 从钩子设计中学到的经验教训