Blog-Tech-Kit Logo

📝 Blog-Tech-Kit

用 AI Agents 更快打造权威技术博客。

一个规范驱动（spec-driven）的工具包：用于系统化的博客内容策略与执行，构建于 spec-kit 的基础之上。

Status GitHub stars License Kit Variants

📝 Blog-Tech-Kit 是什么？

Blog-Tech-Kit 是 Spec-Kit 的一个专用变体，面向 AI SaaS 产品的博客内容策略与执行进行了适配。

Spec-Kit 用 AI Agents 支持“规范驱动的软件开发”，而 Blog-Tech-Kit 把同一套方法论迁移到技术写作、内容营销与权威建设——帮助创始人和内容团队用结构化、AI 辅助的工作流替代随意的内容产出。

与 Spec-Kit 的关键差异

维度 Spec-Kit Blog-Tech-Kit
聚焦点 软件功能开发 博客内容策略与执行
主要工作流 Specification → Plan → Code → Test Specification → Plan → Tasks → Publish
成功指标 代码质量、测试覆盖率、性能 流量、互动、权威度、转化
交付物 生产级软件与 API 已发布文章、内容支柱（pillers）、分发方案
CLI 命令 specify blog
Agent 命令 /speckit.* /blogkit.*

🚀 快速开始

1. 安装 Blog-Tech-Kit

选择你偏好的安装方式：

方案 1：一次性使用（推荐）

无需安装，直接运行——始终使用最新版本：

uvx --from git+https://github.com/agentii-ai/blog-tech-kit.git blog init my-blog
uvx --from git+https://github.com/agentii-ai/blog-tech-kit.git blog check

提示：该项目迭代很快。建议使用 uvx 以便始终获得最新功能与修复。

方案 2：常驻安装

一次安装，随处使用（可能需要周期性更新）：

uv tool install blog-cli --from git+https://github.com/agentii-ai/blog-tech-kit.git

然后直接使用该工具：

blog init my-blog
blog check

升级到最新版本：

uv tool install blog-cli --force --from git+https://github.com/agentii-ai/blog-tech-kit.git

2. 初始化你的第一个博客项目

blog init my-ai-blog
cd my-ai-blog

这会创建一个包含博客专用模板、constitution 与 agent commands 的项目。

3. 启动你的 AI Agent

在项目目录中打开你的 AI 助手（Claude Code、Cursor、Windsurf 等）。你会看到 /blogkit.* 命令可用：

/blogkit.constitution    # Establish blog-specific principles
/blogkit.specify         # Define content strategy (audience, pillars, cadence)
/blogkit.clarify         # Resolve ambiguities in your strategy
/blogkit.plan            # Create editorial workflow & technical plan
/blogkit.tasks           # Generate content production tasks
/blogkit.implement       # Execute content strategy workflow

4. 跑通你的第一次博客内容策略工作流

/blogkit.specify Build an authority blog for AI/LLM developers, focusing on practical tutorials, architecture patterns, and production deployment guides

它会生成一份博客规范（blog specification），包含：

  • 博客类型声明（权威型、产品型、思想领导力）
  • 目标受众（角色、公司、工具、环境）
  • 内容支柱（3–5 个核心主题）
  • 发布节奏与成功标准
  • 分发要求与约束

🤖 支持的 AI Agents

Blog-Tech-Kit 支持 Spec-Kit 所支持的全部 Agents：

Agent 支持情况 备注
Claude Code ✅ 原生支持
Cursor ✅ 完整集成
Windsurf ✅ 完整支持
Gemini CLI ✅ 已验证可用
GitHub Copilot ✅ 兼容
Qoder CLI ✅ 支持
额外 5+ Agents ✅ 见 Spec-Kit 文档

📦 Blog-Tech-Kit 模板

Blog-Tech-Kit 为 18 个 AI 编程 Agents 提供项目模板：当你运行 blog init 时会自动下载。每个模板包含：

  • Blog-Tech-Kit Constitution v1.0.0（8 条博客专用原则）
  • 工作流模板：spec.md、plan.md、tasks.md（用于内容文档化）
  • 9 个 slash commands：/blogkit.specify、/blogkit.plan、/blogkit.tasks、/blogkit.implement、/blogkit.clarify、/blogkit.analyze、/blogkit.checklist、/blogkit.taskstoissues、/blogkit.constitution
  • 脚本：Bash 或 PowerShell 变体（用于自动化）
  • Memory 系统：constitution.md（项目专用原则）

支持的模板 Agents

模板覆盖全部 18 个 Agents，并为 bash 与 PowerShell 提供双版本（共 36 个）：

  • Claude Code • Cursor Agent • Windsurf • Google Gemini
  • GitHub Copilot • Qoder • Qwen • OpenCode
  • Codex • KiloCode • Auggie • CodeBuddy
  • AMP • Shai • Amazon Q • Bob • Roo

可在 GitHub Releases 下载模板归档（附 SHA-256 校验和）。

📝 核心博客工作流

阶段 1：Specification（/blogkit.specify）

定义你要做的 是什么（WHAT） 与 为什么（WHY）：

  • 博客类型声明（权威型、产品型、思想领导力）
  • 目标受众（角色/能力、公司、工具、环境）
  • 内容支柱（3–5 个核心主题）
  • 发布节奏
  • 成功标准（流量、互动、转化）
  • 分发要求

阶段 2：Clarification（/blogkit.clarify）

在承诺执行前先消除模糊：

  • 验证受众是否足够“锋利”
  • 澄清内容支柱与选题
  • 精确定义成功指标
  • 识别未显式写出的假设

阶段 3：Planning（/blogkit.plan）

定义你将 如何（HOW） 执行内容策略：

  • 编辑流程（4-pass：research、draft、review、publish）
  • 技术栈（CMS、框架、托管）
  • 工具与集成
  • AI 可发现性（SEO、schema、LLM 优化）
  • 分发策略
  • 分析与埋点

阶段 4：Task Breakdown（/blogkit.tasks）

生成可执行内容生产任务：

  • Sprint 0：平台搭建
  • Sprint 1：基础文章 1
  • Sprint 2：基础文章 2
  • 验证检查点（数据复盘、SEO 检查、互动复盘）

阶段 5：Execution（/blogkit.implement）

在 AI 辅助下系统化执行内容生产：

  • 按依赖顺序执行任务
  • 通过质量门禁（SEO metadata、代码示例、技术 review、analytics）
  • 验证检查点
  • 跟踪进度并同步更新

🌟 Blog-Tech-Kit Constitution

Blog-Tech-Kit 基于 8 条核心原则，指导所有内容工作：

I. Content-First Approach

先定义内容策略（受众、支柱、口吻），再选择技术。

II. AI-Native Distribution

同时面向人类读者与 LLM/AI 发现做优化（结构化数据、清晰层级）。

III. Simplicity & Focus

在发布 10 篇文章之前不要自建 CMS。使用成熟工具，避免过度工程化。

IV. Iterative Validation

遵循 publish-measure-learn 的迭代闭环，每次交付独立、可验证的内容增量。

V. Evidence-Driven Optimization

所有内容决策必须由分析数据支撑——而不是观点或假设。

VI. Quality Gates

在每个阶段实施编辑标准（SEO metadata、代码测试、技术 review）。

VII. Kit Namespace Isolation

允许多个 kit 变体（blog-tech-kit、spec-kit、pmf-kit）共存且互不冲突。

VIII. Template Extensibility

作为“如何创建领域专用 kit 变体”的参考实现。

完整内容见 .blogkit/memory/constitution.md。

📚 参考文档

Blog-Tech-Kit 包含完整的参考资料，帮助你制定内容策略：

  • refs/0_overview.md - 成功 AI/LLM SaaS 博客概览
  • refs/1_principles_for_constitution.md - 博客专用原则与模式
  • refs/2_define_for_specify.md - 如何写出清晰的博客规范
  • refs/3_project_mangement_for_plan.md - 编辑工作流与博客运营
  • refs/4_pm_tasking_for_tasks.md - 内容生产任务模式
  • refs/6_claude_code.md - Claude Code 集成指南

🔧 Multi-Kit 安装

Blog-Tech-Kit 的设计目标是与 Spec-Kit 与其他 kit 变体共存：

# Install Spec-Kit for software development
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# Install Blog-Tech-Kit for content strategy
uv tool install blog-cli --from git+https://github.com/agentii-ai/blog-tech-kit.git

# Both tools work independently
specify check    # Shows Spec-Kit configuration
blog check       # Shows Blog-Tech-Kit configuration

# Create projects with different kits
specify init my-feature           # Software feature project
blog init my-blog                 # Blog content project

在你的 AI Agent 中，两套命令命名空间可同时使用：

  • /speckit.*：用于软件开发工作流
  • /blogkit.*：用于博客内容工作流

🎛️ CLI 参考

blog init - 初始化博客项目

blog init <PROJECT_NAME>
blog init my-blog --ai claude
blog init . --here --force        # Initialize in current directory
blog init my-blog --ai cursor --script ps   # PowerShell scripts

参数：

  • --ai - 指定 AI 助手（claude、cursor、windsurf、gemini 等）
  • --script - 脚本变体（sh：bash/zsh，ps：PowerShell）
  • --here - 在当前目录初始化
  • --force - 目录已有文件时跳过确认
  • --no-git - 跳过 git 初始化
  • --ignore-agent-tools - 跳过对工具可用性的检查

blog check - 验证安装

blog check

用于验证 Blog-Tech-Kit 的安装，并检查所需工具（git、claude、cursor、windsurf 等）。

🚀 按博客类型的示例

权威型博客（Anthropic、LangChain、Hugging Face 风格）

blog init ai-authority-blog
/blogkit.specify "Build an authority blog for ML engineers, covering LLM fine-tuning, RAG architectures, and production deployment"

期望产出：

  • 受众：50–500 人规模科技公司中的 ML engineers
  • 内容支柱：LLM Fine-tuning、RAG Patterns、Production ML
  • Hero 文章：”Complete Guide to Fine-tuning LLMs for Production”
  • 成功指标：自然流量、停留时长、newsletter 订阅

产品型博客（Cursor、Vercel 风格）

blog init product-blog
/blogkit.specify "Create a product blog showcasing AI coding assistant features and user success stories"

期望产出：

  • 受众：正在评估 AI 编程工具的开发者
  • 内容支柱：Feature Deep Dives、User Stories、Best Practices
  • Hero 文章：”How Company X Reduced Code Review Time by 60%”
  • 成功指标：试用注册、功能采用、NPS

思想领导力博客（a16z、Sequoia 风格）

blog init thought-leadership
/blogkit.specify "Build a thought leadership blog on AI market trends and startup patterns"

📖 进一步阅读

🏗️ 项目结构

blog-tech-kit/
├── .claude/commands/          # Claude Code slash commands
│   ├── blogkit.constitution.md
│   ├── blogkit.specify.md
│   ├── blogkit.plan.md
│   ├── blogkit.tasks.md
│   ├── blogkit.implement.md
│   ├── blogkit.clarify.md
│   ├── blogkit.analyze.md
│   └── blogkit.checklist.md
├── .blogkit/
│   ├── memory/
│   │   └── constitution.md    # Blog-Tech-Kit principles (v1.0.0)
│   ├── templates/
│   │   ├── spec-template.md   # Blog specification template
│   │   ├── plan-template.md   # Editorial planning template
│   │   ├── tasks-template.md  # Content task breakdown template
│   │   ├── blog-post-template.md  # Blog post structure template
│   │   └── commands/          # Agent command templates
│   └── scripts/
│       ├── bash/              # Bash automation scripts
│       └── powershell/        # PowerShell automation scripts
├── refs/                      # Reference documentation
│   ├── 0_overview.md
│   ├── 1_principles_for_constitution.md
│   ├── 2_define_for_specify.md
│   ├── 3_project_mangement_for_plan.md
│   ├── 4_pm_tasking_for_tasks.md
│   └── 5_more/                # Additional guides
└── specs/
    └── 000-blog-tech-kit-foundation/   # Feature specification & implementation docs

🔧 先决条件

验证你的环境

运行 blog check 以验证所有先决条件，并查看哪些 AI agents 可用：

blog check

🌐 创建你自己的 Kit 变体

Blog-Tech-Kit 展示了如何把 spec-driven 方法论适配到任意领域。想为产品设计、营销或商业写作创建一个变体？

参考 refs/instructions.md，其中包含完整指引：

  • 如何 fork 并适配 spec-kit
  • 如何定义领域专用原则
  • 如何创建模板与参考材料
  • 如何实现 multi-kit 共存

变体示例：

  • pmf-kit - 产品市场匹配（PMF）发现工作流
  • pd-kit - 产品设计与 UX 工作流
  • marketing-kit - GTM 与增长活动
  • ops-kit - 运营与项目管理

所有变体发布于 kits.agentii.ai。

🙏 致谢

Blog-Tech-Kit 基于 GitHub 的优秀项目 Spec-Kit。我们完整保留 Spec-Kit 的架构与基础设施，并在此之上为博客内容策略适配模板与方法论。

Spec-Kit 致谢：

💬 支持

如有问题、疑问或反馈：

📄 许可证

本项目采用 MIT 开源许可证发布。详见 LICENSE。

说明：Blog-Tech-Kit 延续 Spec-Kit 的 MIT 许可证；Spec-Kit 的许可证详情见 Spec-Kit LICENSE。

🌟 为什么选择 Blog-Tech-Kit？

面向创始人与内容团队

  • 系统化：用结构化、规范驱动的工作流替代随意的内容产出
  • AI 辅助：让 AI Agents 参与规范、规划与内容生产
  • 有案例可循：参考 Anthropic、LangChain、Hugging Face 等成功 AI 公司的博客模式沉淀模板
  • 证据驱动：聚焦分析数据与可量化结果，而不是观点

面向开源社区

  • 可复现：规范驱动的工作流比随意的 ad-hoc 流程更透明、更可协作
  • 可扩展：作为创建领域专用 kit 变体的参考实现
  • 社区友好：模板与参考材料均开源并采用 MIT 许可证
  • 专业：基于成熟的 Spec-Kit 基础设施，由有经验的内容策略负责人适配

准备好更有把握地打造你的权威博客了吗？

blog init my-blog

让我们用证据指导每一次内容决策，持续积累权威与影响力。

作者：Ddd4j  创建时间：2026-01-16 13:59
最后编辑：Ddd4j  更新时间：2026-01-22 17:51