lipingtababa

Review Writing — Development skill for Claude Code

Development community

自查刚写完的章节内容。接受一个文件路径参数(如 zh/chapters/00-introduction.md),对内容逐条审查并直接修复问题.

How to install Review Writing

Installs to ~/.claude/commands/lipingtababa-harness-engineering-playbook-review-writing.md

Terminal
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/lipingtababa/harness-engineering-playbook/HEAD/.claude/commands/review-writing.md -o ~/.claude/commands/lipingtababa-harness-engineering-playbook-review-writing.md

Restart Claude Code, or start a new session, for it to be picked up.

What Review Writing does

自查刚写完的章节内容。接受一个文件路径参数(如 `zh/chapters/00-introduction.md`),对内容逐条审查并直接修复问题。如果没有提供文件路径,询问用户要审查哪个文件。

每轮审查聚焦一类问题,修复后进入下一轮,最多三轮。每轮修改后向用户报告改了什么。


第一轮:总分结构与 Motivation

逐节检查:

  1. **每节是否以结论/takeaway 开头?** 如果一个 section 的核心观点出现在末尾而非开头,这是 reveal/铺垫结构,需要倒转。读者应该在第一段就知道这一节要说什么。

  2. **每节是否被 motivate?** 读者进入这一节之前,是否已经知道为什么要读它?如果一个 section 突然出现,跟前文没有因果关系,标记为 motivation 缺失。

  3. **是否存在延迟信息的铺垫句?** 例如"有一个现象特别能说明…"、"考虑一个具体的情况…"、"还有一类更隐蔽的问题…"。这类句子延迟了信息到达,应该直接陈述结论然后给例子。

  4. **Evidence 是否服务于 claim?** 每段 evidence

Alternatives in Development

  • Scientific Agent Skills — A set of ready to use Agent Skills for research, science, engineering, analysis, finance and writing 18.7k ★
  • Create Handoff — You are tasked with writing a handoff document to hand off your work to another agent in a new session 10k ★
  • Codex Claude Academic Skills — 本仓库包含三个面向学术科研人员的Skills,覆盖从文献阅读、论文写作到科学计算的完整研究工作流 3.2k ★

Full documentation available on GitHub

View Source Repository