writing-beats
写作,利用阶段——将原始素材组装成一段节拍旅程,在每个节拍依赖某个术语之前先将其落地。
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.
Menu
写作,利用阶段——将原始素材组装成一段节拍旅程,在每个节拍依赖某个术语之前先将其落地。
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.
Based on SOC occupation classification
Manage git submodules for the learning-open-code mono-repo. Use when the user wants to: (1) Add a new git submodule — auto-detect or specify the category (open-ai-skills/open-sdd/open-ai-agent/open-ai-desktop/open-knowledge/open-productivity/open-java/open-trading/open-data), record the tracking branch in .gitmodules, clone the repo, and update README.md index. (2) Sync all existing submodules to their configured branches (git fetch + checkout branch + pull). (3) Update the root README.md with an up-to-date index of all synced projects grouped by category. (4) Initialize submodules after git clone — when open-*/ directories are empty or git submodule status returns nothing, guide through the full SOP (git submodule update --init --recursive [--remote]). Trigger keywords: submodule, git submodule, 子模块, add submodule, sync submodule, update submodule, submodule branch, README index, 更新索引, clone, init, 初始化子模块, submodule init, 拉取子模块.
对开源项目进行穷尽式教学文档生成——从宏观架构到微观实现的五层分级讲解,使用 Goal Loop 算法自主驱动完整代码覆盖。所有具体教学内容生成必须激活 `.agents/skills/teach/SKILL.md`。触发条件:用户要求"完整学习某个项目"、"生成项目架构文档"、"从入口到落地讲清楚每个功能"、"代码考古"、"源码分析"、或指定一个项目目录/仓库要求全面教学。
使用并行子 agent 为模块生成多个截然不同的接口设计。当用户想要设计 API、探索接口选项、比较模块形态,或提到 "设计两次" 时使用。
交互式 QA 会话,用户以对话方式报告 bug 或问题,agent 将其录入 GitHub Issue。在后台探索代码库以获取上下文和领域语言。当用户想要报告 bug、做 QA、以对话方式录入 issue,或提及 "QA session" 时使用。
通过用户访谈创建包含微小提交的详细重构计划,并将其录入 GitHub Issue。当用户想要规划重构、创建重构 RFC,或将重构分解为安全的渐进步骤时使用。
从当前对话中提取 DDD 风格的通用语言词汇表,标记歧义并提出规范术语。保存到 UBIQUITOUS_LANGUAGE.md。当用户想要定义领域术语、构建词汇表、固化术语、创建通用语言,或提到 "领域模型" 或 "DDD" 时使用。
| name | writing-beats |
| description | 写作,利用阶段——将原始素材组装成一段节拍旅程,在每个节拍依赖某个术语之前先将其落地。 |
| disable-model-invocation | true |
用户已经传递(或将传递)一个包含原始素材的 markdown 文件。这是利用阶段:探索已完成,素材堆已固定——承诺一条贯穿路径,并挖掘素材堆来填充每个节拍。
如果用户没有说明将文章保存到哪里,询问一次并记住路径。
然后运行一个逐节拍的旅程,选择你自己的冒险风格:
每个概念必须在一个节拍依赖它之前被落地:读者要么走进来时就知道它,要么在之前的节拍中遇到它。一个试图使用未落地概念的节拍会使读者迷失——这是旅程中唯一不能做的动作。单元是概念,而非表达它的词语:即使没有行话出现,一个节拍也可能依赖读者尚未掌握的想法。当一个概念有一个名称——一个术语——落地它意味着同时传达想法和术语。
概念通过两种方式之一被落地:
因此,每个节拍做两件事:它依赖已经落地的概念,并且它落地新的概念。维护一个已落地概念的运行列表,并在每个节拍落地后更新它。
这正是塑造选择你自己的冒险风格的关键。一个候选节拍只有当它所依赖的一切都已经落地时才是可达的;选择一个落地了概念 X 的节拍,就解锁了所有等待 X 的节拍。当你提供下一个节拍时,它们必须都从当前已落地集合可达——并说明每个落地了什么,以便用户看到它打开了哪些路径。
重要的杠杆是:你让什么成为前置条件,以及你让什么在文章内部落地。前置条件要求太多会排斥不具备这些条件的读者;在内部落地太多则会导致前面的节拍淹没在定义中。在确定前置条件时与用户解决这个问题,并在一个有吸引力的节拍被发现依赖一个尚未落地的概念时重新审视——解决方案要么是在它之前插入一个落地节拍,要么是将该概念提升为前置条件。
节拍是旅程中的一个动作。它做一件事——设定一个场景、表达一个观点、提出一个问题、插入一段旁白、转换一个角度。然后它停下,将读者留在下一个节拍可以转向的地方。
节拍的大小取决于它的需要:
如果一个"节拍"需要五段文字和三个小标题,那它不是节拍——是两个节拍粘在一起。拆分它。
从原始素材堆中取材料来填充每个节拍。你可以改写、拆分、重组或引用。素材堆是一个采石场。
当旅程完成时文章就结束了——而不是当素材堆被清空时。大多数素材堆会有剩余的碎片没有进入文章。这是正常的;这正是拥有多于所需原始素材的意义所在。