Review Writing banner
lipingtababa lipingtababa

Review Writing

Development community

Description

自查刚写完的章节内容。接受一个文件路径参数(如 `zh/chapters/00-introduction.md`),对内容逐条审查并直接修复问题。如果没有提供文件路径,询问用户要审查哪个文件。 每轮审查聚焦一类问题,修复后进入下一轮,最多三轮。每轮修改后向用户报告改了什么。 --- ## 第一轮:总分结构与 Motivation 逐节检查: 1. **每节是否以结论/takeaway 开头?** 如果一个 section 的核心观点出现在末尾而非开头,这是 reveal/铺垫结构,需要倒转。读者应该在第一段就知道这一节要说什么。 2. **每节是否被 motivate?** 读者进入这一节之前,是否已经知道为什么要读它?如果一个 section 突然出现,跟前文没有因果关系,标记为 motivation 缺失。 3. **是否存在延迟信息的铺垫句?** 例如"有一个现象特别能说明…"、"考虑一个具体的情况…"、"还有一类更隐蔽的问题…"。这类句子延迟了信息到达,应该直接陈述结论然后给例子。 4. **Evidence 是否服务于 claim?** 每段 evidence

Installation

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.

Full documentation available on GitHub

View Source Repository