1仕組みと動作原理
純粋な explore 段階としての位置づけ:構造を固定せず、アウトラインも作らず、断片を生み出す『grilling』セッションを実行して探索空間を広げる。
skills/in-progress/writing-fragments/SKILL.md
This is pure **explore**: widen the space of what could be written without committing to structure. Committing is _exploit_, a separate skill's job. Run a grilling session that produces fragments, interviewing the user relentlessly about whatever they want to write about. Imposing phases, outlines, or article structure is out of scope here.
explore/exploit の境界はリポジトリの writing シリーズにおける構成原理であり、断片フェーズではいかなる構造へのコミットも禁じられる。
記録の規律:ユーザーの最初のプロンプトさえも最初の断片として収録する。断片は単一の markdown ファイルに追記され、初回書き込み時は H1 の仮タイトルのみを配置し、メタデータ/目次/日付は含めない。
skills/in-progress/writing-fragments/SKILL.md
Capture fragments from the very first thing the user says, including the initial prompt. On first write, put a single H1 at the top with a working title (it can change later) and nothing else: no metadata, no TOC, no date.
形式こそが規律:'Fragments are separated by a horizontal rule (`\n---\n`). No headings inside the body. No tags. No order beyond the order they were added.'
断片の品質基準 = 著者が読めれば十分であり、初見の読者が理解できる必要はない:'is this a self-contained argument?' ではなく 'is this a piece of good writing?' を基準とする。
skills/in-progress/writing-fragments/SKILL.md
It must be _readable by the author_ (the author can tell what it means), but it does not need to define its terms or be comprehensible to a cold reader. The bar is "is this a piece of good writing?", not "is this a self-contained argument?"
中途半端な思考(half-thought)、ヴィネット、引用、気の利いたフレーズなどの異質な断片を許容し、断片を意図的に不均質に保つ。
leading word は最も価値の高い断片タイプとして位置づけられる:対話が繰り返し現れる思考をめぐって展開する場合、その思考を命名する単語や比喩を能動的に造語し、後続の exploit における構造、場面転換、見出しの基礎を築く。
skills/in-progress/writing-fragments/SKILL.md
Of these, the leading word is the most valuable fragment to land. It is load-bearing: name the right one in explore and it shapes the structure, the transitions, and the title later, paying dividends through the entire exploit phase. When the conversation circles a recurring idea, push to coin a word for it.
_tracer bullets_ や _fog of war_ のようにパターン全体を命名する言葉を用いた例示——著者の方法論的嗜好。
ペース配分の規律:都度許可を求めずにサイレントで追記する。書き込みのたびにディスクから再読み込みし、全体を上書きすることは決してせず、追記するかユーザーの要求に応じて該当箇所のみを直接変更する。
skills/in-progress/writing-fragments/SKILL.md
Append silently. Don't ask permission for each fragment. Mention what you added in passing ("adding that"), but don't interrupt the conversation with save dialogs. Before every write: re-read the file from disk. The user may have edited, reordered, or deleted fragments between turns, so preserve their changes. Never overwrite the file; only append (or, if the user asks, edit a specific fragment in place).
対話のスムーズさを最優先:書き込みアクションによる邪魔を最小限に抑え、ファイル状態は常にディスクを基準とする。
2コア機能
01grilling セッションを通じてユーザー(初回のプロンプトを含む)から執筆の断片を発掘
02leading word の造語:繰り返し現れる思考に、作品全体を支える比喩や新語を命名
03単一ファイルの断片ライブラリ保守:H1 見出し + --- 区切り、本文見出し/タグ/メタデータなし
04断片レベルの編集コマンド:cut the last one / rewrite sharper / merge those two
05セッション間での対象パスの記憶:パス未指定の場合は一度だけ尋ねて記憶
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
- 本地工作目录: ファイルの読み書きおよび成果物の出力: ユーザーが指定(または一度質問して記憶)した単一の markdown ファイル:追記のみ、またはユーザーの要求に応じて特定の fragment を直接編集/削除
監査ノート: ローカルファイル操作のみ:ユーザーが指定した単一ファイルに断片を追記('Never overwrite the file; only append' と明記)。追加・変更・削除はユーザーが明示的に要求した断片に対してのみ発生('cut the last one' などが第一級コマンド)。スクリプトなし、外部ネットワーク送信なし、クレデンシャルの読み取りなし。注意点:書き込みパスはユーザーによる指定が必要。内容はモデルが対話から生成したテキストであり、ファイルに継続的に追記されることをユーザーが認識している必要がある。
5二重目の独立検証
- [ok] grilling 会话引擎声明 — 'Run a grilling session that produces fragments' 原文在;调用 model-invoked 原语方向合规。
- [ok] 首次 prompt 也捕获 — 'Capture fragments from the very first thing the user says, including the initial prompt.' 原文在。
- [ok] H1 + --- 文件格式纪律 — 'put a single H1 at the top with a working title…nothing else'、'Fragments are separated by a horizontal rule' 原文在。
- [ok] 只追加不覆盖 + 写前重读磁盘 — 'Never overwrite the file; only append'、're-read the file from disk' 原文在。
- [ok] leading word 铸造指令 — 'the leading word is the most valuable fragment to land…push to coin a word for it' 原文在。
- [ok] 文件写入范围 — 仅用户指定单文件;'If the user did not pass a path, ask once where to save the document' 无其它路径。
- [ok] 外部依赖为空 — token 扫描零命中;grilling 是仓库内 skill 引用。
- [ok] 元数据 + beta 状态 — GitHub API MIT/257659/2026-09-04;本地 HEAD == 3cca18b;in-progress README 列为 beta。
6結論
最適な用途: 執筆前の素材探査に最適:頭の中に曖昧なテーマがあり、対話しながら生の素材を蓄積したい著者に向いている。また『日常の noticings』を将来活用できる断片ライブラリとしてストックする用途にも適している。writing-shape/writing-beats と連携(fragments → 素材 → exploit)させることで最大の効果を発揮する。
不向きな用途: 完成原稿やアウトラインをすぐに手に入れたいユーザーには不向き。素材がすでに揃っており構成のみが必要な場合(直接 exploit に進むべき)には不向き。整理された読みやすいファイル構造を求める場面には不向き(断片ファイルは意図的に非構造化されている)。
Install Agent-Ready
① Verified Mirror 2026-09-09
Option A · Direct DownloadDownload writing-fragments.tar.gz
sha256:
Option B · Copy Guide for Agentca6d39f53627a5dd…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 3cca18b368.