write-article

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Write Article for The Hybrid Builder

为The Hybrid Builder撰写文章

Write a newsletter article about our collaboration for https://chatwithgpt.substack.com/s/the-hybrid-builder

为https://chatwithgpt.substack.com/s/the-hybrid-builder撰写一篇关于我们合作内容的新闻通讯文章

Context

背景

This publication is explicitly stated as AI-written
Article documents our collaboration on: $ARGUMENTS

该出版物明确标注为AI撰写
文章记录我们在以下方面的合作：$ARGUMENTS

Before Writing: Find Related Articles

写作前：查找相关文章

Always check the article archive first. The cache includes all 33+ articles with theme indexing and cross-reference tracking.

务必先查看文章档案。缓存包含所有33+篇带有主题索引和交叉引用跟踪的文章。

Article Cache Commands

文章缓存命令

bash

undefined

bash

undefined

Update cache from sitemap (full archive)

python3 ~/.claude/skills/write-article/scripts/update-cache.py

Get reference suggestions for your topic

python3 ~/.claude/skills/write-article/scripts/update-cache.py --suggest "your topic here"

List all cached articles

python3 ~/.claude/skills/write-article/scripts/update-cache.py --list

Browse by theme

python3 ~/.claude/skills/write-article/scripts/update-cache.py --themes

Find articles related to a specific article

python3 ~/.claude/skills/write-article/scripts/update-cache.py --related "article-slug"

Search by keyword

python3 ~/.claude/skills/write-article/scripts/update-cache.py --search "compound engineering"

undefined

python3 ~/.claude/skills/write-article/scripts/update-cache.py --search "compound engineering"

undefined

Reference Workflow

参考工作流

Run
```
--suggest "topic"
```
to get ranked candidates with phrasing suggestions
Review the theme index to spot thematic connections
For top candidates, use WebFetch to read full content if needed
Apply natural reference patterns from references/reference-patterns.md

运行
```
--suggest "topic"
```
获取带有措辞建议的候选参考文章排名
查看主题索引，发现主题关联
对于优先级高的候选文章，若需要可使用WebFetch阅读完整内容
采用references/reference-patterns.md中的自然引用格式

Writing Style & Tone

写作风格与语气

Conversational technical narrative blending storytelling with technical detail
First-person collaborative perspective (emphasize the partnership)
Enthusiastic, exploratory, and optimistic tone
Transparent about challenges, failures, and iterative process
High technical specificity with code examples and implementation details
Meta-narrative about the AI-human collaboration itself

兼具故事性与技术细节的对话式技术叙事
第一人称合作视角（强调伙伴关系）
热情、探索性且乐观的语气
坦诚面对挑战、失败和迭代过程
包含代码示例和实现细节的高技术特异性内容
关于AI-人类协作本身的元叙事

Structure & Format

结构与格式

Narrative-driven with chronological progression
Use clear sections with timestamps/development phases
Include headers and bullet points for readability
Typical length: 1500-2500 words
Always include: context, technical details, lessons learned, future implications

以叙事为主，按时间顺序推进
使用清晰的章节，包含时间戳/开发阶段
为提升可读性，使用标题和项目符号
典型篇幅：1500-2500词
必须包含：背景、技术细节、经验教训、未来影响

Natural Cross-Referencing

自然交叉引用

Avoid mechanical patterns. See references/reference-patterns.md for natural styles.

Quick reference:

Style	Example
Callback	"The compound engineering loop kept surfacing..." (no link needed)
Context-first	"When I built X, I discovered... that journey taught me..."
Aside	"This approach (which I've been systematizing)..."
Thematic echo	Name the concept, link becomes supplementary

Themes to watch for: compound-engineering, skills, mcp, teaching, ai-collaboration, context-engineering, automation, research, microsim

避免机械格式。请查看references/reference-patterns.md中的自然风格示例。

快速参考：

风格	示例
回调	"复合工程循环不断浮现..."（无需链接）
先背景后引用	"当我构建X时，我发现... 那段经历教会了我..."
旁注	"这种方法（我一直在系统化）..."
主题呼应	点明概念，链接作为补充

需关注的主题： compound-engineering, skills, mcp, teaching, ai-collaboration, context-engineering, automation, research, microsim

Data Sources

数据源

Read git history and recent commits in current repo
Check
```
/articles/chat-sessions/
```
for exported session data if available
Cross-reference conversation context from this session
Use
```
aichat search "topic"
```
to find related past sessions if relevant
Run
--suggest
for intelligent reference recommendations

阅读当前仓库的git历史和最近提交记录
若有可用数据，查看
```
/articles/chat-sessions/
```
中的导出会话数据
交叉引用本次会话的上下文
若相关，使用
```
aichat search "topic"
```
查找过往相关会话
运行
--suggest
获取智能参考推荐

Output

输出

Create both Markdown (.md) and HTML (.html) versions
Store in
```
/articles
```
subfolder at the project root (create if needed)
Filename format:
```
YYYY-MM-DD-descriptive-slug
```
HTML version should be publication-ready with basic styling

同时创建Markdown（.md）和HTML（.html）版本
存储在项目根目录的
```
/articles
```
子文件夹中（若不存在则创建）
文件名格式：
```
YYYY-MM-DD-descriptive-slug
```
HTML版本需为可直接发布的格式，包含基础样式

Cover Images

封面图片

Generate cover images using Python/PIL:

Platform	Dimensions	Filename
LinkedIn	1200×628	`YYYY-MM-DD-cover-image.png`
Substack	1100×220	`YYYY-MM-DD-substack-banner.png`
Twitter	1200×675	`YYYY-MM-DD-twitter-card.png`

Design: Dark slate (#0F172A) background, amber (#FBBF24) accents, left-aligned text, large typography (48-76px titles), decorative nodes on right.

使用Python/PIL生成封面图片：

平台	尺寸	文件名
LinkedIn	1200×628	`YYYY-MM-DD-cover-image.png`
Substack	1100×220	`YYYY-MM-DD-substack-banner.png`
Twitter	1200×675	`YYYY-MM-DD-twitter-card.png`

设计要求： 深灰蓝（#0F172A）背景，琥珀色（#FBBF24）强调色，左对齐文本，大字号标题（48-76px），右侧添加装饰性节点。

Session Transcript Integration

会话转录集成

After writing, ask: "Would you like me to publish this session as a shareable transcript?"

If yes:

First, find the current session file (most recent .jsonl for this project):

bash

undefined

文章撰写完成后，询问：“是否需要将本次会话发布为可分享的转录内容？”

若用户同意：

首先，找到当前会话文件（本项目最新的.jsonl文件）：

bash

undefined

Find the current session file

ls -t ~/.claude/projects/-Users--$(basename $(pwd))/.jsonl 2>/dev/null | head -1


Then export using the `json` command (works non-interactively, unlike `local`):
```bash

ls -t ~/.claude/projects/-Users--$(basename $(pwd))/.jsonl 2>/dev/null | head -1


然后使用`json`命令导出（与`local`命令不同，该命令无需交互）：
```bash

Use 'json' command with direct file path - works from Claude Code

uvx claude-code-transcripts json <SESSION_FILE.jsonl> --gist 2>&1 | tee /tmp/transcript-output.txt


**Note:** The `local` command requires interactive terminal input for session selection. Use `json` with a direct file path when running from Claude Code or scripts.

Add to article:
```markdown

uvx claude-code-transcripts json <SESSION_FILE.jsonl> --gist 2>&1 | tee /tmp/transcript-output.txt


**注意：** `local`命令需要交互式终端输入来选择会话。在Claude Code或脚本中运行时，请使用带有直接文件路径的`json`命令。

将以下内容添加到文章中：
```markdown

Session Transcript

This article was written during a live collaboration session. View the full conversation to see how we built this together.

undefined

This article was written during a live collaboration session. View the full conversation to see how we built this together.

undefined

Instructions

操作步骤

Get reference suggestions: Run
```
--suggest "topic"
```
for the current topic
Gather context: Read git log, relevant files, session exports
Outline narrative arc of the collaboration
Ask the user about specific aspects to emphasize before writing
Write article with technical depth and conversational tone
Include natural cross-references (1-3 articles, using patterns from reference guide)
Create both .md and .html versions in /articles
Preview:
```
open /path/to/article.html
```
Create cover images for all three platforms
Session transcript (ask user, add if yes)
Final review: Confirm all assets are ready

获取参考建议：针对当前主题运行
```
--suggest "topic"
```
收集上下文：阅读git日志、相关文件、会话导出内容
梳理合作内容的叙事脉络
询问用户需要重点强调的具体方面，再开始写作
撰写文章，兼顾技术深度与对话式语气
添加自然交叉引用（1-3篇文章，使用参考指南中的格式）
在/articles目录中创建.md和.html两个版本
预览：
```
open /path/to/article.html
```
为三个平台创建封面图片
会话转录（询问用户，若同意则添加）
最终检查：确认所有素材准备完毕