Agent skill

creative-write

Quellcode ansehen: miles990/creative-toolkit

#116Globales Ranking · von 116 SkillsSafe

Installation

npx skills add miles990/creative-toolkit --skill creative-write

1

Installationen

EU-hosted inference API

Power your AI agent skills with open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

MiniMax

MiniMax M3

$0.50 / $1.90

per M tokens

Z.ai

GLM 5.3 Flash

$0.20 / $0.60

per M tokens

MoonshotAI

Kimi K3

$4.00 / $18.00

per M tokens

DeepSeek

DeepSeek V4.1 Flash

$0.40 / $1.42

per M tokens

Creative Write — 通用創意內容生成引擎

概述

本 Skill 是一個通用的創意內容生成引擎,支援多領域的結構化創作工作流。透過領域專用指引(domain guide),可適配不同類型的創意內容生成需求(小說、劇本、企劃等)。

核心原則

  1. 領域驅動 — 根據專案配置載入對應領域的寫作指引
  2. 記憶驅動 — 大量上下文注入確保內容一致性
  3. 結構化生成 — 按領域定義的層級(layers)逐單元生成
  4. 人類協作 — 關鍵節點提請人工審核
  5. 漸進式輸出 — 原始生成 + 潤色統一的兩階段流程

前置步驟(Domain 載入)

1. 讀取專案配置

使用 Read 讀取 .creative/config.yaml,取得:

  • domain 值(例如: novel, screenplay, plan)
  • 專案基礎配置(類型、風格、目標字數等)

如果配置不存在:

錯誤:未找到 .creative/config.yaml

請先執行 /creative-init 初始化專案。

2. 計算路徑

從 Skill header 的 Base directory 計算 PLUGIN_ROOT:

  • PLUGIN_ROOT = Base directory 去掉 /skills/creative-write 部分
  • 例如: /path/to/project/skills/creative-write → /path/to/project

設定路徑變數:

  • DOMAIN_DIR = $PLUGIN_ROOT/shared/domains/{domain}/
  • PROJECT_ROOT = 專案根目錄(.creative/config.yaml 所在位置)

3. 載入領域配置

使用 Read 讀取 $DOMAIN_DIR/domain.yaml,取得:

  • layers — 內容生成的層級定義(例如 L4: scene, L5: chapter)
  • paths — 領域特定的檔案路徑映射
  • word_count — 各單元的字數範圍
  • context_sources — 上下文收集來源配置

範例 domain.yaml 結構:

domain: novel
layers:
  L4:
    name: scene
    unit: 場景
    word_range: [1500, 3000]
  L5:
    name: chapter
    unit: 章節
    aggregation: merge_and_polish
paths:
  planning: planning/
  drafts: drafts/
  knowledge: knowledge/
  memory: memory/
context_sources:
  - type: planning
    priority: 1
  - type: memory
    priority: 2
  - type: knowledge
    priority: 3

4. 載入寫作指引

使用 Read 讀取 $DOMAIN_DIR/write-guide.md,取得:

  • 上下文收集規則
  • 單元生成標準
  • 品質檢查清單
  • 記憶更新格式

工作流程

Step 1: 前置檢查

  1. 確認專案配置已載入(.creative/config.yaml)
  2. 確認狀態文件存在(.creative/status.json)
  3. 根據領域的 paths 配置,確認規劃文件已存在:
    • 單元列表(例如 novel: scene list)
    • 上級大綱(例如 novel: chapter outline)

錯誤處理:

  • 缺少配置 → 提示執行 /creative-init
  • 缺少規劃 → 提示執行 /creative-plan

Step 2: 上下文收集(記憶注入)

根據 domain.yaml 中的 context_sources 和 write-guide.md 中的詳細規則,收集上下文:

通用上下文收集框架

按優先順序收集:

  1. 規劃上下文(必讀)

    • 讀取當前單元的規劃文件
    • 讀取上級結構文件
  2. 風格約束(必讀)

    • 讀取風格指南文件
    • 確保風格一致性
  3. 短期記憶(必讀)

    • 讀取最近生成單元的摘要
    • 確保連貫性
  4. 登場元素(按需)

    • 根據當前單元涉及的元素(角色、場景等)
    • 使用 Grep 搜索知識庫
    • Read 匹配的知識文件
  5. 領域設定(按需)

    • 搜索相關的領域專用設定
    • 讀取相關配置文件
  6. 前序內容(按需)

    • 如果不是首個單元,讀取前序內容的結尾
    • 確保銜接自然
  7. 中期記憶(長篇需要)

    • 如果內容規模超過閾值,讀取摘要文件
    • 使用 Glob 找到所有摘要,讀取最近摘要

上下文組裝

將收集到的上下文按 write-guide.md 中定義的格式組裝成結構化提示。


Step 3: 逐單元生成(L4 層級)

根據 domain.yaml 中 layers.L4 的定義,逐單元生成內容。

生成流程

對規劃列表中的每個單元,依序執行:

  1. 確認單元設定 — 從規劃列表讀取當前單元的所有參數
  2. 組裝單元上下文 — 使用 Step 2 收集的資訊 + 前一單元的結尾
  3. 生成單元文本 — 根據 write-guide.md 中的寫作標準生成內容
  4. 寫入單元文件 — 使用 Write 寫入原始文件

單元文件格式

根據 write-guide.md 中定義的格式,包含 YAML frontmatter 和正文。

Human Gate 框架

對於關鍵單元(根據 write-guide.md 定義的條件),使用 AskUserQuestion 請求審核:

關鍵單元審核請求

單元:{unit_description}
類型:{critical_type}
字數:{word_count} 字

摘要:{brief_summary}

請審核以下要點:
{review_checklist from write-guide.md}

請回覆:
- "確認" 保留當前版本
- "修改 [具體說明]" 調整特定部分
- "重寫" 重新生成此單元

Step 4: 合併潤色(L5 層級)

所有 L4 單元生成後,進行 L5 層級的合併和潤色。

合併流程

  1. 使用 Glob 收集所有 L4 單元文件
  2. 按單元編號排序
  3. 讀取所有單元內容

潤色工作

根據 write-guide.md 中 L5 層級的潤色標準執行:

  • 單元間過渡優化
  • 一致性檢查
  • 節奏調整
  • 開頭與結尾強化

輸出最終稿

使用 Write 寫入最終文件,格式根據 write-guide.md 定義。

字數統計

檢查總字數是否在 domain.yaml 定義的範圍內,如偏差過大則調整。


Step 5: 記憶更新 + 狀態更新

根據 write-guide.md 中的記憶更新規則:

短期記憶更新

使用 Edit 更新短期記憶文件,添加新生成單元的摘要。

知識庫更新(如有變化)

如果生成內容中有新元素或元素狀態變化:

  • 使用 Edit 更新對應的知識庫文件

狀態文件更新

使用 Edit 更新 .creative/status.json,記錄:

  • 已完成的單元/章節
  • 當前進度
  • 總字數
  • 最後更新時間

時間線更新

使用 Edit 更新 .creative/timeline.md,記錄重要事件。

觸發摘要生成

如果達到摘要生成閾值,提示用戶執行 /creative-memory summarize。


參數處理

基礎調用

/creative-write

自動寫作下一個未完成的單元組(根據 status.json 判斷)。

指定單元組

/creative-write {unit-group-id}

寫作指定的單元組(例如 novel: chapter-005)。如果已存在,詢問是否覆蓋。

指定子單元

/creative-write {unit-group-id} {sub-unit-id}

只寫作特定子單元(例如 novel: chapter-005 scene-003)。適用於重寫。

續寫模式

/creative-write --continue

如果上次寫作中斷,從中斷處繼續。

自動品質檢查

/creative-write {unit-group-id} --auto-check

寫作完成後自動觸發 /creative-check {unit-group-id}。


錯誤處理

規劃文件不存在

錯誤:找不到 {unit-group-id} 的規劃文件。

請先執行 /creative-plan 生成規劃,或手動創建:
{expected_planning_path}

前序單元未完成

如果要求寫作單元 N 但單元 N-1 尚未完成:

提醒:{previous_unit} 尚未完成(status: 未開始)

建議:
1. 先完成 {previous_unit} 以確保連貫性
2. 如果確定要跳過,請回覆 "跳過"(可能影響連貫性)

寫作中斷恢復

如果檢測到部分單元已生成但未完成最終稿:

檢測到 {unit-group-id} 寫作中斷。

已完成單元:{completed_list}(共 {total_count} 個單元)
未完成單元:{pending_list}

是否從 {next_unit} 繼續?
- "繼續" 從中斷處續寫
- "重新開始" 刪除已有單元,重新寫作

字數異常

根據 domain.yaml 的字數範圍,如果單元字數異常:

  • 超標:考慮拆分或精簡
  • 不足:增加細節或展開內容

輸出路徑

輸出路徑由 domain.yaml 的 paths 配置和 write-guide.md 定義,框架本身不硬編碼路徑。

通用模式:

  • L4 原始單元:{paths.drafts}/{unit-group-id}/{sub-unit-id}-raw.md
  • L5 最終稿:{paths.drafts}/{unit-group-id}/{unit-group-id}-final.md
  • 短期記憶:{paths.memory}/recent-{units}.md
  • 狀態文件:.creative/status.json
  • 時間線:.creative/timeline.md

範例互動流程

用戶: /creative-write chapter-003

Claude:
[載入 domain: novel]
[讀取 novel/domain.yaml 和 novel/write-guide.md]
開始寫作第 3 章。

[執行上下文收集]
[讀取場景列表、章節大綱、風格指南、短期記憶]
[搜索登場角色、世界觀設定]

第 3 章共 6 個場景,預計字數 12000-15000 字。
開始場景擴寫...

---

場景 1/6:{scene_title}(字數: 2100)✓
場景 2/6:{scene_title}(字數: 2400)✓
場景 3/6:{scene_title}(字數: 1800)✓

⚠️ 場景 4 為關鍵場景,請求審核...
[等待用戶確認]

用戶: 確認

場景 4/6:{scene_title}(字數: 2800)✓
場景 5/6:{scene_title}(字數: 1600)✓
場景 6/6:{scene_title}(字數: 1900)✓

開始章節潤色...

第 3 章寫作完成!

總字數:12,700 字
單元數:6 個
品質自檢:通過

已更新:
- {paths.drafts}/chapter-003/chapter-003-final.md
- {paths.memory}/recent-scenes.md
- .creative/status.json
- .creative/timeline.md

下一步建議:
- /creative-write chapter-004 繼續寫作
- /creative-check chapter-003 進行品質檢查
- /creative-status 查看整體進度

最後提醒:本 Skill 是通用框架,實際寫作標準和品質要求由領域專用的 write-guide.md 定義。寫作過程中如發現規劃不足,應暫停寫作並補充規劃,而非即興偏離規劃。

So verwenden Sie diesen Skill

  1. 1

    Install creative-write by running npx skills add miles990/creative-toolkit --skill creative-write in your project directory. Führen Sie den obigen Installationsbefehl in Ihrem Projektverzeichnis aus. Die Skill-Datei wird von GitHub heruntergeladen und in Ihrem Projekt platziert.

  2. 2

    Keine Konfiguration erforderlich. Ihr KI-Agent (Claude Code, Cursor, Windsurf usw.) erkennt installierte Skills automatisch und nutzt sie als Kontext bei der Code-Generierung.

  3. 3

    Der Skill verbessert das Verständnis Ihres Agenten für creative-write, und hilft ihm, etablierte Muster zu befolgen, häufige Fehler zu vermeiden und produktionsreifen Code zu erzeugen.

Was Sie erhalten

Skills sind Klartext-Anweisungsdateien — kein ausführbarer Code. Sie kodieren Expertenwissen über Frameworks, Sprachen oder Tools, das Ihr KI-Agent liest, um seine Ausgabe zu verbessern. Das bedeutet null Laufzeit-Overhead, keine Abhängigkeitskonflikte und volle Transparenz: Sie können jede Anweisung vor der Installation lesen und prüfen.

Kompatibilität

Dieser Skill funktioniert mit jedem KI-Coding-Agenten, der das skills.sh-Format unterstützt, einschließlich Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider und anderen Tools, die projektbezogene Kontextdateien lesen. Skills sind auf Transportebene framework-agnostisch — der Inhalt bestimmt, für welche Sprache oder welches Framework er gilt.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.