1仕組みと動作原理

活用（exploit）フェーズとしての位置付け：素材の山は固定されており、本スキルの役割は1つの道筋を選び、ビートごとに素材を掘り起こしていくことです。

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

The user has passed (or will pass) a markdown file of raw material. This is **exploit**: the exploring is done, the pile is fixed. Commit to a path through it and mine the pile to fill each beat.

explore/exploit の二分法は本リポジトリの執筆3部作全体を貫いています。writing-fragments が explore であり、writing-beats/writing-shape が exploit にあたります。

対話アルゴリズム = ゲームブック風のビートジャーニー：前提条件（prerequisites）の確定 → 2〜3個の開始ビート候補を提示しユーザーが選択 → その1拍のみを執筆 → ディスクから再読込 → 次のビート候補を2〜3個提示 → 自然な結末までループ。

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

Once the user picks a starting beat, write **only that beat** to the article file. A beat may be one sentence or several paragraphs, whatever that beat naturally is. Stop there.

ステップ4の続き：'Re-read the article file from disk. Then offer 2–3 candidate **next beats**: different directions the journey could pivot to from where the article now stands.' — 各ステップでユーザーが進路を選び、エージェントは選ばれた1拍のみを執筆します。

grounding（定着）制約エンジン：すべての概念はあるビートで使用される前に必ず接地（grounded）されている必要があります（読者が既に把握 = 前提条件、または前文のビートで導入済み）。候補ビートの到達可能性は接地済み集合によって決まります。

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

Every **concept** has to be **grounded** before a beat can lean on it: the audience either walked in knowing it or met it in an earlier beat. A beat that reaches for an ungrounded concept loses the reader; that is the one move the journey can't make. The unit is the concept, not the word for it: a beat can lean on an idea the reader lacks even with no jargon in sight.

運用の仕組み：'Keep a running list of what's grounded so far, and update it each time a beat lands.' grounding の単位は単語ではなく概念です。

ペース規律：一度に書くのは1ビートのみで決して書き急がない。書き込む前には必ずディスクからファイルを再読込してユーザーの編集内容を完全に保持。ユーザーはいつでも特定のビートの書き直しを要求可能。

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

Append one beat at a time. Never write ahead. Re-read the article file from disk before every write. Preserve user edits absolutely.

ディスクの再読込は「ユーザーが手動でファイルを変更した可能性がある」ことを既定の事実として扱い、上書きを防ぐためのものです。

終点の定義：素材を使い切ったときではなく、ジャーニーが完了した時点で終了 — ほとんどの素材の山には当然残りかすが生じます。

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

The article ends when the journey is complete, not when the pile is empty. Most piles will have leftover fragments that don't make it in. That is fine; that is the point of having more raw material than you need.

素材は石切り場（'The pile is a quarry.'）であり、言い換え（paraphrase）、分割（split）、再構成（recombine）、引用（quote）が自由に行えます。

2コア機能

01素材から複数の開始ビート候補（異なる切り口）を生成し、それぞれが新しく grounding する概念を明示

021ステップにつき1ビートのみを執筆後、ディスクを再読込して到達可能な次のビート候補を2〜3個提示

03grounding 実行リストの管理：各ビートで接地済み概念のみの使用を強制し、新概念の定着によって後続のビートを解放

04素材の石切り場的再利用：言い換え／分割／再構成／引用を自在に組み合わせ可能

05その場でのビート書き直し対応：'rewrite that beat' で対象のビートのみを修正し、他の部分は変更しない

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

作業ディレクトリを限定

管理者向け

操作ログを保持

判定根拠（ファイルパスと抜粋）

本地工作目录: ファイルの読み書きと成果物出力：ユーザー指定の記事ファイル：ステップごとに追加で1ビートを追記。ユーザー要求に応じて特定ビートをその場で編集（'rewrite that beat' in place）

監査ノート： ローカルファイル操作のみ：ユーザーの素材ファイルの読み込み、指定された記事ファイルへのビート追記・その場での編集を行います。スクリプト実行、外部ネットワーク送信、認証情報の読み取りはありません。注意点：書き込み先パスは完全にユーザーが指定（'ask once and remember the path'）し、勝手に決定することはありません。モデルが生成したテキストはユーザーのレビューが必要です。

5二重目の独立検証

[ok] choose-your-own-adventure 交互流程（候选拍 → 用户选 → 只写一拍 → 重读 → 再候选） — SKILL.md 步骤 1-5 逐字存在：'Write 2–3 candidate **starting beats**'、'write **only that beat**'、'Re-read the article file from disk. Then offer 2–3 candidate **next beats**'。
[ok] grounding 机制（prerequisite/introduced + 运行清单 + 可达性） — Grounding 整节存在，含 'Keep a running list of what's grounded so far'；候选拍可达性由 grounded 集决定。
[ok] 只写一拍、不超前 — 'Append one beat at a time. Never write ahead.' 原文在。
[ok] 每次写前重读磁盘、保留用户编辑 — 'Re-read the article file from disk before every write. Preserve user edits absolutely.' 原文在。
[ok] 就地重写特定 beat — 'edit in place, leave the rest alone' 原文在。
[ok] 文件写入范围 — 仅用户指定文章文件；'If the user did not say where to save the article, ask once and remember the path.' 无其它路径指令。
[ok] 外部依赖为空 — token 扫描零命中；无 CLI/API/网络/包。
[ok] 元数据 + beta 状态 — GitHub API MIT/257659/2026-09-04；本地 HEAD == 3cca18b；in-progress README 列为 beta。

6結論

対話的な道筋選択による手戻りの削減：各ステップでユーザーが方向性を選び、記事の展開を双方で共同決定する旅となります。

grounding による読者の認知負荷へのハード制約：「読者が理解できない概念を使ってしまう」という執筆のありがちな落とし穴を根絶します。

ビート粒度の規律：1つのビートで扱う事柄は1つのみとし、大きすぎるブロックは強制的に分割します。

ユーザーの編集に極めて寛容：書き込み前のディスク再読込とその場での書き直しにより、手動修正の痕跡を上書きしません。

最適な用途： 手元に素材（インタビュー、メモ、断片など）の山があり、各ステップでピボット可能なビートによって構成される対話形式の記事を作りたい執筆者に最適です。特に読者の認知負荷を重視し、1拍ずつ丁寧に磨き上げたい人に向いています。

不向きな用途： 一度に完成稿を出力させたいユーザー（1ビートごとの確認には時間がかかります）、素材の探索・収集がまだ必要な段階（それは writing-fragments の explore の役割です）、厳密なアウトラインや論証構造が求められる論文風の執筆（本スキルは旅とビートで構成されるため、論証ツリーの網羅性は保証されません）には適していません。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload writing-beats.tar.gz

sha256: e5908f87db6a7beb…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 3cca18b368.