Tooluck logoTooluck
SKILL.md

writing-shape

Agent skill fromvinvcn/mattpocock-skills-zh-CN

Writing, exploit:把原始素材塑造成文章,一段一段地推进。

How to install writing-shape

install writing-shape
# install the mattpocock-skills-zh-CN pack with the skills CLI
npx skills add vinvcn/mattpocock-skills-zh-CN

# or add only this skill to Claude Code: copy the folder

skills/in-progress/writing-shape/

# into

~/.claude/skills/writing-shape/ (all projects)

.claude/skills/writing-shape/ (one project)

skills/in-progress/writing-shape/SKILL.md

MITFull file
1<what-to-do>
2
3用户已经传入(或将传入)一份 raw material markdown 文件。把它当作 input pile:它可以是整齐的 fragments 列表、无结构 prose 墙、transcript,任何格式都可以。先完整读完,再做其他事。
4
5然后运行一个 shaping session,产出一份独立的 article document。这是 **exploit**:探索已经完成,pile 已固定——承诺一个结构,并挖掘 pile 来填充它。不要编辑 raw material 文件;对这个 skill 来说它是 read-only。
6
7如果用户没有说明文章保存路径,只询问一次并记住路径。
8
9</what-to-do>
10
11<supporting-info>
12
13## The loop
14
151. **Read the pile.** 完整读取 input file,形成对内容的整体感。
162. **Establish the prerequisites.** 与用户确定读者进场时知道什么——那些从一开始就已 **grounded** 的概念。其它一切都必须先被某个 block grounded,之后的 block 才能依赖它。见 [Grounding](#grounding)。
173. **Draft 2-3 candidate openings.** 每个 opening 都应暗示文章的不同 thesis 或 angle。全部展示出来,迫使用户选择或组合 hybrid。选定的 opening 定义整篇文章接下来必须完成什么。
184. **Grow paragraph by paragraph.** Opening 落地后,问 “given this opening, what does the reader need to hear next?” 从 pile 中抽取 material 回答。下一个 block 只能依赖已 grounded 的概念,并在落地时 grounded 新的概念。讨论下一 block 应该是 paragraph、list、table、callout、quote 还是 code block。每个格式选择都应该 deliberate 且 defensible。
195. **Append to the article file as you go.** 不要 batch。每个达成一致的 paragraph 或 block 立即写入,让用户看到文章成形。
206. **Loop step 4 until the article is done.** 用户决定何时完成。
21
22## Grounding
23
24每个 **concept** 都必须先被 **grounded**,某个 block 才能依赖它:读者要么进场时就知道它,要么在更早的 block 中遇到过它。一个伸手去抓未 grounded 概念的 block 会失去读者。单位是 concept,而不是它的措辞——即便眼前没有任何术语,一个 block 也可能依赖一个读者并不具备的 idea。当一个概念有名字——一个 **term**——grounded 它意味着让这个 idea 和这个 term 一起落地。
25
26一个概念通过两种方式之一被 grounded:
27
28- **Prerequisite** —— 在 opening 之前就被 grounded。读者自带它。在开头就固定下来。
29…

Excerpt shown under the repository's MIT license.

More skills in mattpocock-skills-zh-CN

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates