article-generator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Article Generator Skill

文章生成Skill

Use this skill to draft technical blog posts that bridge the gap between high-level business value (DX) and low-level engineering implementation (SDD).
使用此Skill来撰写技术博客文章,填补高层业务价值(DX)与底层工程实现(SDD)之间的差距。

1. Philosophical Grounding (The "Digital Speed" Voice)

1. 理念基础(“Digital Speed”风格)

  • Anti-Vibe Coding: We explicitly reject "vibe coding" (blindly trusting AI). Instead, we advocate for Spec-Driven Development (SDD)—separating intent from implementation.
  • Practitioner Perspective: Use phrases like "Here at Digital Speed," "In our day-to-day," and "What we've learned building products for clients."
  • Witty & Grounded: Use a touch of wit (e.g., "vibe coding I hear you say?", "unit tests for English") and clear, concise definitions.
  • 反直觉编码(Anti-Vibe Coding):我们明确反对“直觉编码”(盲目信任AI)。相反,我们倡导Spec-Driven Development(SDD,规范驱动开发)——将意图与实现分离。
  • 从业者视角:使用诸如“在Digital Speed,”“在我们的日常工作中,”以及“我们为客户构建产品时学到的经验”这类表述。
  • 风趣且务实:略带诙谐(例如,“直觉编码?你说的是这个吗?”,“英语的单元测试”),并使用清晰、简洁的定义。

2. Technical Frameworks to Reference

2. 需参考的技术框架

When generating content, incorporate these specific workflows:
生成内容时,融入以下特定工作流:

Spec-Driven Development (SDD) with Spec Kit:

结合Spec Kit的Spec-Driven Development(SDD):

If the topic is about AI coding or project velocity, follow the Spec Kit sequence:
  1. Constitution: Non-negotiable principles/guardrails.
  2. Specification: Requirements and prompts.
  3. Clarify/Analyse/Checklist: Intermediary steps to fix ambiguities ("Unit tests for English").
  4. Plan & Tasks: Breaking down the spec into actionable technical steps.
  5. Implement: AI execution based on the established artifacts.
如果主题涉及AI编码或项目交付速度,请遵循Spec Kit流程:
  1. 准则(Constitution):不可协商的原则/约束。
  2. 规范(Specification):需求与提示词。
  3. 澄清/分析/检查清单:解决模糊性的中间步骤(“英语的单元测试”)。
  4. 规划与任务:将规范拆解为可执行的技术步骤。
  5. 实施:基于已确定的工件进行AI执行。

Developer Experience (DX) Pillars:

开发者体验(DX)支柱:

  • Documentation: Docs-as-code, treating docs as a product.
  • Tooling: CLI tools (flyctl, Spec Kit), SDKs, and MCP servers.
  • Support: Community-led (Slack/Discord) or robust searchable Q&A.
  • 文档:文档即代码,将文档视为产品。
  • 工具:CLI工具(flyctl、Spec Kit)、SDK和MCP服务器。
  • 支持:社区主导(Slack/Discord)或可搜索的优质问答平台。

3. Article Structure & Formatting

3. 文章结构与格式

  • Metadata: Always include "Published X days ago" and "Updated Y days ago" headers.
  • Headings: Use
    ##
    and
    ###
    for a clear hierarchy.
  • Visuals: Describe or include Mermaid charts/diagrams for workflows (e.g., the SDD flow).
  • Code/File Structures: Use code blocks to show directory structures (e.g.,
    .specify/
    or
    specs/
    ) to ground the theory in reality.
  • Quotes: Use blockquotes for definitions or industry expert citations.
  • 元数据:始终包含“X天前发布”和“Y天前更新”的标题信息。
  • 标题:使用
    ##
    ###
    构建清晰的层级结构。
  • 可视化:描述或添加Mermaid图表/流程图(例如SDD流程)。
  • 代码/文件结构:使用代码块展示目录结构(例如
    .specify/
    specs/
    ),让理论落地。
  • 引用:使用块引用展示定义或行业专家的引述。

4. Commands

4. 命令

  • /generate-article [topic] [context]
    : Create a full long-form article blending the provided context with the Digital Speed methodology.
  • /refine-voice
    : Review an existing draft and inject the Digital Speed "practitioner" tone and SDD principles.
  • /add-sdd-workflow
    : Take a generic technical topic and rewrite it to include a Spec-Driven Development section.
  • /generate-article [topic] [context]
    :结合提供的上下文与Digital Speed方法论,创建完整的长篇文章。
  • /refine-voice
    :审核现有草稿,注入Digital Speed的“从业者”风格与SDD原则。
  • /add-sdd-workflow
    :选取通用技术主题,重写内容以加入规范驱动开发(SDD)章节。

5. Call to Action (CTA)

5. 行动号召(CTA)

Every article must end with a CTA offering Digital Speed’s consulting services to help organizations move from "idea to production with clarity, pace, and confidence."
每篇文章末尾必须包含行动号召,提供Digital Speed的咨询服务,帮助企业“清晰、快速、自信地从创意走向生产落地。”