Menu
A skill for technical writing. This skill should be used when users want to write a technical article.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
| name | technical-writing-skill |
| description | A skill for technical writing. This skill should be used when users want to write a technical article. |
这是一个模块化、渐进式加载的技术写作 skill。
整个写作流程分为 4 个阶段，每个阶段有独立的文档指南：
graph TD
A[阶段 0: 主题确认] --> B[阶段 1: 深度调研]
B --> C[阶段 2: 大纲设计]
C --> D[阶段 3: 内容创作]
D --> E[阶段 4: 迭代优化]
目标: 明确写作主题、目标读者、核心价值
详细指南: 👉 当进入此阶段时，读取 stage-0-topic.md
产出文件: wikis/writing/drafts/{article-slug}/00-topic.md
下一步: 用户确认后 → 进入阶段 1
目标: 通过搜索、阅读、分析，形成对主题的深入理解
详细指南: 👉 当进入此阶段时，读取 stage-1-research.md
产出文件: wikis/writing/drafts/{article-slug}/01-research.md
关键检查: 👉 参考 checklists/research-checklist.md
下一步: 用户确认调研充分 → 进入阶段 2
目标: 设计文章结构，明确每个章节的内容和目标
详细指南: 👉 当进入此阶段时，读取 stage-2-outline.md
产出文件: wikis/writing/drafts/{article-slug}/02-outline.md
关键检查: 👉 参考 checklists/outline-checklist.md
下一步: 用户确认大纲合理 → 进入阶段 3
目标: 根据大纲创作完整文章
详细指南: 👉 当进入此阶段时，读取 stage-3-writing.md
产出文件: wikis/writing/drafts/{article-slug}/03-draft-v1.md
关键检查: 👉 参考 checklists/writing-checklist.md
下一步: 用户反馈 → 进入阶段 4
目标: 根据反馈持续优化，直到满意
详细指南: 👉 当进入此阶段时，读取 stage-4-iteration.md
产出文件:
03-draft-v2.md, 03-draft-v3.md ...03-draft-final.md下一步: 用户满意 → 发布到 wikis/writing/published/
当用户说："我想写一篇关于 XXX 的文章"
立即执行:
读取主题确认指南:
Read: .claude/skills/technical-writing-skill/stage-0-topic.md
按指南与用户对话，确认：
创建工作目录:
wikis/writing/drafts/{article-slug}/
使用模板生成 00-topic.md:
Read: templates/00-topic-template.md
填充后 Write 到工作目录
征求用户确认，获得确认后 → 进入阶段 1
只在需要时加载对应阶段的文档，避免一次性加载所有内容。
| 阶段 | 触发条件 | 需要加载的文档 |
|---|---|---|
| 阶段 0 | 用户发起写作请求 | stage-0-topic.md + templates/00-topic-template.md |
| 阶段 1 | 用户确认主题 | stage-1-research.md + templates/01-research-template.md + checklists/research-checklist.md |
| 阶段 2 | 用户确认调研充分 | stage-2-outline.md + templates/02-outline-template.md + checklists/outline-checklist.md + wikis/writing/technical-writing-guide.md |
| 阶段 3 | 用户确认大纲 | stage-3-writing.md + checklists/writing-checklist.md + wikis/writing/technical-writing-guide.md |
| 阶段 4 | 用户提供反馈 | stage-4-iteration.md + templates/version-changelog-template.md |
.claude/skills/technical-writing-skill/
├── SKILL.md # 本文件：主入口，流程概览
├── stage-0-topic.md # 阶段 0 详细指南
├── stage-1-research.md # 阶段 1 详细指南（含工具使用）
├── stage-2-outline.md # 阶段 2 详细指南（含结构模板）
├── stage-3-writing.md # 阶段 3 详细指南（含写作规范）
├── stage-4-iteration.md # 阶段 4 详细指南（含版本管理）
├── templates/
│ ├── 00-topic-template.md # 主题确认模板
│ ├── 01-research-template.md # 调研报告模板
│ ├── 02-outline-template.md # 文章大纲模板
│ └── version-changelog-template.md # 版本变更说明模板
└── checklists/
├── research-checklist.md # 调研质量检查清单
├── outline-checklist.md # 大纲设计检查清单
└── writing-checklist.md # 写作质量检查清单
以下文件在多个阶段都会用到，可根据需要加载：
写作风格指南: wikis/writing/technical-writing-guide.md
已发布文章: wikis/writing/published/
在执行过程中，维护以下状态信息（轻量级）：
**当前项目**: {article-slug}
**当前阶段**: 0/1/2/3/4
**工作目录**: wikis/writing/drafts/{article-slug}/
**已完成文件**: [列表]
**待确认事项**: [列表]
每次切换阶段时：
用户: "我想写一篇关于 LangGraph 1.0 的实战教程"
AI:
好的，昕哥！我来帮你创作这篇文章。
[读取 stage-0-topic.md]
让我先确认几个问题：
1. 目标读者是？（初学者/进阶）
2. 重点介绍哪些新特性？
3. 想做什么样的 Demo？
...
[创建工作目录 wikis/writing/drafts/langgraph-1.0-tutorial/]
[读取并填充 templates/00-topic-template.md]
[写入 00-topic.md]
请查看 00-topic.md，确认无误后我开始深度调研。
用户: "确认"
AI:
收到！进入阶段 1：深度调研
[读取 stage-1-research.md]
[读取 checklists/research-checklist.md]
我将搜索：
✅ LangGraph 1.0 官方文档
✅ GitHub changelog 和 examples
✅ 社区博客
...
[执行调研...]
[读取 templates/01-research-template.md]
[填充并写入 01-research.md]
调研完成！共发现 8 个关键点。
请查看 01-research.md 的 Key Findings 部分。
调研是否充分？
用户: "充分，继续"
AI:
收到！进入阶段 2：大纲设计
[读取 stage-2-outline.md]
[读取 wikis/writing/technical-writing-guide.md]
[读取 checklists/outline-checklist.md]
[设计大纲...]
[读取 templates/02-outline-template.md]
[填充并写入 02-outline.md]
大纲已完成！共 8 个章节，预计 8500 字。
请查看 02-outline.md。
结构是否合理？
... 以此类推
假设完整 SKILL.md 为 10,000 tokens：
开始创作时，请说：
"我想写一篇关于 [主题] 的文章"
我将引导你完成整个流程！
Based on SOC occupation classification
Relay the current Claude Code session to Agentara for continued execution
Generate storyboard image boards and matching video-generation prompt scripts for specific scenes in a short video plan. Use this skill whenever the user asks to create a storyboard, storyboard image, video prompt script, scene prompt, image-to-video prompt, shot board, or per-scene video-generation package, especially when they specify a scene number, duration, or an existing video plan. This skill saves outputs as storyboard/scene-XX.png and storyboard/scene-XX.md and enforces grid sizing, timing labels, and strict character, wardrobe, prop, and location continuity.
Create cinematic movie poster concepts and final poster images from a user's brief, existing video plan, storyboard, character design, or project context. Use this skill whenever the user asks to generate a film poster, movie poster, key art, campaign poster, teaser poster, title poster, or promotional visual for a video project. This skill proposes several creative directions first when appropriate, defaults to a 3:4 poster ratio when no ratio is specified, and ensures typography, title treatment, imagery, genre, setting, and story tone are coherent and visually inventive.
Plan short-form video, vlog, travel, lifestyle, documentary, or cinematic social video scripts by negotiating duration, choosing a story arc and visual style, then splitting the film into timed scenes of 4-15 seconds. Use this skill whenever the user asks for a video plan, short video plan, scene breakdown, montage plan, travel video script, TikTok/Reels/Shorts storyboard, or cinematic short-form narrative, even if they only describe a loose theme or destination.
Create character design documentation and character design sheet images for video, storyboard, advertising, animation, or AI video-generation workflows. Use this skill whenever the user asks to design a character, extract a character from a reference image, make a character sheet, create a turnaround sheet, keep a person consistent across scenes, or generate character assets for a video project. This skill first writes a confirmable {character-name}.md design spec, waits for user approval or revision, and only then generates {character-name}.png.
📡 Pulse — Twice-daily tech briefing for group distribution. Designed to be triggered by cronjob at morning and evening, or manually. Use this skill only when the user says "pulse" or "/pulse".
