Back to Details

sessions-to-blog

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sessions To Blog

会话转博客

Overview

概述

Create publishable MDX blog posts from 
sessions/articles
session logs with consistent voice, structure, and internal links, aligned to project standards.
根据项目标准，从
sessions/articles
会话日志创建具有一致语气、结构和内部链接的可发布MDX博客文章。

Workflow

工作流程

  1. Resolve project standards and output location
    • Find the project's MDX article standards and output location (check repo docs, AGENTS, README, or content guidelines).
    • If standards or location are not found, ask the user before drafting.
  2. Clarify scope and output
    • Ask for date range, audience, and desired length if not provided.
    • Use the language of the user's prompts in the logs; confirm if mixed or unclear.
  3. Gather source entries
    • Read the relevant 
      sessions/articles/YYYY-MM-DD.md
      blocks for the selected dates.
    • Extract: intent, actions, artifacts, decisions, progress, open questions, and any file paths.
  4. Plan the post
    • Build a short outline using the template in 
      references/examples.md
      .
    • Select 3 to 7 key highlights; prioritize user intent and outcomes.
  5. Draft in the defined style
    • Follow 
      references/style-and-structure.md
      .
    • Keep facts grounded in the logs; mark uncertainty explicitly.
  6. Apply internal linking rules
    • Follow 
      references/linking-rules.md
      for links to source logs, files, and related posts.
  7. QA pass
    • Check for missing sources, broken links, and inconsistent tense.
    • Ensure the post is readable without the raw logs.
  1. 明确项目标准与输出位置
    • 查找项目的MDX文章标准和输出位置（查看仓库文档、AGENTS、README或内容指南）。
    • 如果未找到标准或位置，在起草前询问用户。
  2. 明确范围与输出要求
    • 如果未提供日期范围、受众和期望篇幅，向用户确认。
    • 使用日志中用户提示的语言；若语言混杂或不明确，需确认。
  3. 收集源条目
    • 读取所选日期对应的
      sessions/articles/YYYY-MM-DD.md
      相关内容块。
    • 提取：意图、操作、工件、决策、进展、未解决问题以及所有文件路径。
  4. 规划文章结构
    • 使用
      references/examples.md
      中的模板构建简短大纲。
    • 选取3至7个关键亮点；优先考虑用户意图和成果。
  5. 按指定风格起草
    • 遵循
      references/style-and-structure.md
      的要求。
    • 内容基于日志事实；如有不确定之处需明确标注。
  6. 应用内部链接规则
    • 遵循
      references/linking-rules.md
      中关于源日志、文件和相关文章的链接规则。
  7. 质量检查
    • 检查是否存在源缺失、链接失效和时态不一致的问题。
    • 确保无需查看原始日志即可读懂文章。

References

参考资料

  • references/style-and-structure.md
    for voice, tone, structure, and language rules.
  • references/linking-rules.md
    for internal links and citation conventions.
  • references/examples.md
    for input and output examples and a lightweight template.
  • references/style-and-structure.md
    ：语气、语调、结构和语言规则。
  • references/linking-rules.md
    ：内部链接和引用规范。
  • references/examples.md
    ：输入输出示例及轻量模板。