1仕組みと動作原理
完全な指示ベースの「執筆パートナー」：skill ディレクトリ内には SKILL.md ファイルが1つあるのみで、すべての能力は7つの執筆スキルを一連のコラボレーションフローとして記述し、ホストモデルに実行させる点にあります。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
This skill acts as your writing partner, helping you research, outline, draft, and refine content while maintaining your unique voice and style.
ここでの処理内容：「AIと長文を書く」作業を再利用可能なステージ（明確化 → アウトライン → リサーチ → フック → セクション別フィードバック → 全文最終レビュー → ブラッシュアップ）に分解し、各ステージの成果物の形式として厳格な出力テンプレートを提供。
能力リストは番号付きリストとして固定化されており、モデルはフィードバックを伴わない一方的な執筆を防ぐため、1〜7の項目を順番に実行します。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
## What This Skill Does 1. **Collaborative Outlining**: Helps you structure ideas into coherent outlines 2. **Research Assistance**: Finds relevant information and adds citations 3. **Hook Improvement**: Strengthens your opening to capture attention 4. **Section Feedback**: Reviews each section as you write 5. **Voice Preservation**: Maintains your writing style and tone 6. **Citation Management**: Adds and formats references properly 7. **Iterative Refinement**: Helps you improve through multiple drafts
各ステージには Markdown 出力テンプレートが埋め込まれています。アウトライン用テンプレートには Research To-Do チェックリストが含まれており、「他に何を調べる必要があるか」を明示化します。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
## Research To-Do - [ ] Find data on [topic] - [ ] Get examples of [concept] - [ ] Source citation for [claim]
テンプレート内の `[Research needed: specific topic]` といったプレースホルダーは、リサーチタスクの割り振りポイントとしても機能します。
リサーチ段階では信頼できる情報源と引用フォーマットの提示が求められ、3種類の引用スタイル（インライン / 番号付き / 脚注）と進行中の References リストが例示されます。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
**Inline Citations**: ```markdown Studies show 40% productivity improvement (McKinsey, 2024). ``` **Numbered References**: ```markdown Studies show 40% productivity improvement [1]. [1] McKinsey Global Institute. (2024)... ``` **Footnote Style**: ```markdown Studies show 40% productivity improvement^1 ^1: McKinsey Global Institute. (2024)...
セクション別フィードバックは固定の5列テンプレート（What Works / Clarity / Flow / Evidence / Style ＋ 行単位の修正提案）を採用しており、毎回のフィードバックが抽象的な論評ではなく実行可能な編集内容であることを保証します。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
## What Works Well ✓ - [Strength 1] - [Strength 2] - [Strength 3] ## Suggestions for Improvement ### Clarity - [Specific issue] → [Suggested fix] - [Complex sentence] → [Simpler alternative] ### Flow - [Transition issue] → [Better connection] - [Paragraph order] → [Suggested reordering] ### Evidence - [Claim needing support] → [Add citation or example] - [Generic statement] → [Make more specific] ### Style - [Tone inconsistency] → [Match your voice better] - [Word choice] → [Stronger alternative] ## Specific Line Edits Original: > [Exact quote from draft] Suggested: > [Improved version] Why: [Explanation] ## Questions to Consider - [Thought-provoking question 1] - [Thought-provoking question 2] Ready to move to next section!
トーン＆マナー（声）の保護は厳格な原則として規定されています。置換ではなく提案を行うこと、ユーザーの文体に合わせること、ユーザーが固執する場合はそのバージョンを尊重することなどを定めています。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
- **Suggest, don't replace**: Offer options, not directives - **Match tone**: Formal, casual, technical, friendly - **Respect choices**: If they prefer their version, support it - **Enhance, don't override**: Make their writing better, not different
作業ディレクトリとファイル構成（outline.md / research.md / draft-v1..vN / final.md / feedback.md / sources/）を規定し、執筆をバージョン管理可能なエンジニアリングプロセスへと変換します。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
### Setup Your Writing Environment Create a dedicated folder for your article: ``` mkdir ~/writing/my-article-title cd ~/writing/my-article-title ``` Create your draft file: ``` touch article-draft.md
`mkdir ~/writing/my-article-title` は、ユーザーがターミナルで実行するか、エージェントにディレクトリを作成させるためのサンプルコマンドです。skill 自体にスクリプトは含まれず、実際のディスク書き込みはホストのファイルツールが行います。
リサーチ段階では特定の検索バックエンドを指定せず、「どこで調べるか」はホスト既存のWebアクセス/ナレッジ能力に委ねているため、スキル自体の外部公開面はゼロであり、純粋なコラボレーションのオーケストレーションにとどまります。
cli-tool/components/skills/business-marketing/content-research-writer/SKILL.md
- Search for relevant information - Find credible sources - Extract key facts, quotes, and data
第4バッチの基準に基づく：SKILL.md は外部の検索/生成バックエンドを指名していないため、評価レベルの引き上げは行いません。Web検索アクションはホストのツールによって決定され、verdict.risks に記載されます。
2コア機能
01協調型アウトライン作成：構造の骨格 ＋ リサーチ不足箇所の注記 ＋ 反復的な調整
02リサーチと引用の追加：情報源の探索、事実/引用/データの抽出、ユーザーの好みに合わせた引用フォーマットの適用と References の維持
03フックの改善：既存の冒頭の診断（効果的な点/強化できる点/感情的インパクト）を行った上で、3つの代替案と効果的な理由を提示
04セクションごとのリアルタイムフィードバック：5列テンプレート ＋ 具体的な行レベルの修正 ＋ 検討すべき問い
05トーン（文体）の保持：既存のサンプルを読んで文体を学習、決めつけずに選択肢を提示、定期的なトーンの確認
06全文の最終レビュー：構成/コンテンツ/技術的品質/読みやすさ ＋ 公開前チェックリスト（主張の裏付け、引用フォーマットを含む）
07コンテンツ形態に応じたワークフロー切り替え：ブログ / ニュースレター / 技術チュートリアル / ソートリーダーシップの4つのフロー
08執筆プロジェクトの推奨ファイル構成（outline / research / draft-vN / final / feedback / sources）
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
アクセス可能ドメインとキー範囲を宣言
管理者向け
最小権限のキー、リクエストログを保持
判定根拠（ファイルパスと抜粋）
- 网络端点: 外部ネットワークアクセスの宣言: 本 skill 自体にはネットワークコードやエンドポイントは一切含まれていません。「Search for relevant information」はホスト既存の検索能力によって実行されます（SKILL.md は
- 本地工作目录: ファイルの読み書きと成果物の出力: SKILL.md は執筆プロジェクト用ディレクトリとファイルの作成を指示します：`mkdir ~/writing/my-article-title`、`touch article-dr
監査ノート： 判定対象は本 skill ディレクトリ（SKILL.md ファイル1つのみ）です。スクリプトなし、実行可能コードなし、認証情報の読み取りなし、特定の外部エンドポイント指定なしとなっています。青（Blue）ランク判定の根拠は、ローカルディスクへの書き込み要件（mkdir ~/writing/... / touch article-draft.md / 推奨される outline-research-draft-sources ファイル構成）が明示されているため、「ローカルでの読み書きのみ、外部送信なし」に該当します。Web検索はホストのツールが担い、SKILL.md はバックエンドを指定していないため、第4バッチの基準に基づきランク引き上げは行いません（特定の検索/生成バックエンドが名指しされている場合のみ橙（Orange）判定となります）。注意点：リサーチ段階のサンプル引用はフォーマット用のプレースホルダー（McKinsey 2024、Gartner 80%、Airbnb事例など）であるため、そのままコピーすると未検証の引用となります。ユーザー自身で情報源を検証する必要があります。
5二重目の独立検証
- [ok] skill 目录仅 SKILL.md — sparse-checkout 只含 cli-tool/components/skills/business-marketing/content-research-writer/；该目录下 find 结果仅 SKILL.md。
- [ok] 无网络代码 — http/https、curl、wget、requests、urllib、fetch 全文零命中；研究能力表述为「Search for relevant information」，未指向任何端点。
- [ok] 无凭证读取 — API_KEY/token/secret/password/keychain 零命中；全文不涉及登录或私有数据源。
- [ok] 写盘指令确实存在（判蓝依据） — How to Use 节含 `mkdir ~/writing/my-article-title`、`cd ~/writing/my-article-title`、`touch article-draft.md`；File Organization 节给出 7 个文件/目录的推荐结构。
- [ok] 引用体例三种 + References 维护 — Citation Management 节含 Inline Citations / Numbered References / Footnote Style 三个代码块与 `## References` 运行清单。
- [ok] 「研究」是否有真实检索能力 — SKILL.md 只写「Search for relevant information / Find credible sources / Extract key facts, quotes, and data」，不含任何 API、CLI 或端点——检索能力完全来自宿主；示例中的数字与来源（McKinsey 2024、Gartner 80%、Airbnb 案例）是格式示范且未经核验，已在 risks 标出。
- [ok] 声音保护原则 — Preserve Writer's Voice 节四项原则（Learn their style / Suggest, don't replace / Match tone / Respect choices / Enhance, don't override）与三句定期确认话术逐字核对通过。
- [ok] 示例与人名的事实性 — Example 1 以 Teresa Torres 的工作流举例、例中 Marty Cagan / Airbnb 均为说明性示例，不代表本 skill 与其有合作关系；已在 traits 注明。
6結論
最適な用途： 長文（ブログ、ニュースレター、チュートリアル、ソートリーダーシップ原稿）の作成をエージェントと協調して進めたい執筆者に最適：セクションごとのフィードバック、引用管理、文体の保持を求め、原稿ディレクトリ内でエージェントを実行することを許容できるユーザー向け。すでに独自の執筆フローを確立しているユーザーにとっては、全プロセスを順守するツールというより「フィードバック用テンプレート集」として役立ちます。
不向きな用途： 引用の厳格な検証が求められる学術・研究論文の執筆には不向き（サンプルの引用はプレースホルダーであり、検索はホストに依存するため、逐一検証が必要）；短尺コンテンツ（小紅書/ツイートなど）や単なるレイアウト・配信目的には不向き；中国語環境へのそのままの適用には不向き（テンプレートや用例は英語圏のプロダクト業界の文脈向け）；組み込みの検索/スクレイピング機能を期待する用途には不向き（本スキルにはネットワークコードは一切含まれていません）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload content-research-writer.tar.gz
sha256:
Option B · Copy Guide for Agentda1a7a70a95381f5…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 41afe2db06.