ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

awesome-novel-agent Skill

หน้า repo ↗

โดย modoojunko★ 8701 skill

ติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ ไฟล์คำสั่งให้ AI อ่าน ไม่ต่อบริการใด
  • บัญชีหรือคีย์ ไม่ต้องใส่คีย์
  • หมวด เขียนโค้ด
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
让 AI agent成为你的小说创作搭档。从世界观搭建到角色塑造,从章节规划到正文写作,一步步陪你完成整部小说。
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/skill/modoojunko-awesome-novel-agent.svg?lang=th)](https://mcp.popnx.com/th/skills/modoojunko-awesome-novel-agent)

ใช้คู่กับ

MCP ที่ต่อ AI เข้ากับบริการในงานเดียวกัน

REA

แกะการทำงานของโปรแกรมและแอปจากเทอร์มินัลหรือจาก AI

โดย morlutoใช้กันมาก↓ 388.7K/สัปดาห์★ 461.8Kอัปเดต 4 วันที่ผ่านมา

MCP · ต่อบริการรันบนเครื่อง

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

โดย fallow-rsใช้กันมาก↓ 2.4M/สัปดาห์★ 5.4Kอัปเดต เมื่อวาน

MCP · ต่อบริการรันบนเครื่อง

Desktop Commander

MCP server for terminal commands, file operations, and process management

โดย wonderwhy-erใช้กันมาก↓ 740.3K/สัปดาห์★ 10.3Kอัปเดต 4 วันที่ผ่านมา

MCP · ต่อบริการรันบนเครื่อง

Skill ที่ทำงานคล้ายกัน

หมวดงานเดียวกัน เรียงแบบเดียวกับหน้ารายการ Skill

เทียบกับตัวที่คล้ายกัน
ตัวนี้
awesome-novel-agent
reagraphifyarchifysecurity-audit-skill
ผู้ทำmodoojunkomorlutoGraphify-Labstt-a1icloudflare
จำนวน Skill11111
ดาว GitHub870461,751148,35296,75773,156
แก้โค้ดล่าสุด25 ก.ย. 256916 พ.ย. 256916 พ.ย. 256915 พ.ย. 256915 ก.ย. 2569
สัญญาอนุญาตAGPL-3.0MITApache-2.0Apache-2.0MIT

ชุดคำสั่ง (Skill) 1 ชุดจาก modoojunko ให้ AI อ่านแล้วทำงานตามวิธีนี้ · ไม่ใช่ MCP server

Skill ต่างจาก MCP ยังไง

MCP = มือ

ต่อ AI เข้ากับบริการหรือข้อมูลข้างนอก เช่น อ่าน Notion หรือสร้างใบแจ้งหนี้ ต้องมีโปรแกรมหรือ server ทำงานอยู่

Skill = คู่มือ

ไฟล์ข้อความที่สอน AI ว่างานนี้ทำยังไง ไม่ต่อบริการใด

บางตัวคล้ายกัน: Skill บางตัวมีสคริปต์เรียกเครื่องมือ และ MCP บางตัวส่งแค่ความรู้ ให้ดูที่งานที่อยากทำเป็นหลัก

ใช้กับแอปไหน

Claude CodeCodexOpenCode

ตามที่ README ของผู้ทำเขียนไว้ และโฟลเดอร์ที่มีใน repo

ติดตั้ง

ปลอดภัยไหม

  • ใครทำ

    บัญชี GitHub modoojunko (บุคคล) เปิดมา 12 ปี

  • คนใช้และการดูแล

    ★ 870 ดาว · แก้โค้ดล่าสุด 25 ก.ย. 2569

  • มีสคริปต์ไหม

    มีสคริปต์ 21 ไฟล์ที่รันบนเครื่องได้: install.sh, install.ps1, tools/check-agents.py, tools/check-chapter.py และอีก 17 ไฟล์

  • ใช้อินเทอร์เน็ตไหม

    ตรวจสคริปต์ได้ไม่ครบ (บางไฟล์ใหญ่เกิน) ควรอ่านเองก่อน

  • แก้ค่าตั้งทั้งเครื่องไหม

    สคริปต์ที่แตะโฟลเดอร์ค่าตั้ง (~/.claude หรือ settings.json): install.ps1, install.sh

ตรวจอัตโนมัติจากไฟล์ใน repo ที่ commit dcd1920 (อ่านไฟล์อย่างเดียว ไม่ได้รัน) ไม่ใช่การรับรองความปลอดภัย อ่านแล้วตัดสินใจเอง

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่ใช้ แล้วหน้านี้จะแสดงเฉพาะวิธีติดตั้งของแอปนั้น

ทางที่ 1อัปโหลดเข้า claude.ai (เว็บและแอป)

  1. ดาวน์โหลดจาก GitHub

    Skill นี้ใช้ใบอนุญาต AGPL-3.0 ซึ่งไม่อยู่ในรายการที่เราแจกต่อ เราจึงไม่แจกไฟล์ ZIP จากเว็บเรา ดาวน์โหลดจาก GitHub แล้วจัดโฟลเดอร์เอง หรือใช้ทาง "ให้ AI ติดตั้งให้" ด้านบนซึ่งง่ายกว่า

    ดาวน์โหลดจาก GitHub (ทั้ง repo) ↗

    แตกไฟล์ แล้วบีบอัดเฉพาะโฟลเดอร์ awesome-novel-agent ใหม่ ZIP ต้องมีโฟลเดอร์ awesome-novel ที่มี SKILL.md อยู่ชั้นบนสุด ห้ามวางไฟล์หลวมไว้ชั้นบนสุด

  2. เปิดหน้า Skills ใน claude.ai แล้วอัปโหลด

    +Create skillUpload a skillเลือกไฟล์ awesome-novel.zip

    เปิด claude.ai/customize/skills ↗

  3. ไม่เห็นปุ่ม Upload: เปิดสิทธิ์สร้างไฟล์ก่อน

    SettingsCapabilitiesCode execution and file creation

    ต้องเปิด Code execution and file creation ก่อน (เมนูรุ่นใหม่เรียก Create and edit files) · แผนส่วนตัวที่ Settings → Capabilities · Team/Enterprise ผู้ดูแลเปิดที่ Organization settings → Plugins & skills · ใช้ได้ทุกแผนรวมแผนฟรี

อัปโหลดครั้งเดียว ใช้ได้ทั้ง claude.ai และ Claude Desktop รวมถึง Claude Code รุ่นใหม่ที่ล็อกอินด้วยบัญชี Claude (ล็อกอินด้วยคีย์ API ไม่ซิงก์)

Cowork และ session บนคลาวด์ใช้ Skill ที่เปิดในบัญชี claude.ai ไม่อ่าน ~/.claude/skills ในเครื่อง (งานตั้งเวลาของ Claude Desktop ที่รันในเครื่องยังอ่านได้)

ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: support.claude.com, support.claude.com, code.claude.com

ทางที่ 1ให้ Claude Code ติดตั้งให้

คัดลอกประโยคนี้ไปวางในแชตของ Claude Code

ติดตั้งไว้ที่ไหน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ

AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น

เปิด Claude Code ใหม่ แล้วพิมพ์ /awesome-novel-agent หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง

ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com

สำหรับคนที่ใช้ Terminal

Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน

  2. คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.claude/skills

    คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md

    กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

  3. เปิด Claude Code ใหม่ แล้วพิมพ์ /awesome-novel-agent หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง

Skill ที่ติดตั้งเองใช้ได้ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยาย Codex ใน IDE · ChatGPT บนเว็บและมือถือใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี

แอป ChatGPT บนคอม

แอป ChatGPT บนคอมมี Codex อยู่ในตัว Codex อ่าน Skill จากโฟลเดอร์ ~/.agents/skills

ทางที่ 1ให้ ChatGPT ติดตั้งให้

เปิด Codex ในแอป ChatGPT บนคอม แล้ววางประโยคนี้ในแชต

ติดตั้งไว้ที่ไหน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

AI จะบอก path ให้ดูก่อนติดตั้งเสมอ

AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น

ทางที่ 2วางโฟลเดอร์เอง

วางโฟลเดอร์ awesome-novel ไว้ที่ ~/.agents/skills/awesome-novel

~ คือโฟลเดอร์บ้านของคุณ ($HOME)

สำหรับคนที่ใช้ Terminal

Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน

  2. คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills

    คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md

    กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

หลังติดตั้ง

  • แอป ChatGPT บนคอม: เปิด Skills ในแถบข้างเพื่อดูว่า Skill ขึ้นแล้ว
  • เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
  • Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่

ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com

ChatGPT บนเว็บและมือถือ

ใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี

อยากใช้ Skill นี้กับ ChatGPT ให้ใช้แอป ChatGPT บนคอมตามวิธีด้านบน

ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com

ทางที่ 1ให้ Codex ติดตั้งให้

คัดลอกประโยคนี้ไปวางในแชตของ Codex · ใช้ได้ทั้ง Codex ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยายใน IDE

ติดตั้งไว้ที่ไหน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ

AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น

Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่ · เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill

ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com

สำหรับคนที่ใช้ Terminal

Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน

  2. คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills

    คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md

    กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

  3. เปิด Codex ใหม่ แล้วสั่งงานที่ตรงเรื่อง Codex จะเห็น skill นี้ในรายการ

ทางที่ 1ให้ Cursor ติดตั้งให้

คัดลอกประโยคนี้ไปวางในแชตของ Cursor

ติดตั้งไว้ที่ไหน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ

AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น

ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก awesome-novel-agent

ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: cursor.com

สำหรับคนที่ใช้ Terminal

Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน

  2. คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.cursor/skills

    คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md

    กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

  3. ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก awesome-novel-agent

ทางที่ 1ให้ AI ติดตั้งให้

สำหรับแอปอื่นที่อ่าน Skill ได้ ประโยคนี้มี path ของ Claude Code, Codex และ Cursor ให้ AI เลือกตามแอปที่ใช้ · คัดลอกประโยคนี้ไปวางในแชตของแอป

ติดตั้งไว้ที่ไหน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน

เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ

AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น

ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com, learn.chatgpt.com, cursor.com

สำหรับคนที่ใช้ Terminal

แอปอื่นที่รองรับ Agent Skills (เช่น Gemini CLI, GitHub Copilot) เก็บ skill ในโฟลเดอร์ต่างกัน ดูคู่มือของแอปนั้น แล้วคัดลอกโฟลเดอร์ที่มี SKILL.md ไปวาง

ดูบน GitHub ↗

ตรวจโฟลเดอร์ skill กับคู่มือทางการของ Claude Code, Codex และ Cursor เมื่อ 11 พ.ย. 2569

ดูไฟล์ต้นฉบับ SKILL.md

ข้อความต่อไปนี้มาจาก repo ของผู้ทำ ไม่ใช่คำสั่งของ PopNx MCP

แสดง 8,000 ตัวอักษรแรก · เปิดไฟล์เต็มบน GitHub

---
name: awesome-novel
description: 和 AI 协作写小说的工作流系统。9 个 agent 协作完成从设定到归档的完整写作流程。入口检测 → 初始化/迁移 → 交 novel-agent 调度。适用场景:从零写新小说、导入已有小说。
---

# Novel — 小说创作工作流

和 AI 一起写小说。本 skill 负责项目状态检测、新项目初始化、旧版项目自动迁移,完成后将控制权交给 novel-agent。

**唤起方式:** 用户在项目目录输入 `/awesome-novel`(Claude Code / OpenCode / Grok Build 直接输入;Codex 输入 `/use awesome-novel`;或说"帮我写本小说")即进入下方检测流程。新目录会先询问作者,确认后运行 `init.py` 在本地初始化小说工作空间。

## OpenCode 集成说明

本 skill 也支持 OpenCode。安装在 `~/.config/opencode/skills/awesome-novel/` 后,项目初始化脚本会自动部署 agent 定义到 `.opencode/agents/`,OpenCode 即可自动发现:
- `@novel-agent` — 加载总指挥 agent
- `@volume-planner`、`@chapter-planner` 等 — 加载子 agent
- **Task 工具** — novel-agent 通过 Task 工具调用子 agent

**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ Task 工具调用子 agent → 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。

## Codex 集成说明

本 skill 也支持 Codex。skill 本体**用户级安装**到 `~/.codex/skills/awesome-novel/`;`init.py --platform codex` 初始化小说项目时,把 9 个自定义 agent 部署为项目级 `.codex/agents/*.toml`(Codex 官方 TOML 格式,含 `name`/`description`/`developer_instructions`):
- `@novel-agent` — 总指挥 agent(TOML 名 `novel-agent`)
- `@volume-planner`、`@chapter-planner` 等 — 子 agent(TOML 名与源 agent 一致)
- **独立工具** — `memory-recording`、`roleplay-sandbox` 部署为 `.codex/skills/<name>/SKILL.md`

**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `spawn_agent` 调度子 agent(agent 名 = `.codex/agents/*.toml` 的 name)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。

## ZCode 集成说明

本 skill 也支持 ZCode。ZCode 的 skill 约定(目录 + `SKILL.md`)与 Claude Code 同源,天然兼容;但 ZCode 无项目级 agents 目录,agents 即 skills。skill 本体**用户级安装**到 `~/.zcode/skills/awesome-novel/`;`init.py --platform zcode` 初始化小说项目时,把 9 个 agent 部署为项目级 `.zcode/skills/<name>/SKILL.md`(与 Reasonix 同构,另含 memory-recording、roleplay-sandbox 独立工具,共 11 个 skill):
- novel-agent — 总指挥(入口调度者,由 ZCode 按描述自动发现,无 `@` 语法)
- writer、volume-planner、chapter-planner 等 — 子 agent(subagent skill,由 novel-agent 用 Agent 工具按 skill 名 spawn)

**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `Agent` 工具调度子 agent(子 agent 名 = `.zcode/skills/` 下的 skill 名)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。

## dsh 集成说明

本 skill 也支持 DeepSeek Harness(dsh,DeepSeek 官方的开源 agent harness)。dsh 的 skill 约定(目录 + `SKILL.md`,frontmatter 只认 `name`/`description`)与 Claude Code 同源,天然兼容;但 dsh 无项目级 agents 目录(subagent 是运行时能力),agents 即 skills。skill 本体**用户级安装**到 `~/.dsh/skills/awesome-novel/`;`init.py --platform dsh` 初始化小说项目时,把 9 个 agent 部署为项目级 `.dsh/skills/<name>/SKILL.md`(与 ZCode 同构,另含 memory-recording、roleplay-sandbox 独立工具,共 11 个 skill;`<项目根>/.dsh/skills/` 是 dsh 的项目级 skill 根,自动发现且优先级最高):
- novel-agent — 总指挥(入口调度者,由 dsh 按 name/description 自动路由,无 `@` 语法)
- writer、volume-planner、chapter-planner 等 — 子 agent(subagent skill,由 novel-agent 用 `subagent` 工具调度)

**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `subagent` 工具调度子 agent(prompt 中要求子 agent 先调用 `skill(name="<子agent名>")` 加载自身指令;子 agent 名 = `.dsh/skills/` 下的 skill 名)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。

## Grok Build 集成说明

本 skill 也支持 [Grok Build](https://docs.x.ai/build/overview)(SpaceXAI 的编码 agent TUI)。skill 本体**用户级安装**到 `~/.grok/skills/awesome-novel/`;`init.py --platform grok` 初始化小说项目时,把 9 个自定义 agent 部署为项目级 `.grok/agents/*.md`(Grok 原生 agent 发现路径,含 `name`/`description`/`tools`):
- novel-agent — 总指挥(必须在主会话运行;Grok 子代理深度上限为 1,禁止把 novel-agent 当 subagent 调度)
- writer、volume-planner、chapter-planner 等 — 子 agent(由 novel-agent 用 `spawn_subagent` 按 `subagent_type` 调度)
- **独立工具** — `memory-recording`、`roleplay-sandbox` 部署为 `.grok/skills/<name>/SKILL.md`

**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `spawn_subagent` 调度子 agent(`subagent_type` = `.grok/agents/*.md` 的 name,`isolation: none`)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。

## 检测流程 — 严格按此执行,禁止跳过

```
用户输入 /awesome-novel(或"帮我写本小说")→ 检测项目状态
├─ 作者表达的是短篇意图("写短篇 / 写个盐言故事 / 写个短故事")→ 走短篇分支(见下)
├─ story.yaml 存在 → 旧版 2.x → 执行自动迁移(见下文)
├─ story.md 不存在 → 询问作者是否初始化 → 是则执行 init.py
│   └─ python <本 skill 安装目录>/tools/init.py [project-path] [--genre <编号>] → 完成后 @novel-agent
└─ story.md 存在 → 已有项目
    ├─ story.md 含 length: short → 短篇项目 → @short-agent 继续写作(不进卷纲/章纲流程)
    ├─ 检查同步新鲜度
    │   ├─ python <本 skill 安装目录>/tools/sync-project.py . --check → exit 0 → 已最新,略过
    │   ├─ python <本 skill 安装目录>/tools/sync-project.py . --check → exit 1 → 有更新
    │   │   └─ 展示变更文件,询问作者是否同步
    │   │       ├─ 确认 → 运行 python <本 skill 安装目录>/tools/sync-project.py .
    │   │       └─ 跳过 → 继续
    │   └─ .agent/.sync-fingerprint 不存在(首次)
    │       └─ 静默运行 python <本 skill 安装目录>/tools/sync-project.py . → 写入指纹
    └─ → @novel-agent 继续写作
```

### 短篇分支(length: short)

作者在项目目录表达短篇意图时走本分支:

```
短篇意图 + story.md 不存在 → 询问是否创建【短篇】项目 → 确认后执行
│   python <本 skill 安装目录>/tools/init.py [project-path] --length short → 完成后 @short-agent
└─ story.md 存在且含 length: short → @short-agent 继续写作
```

- 短篇项目与长篇项目的目录、流程、agent 组完全独立(`stories/{slug}/` 篇目制,无卷纲/章纲/提示词)
- 短篇流程:定情绪 →(作者确认)→ 构思排纲 →(作者确认)→ 契约组装 → 契约审计 → 分批写作 → 去AI味精修 → 兑现度核对 → 验收交付 →(改稿或下一篇)
- 长篇项目(story.md 无 length: short)里作者想写短篇 → 提示另建短篇项目目录,不混用
- **可选工具(不进调度链,作者主动触发)**:作者说「扫个榜 / 看看什么火」进入 `short-scan`(市场选题);说「拆这篇 / 分析这篇爆款」进入 `short-analyze`(对标拆解,产出 `analysis/{书名}/` 供写作阶段召回)——两个工具的 SOP 在平台 skills 目录下,按各自 SOP 执行,不写 order、不占 phase

**强制规则:**
- `story.md` 不存在时,**先询问作者**是否要在此目录创建小说项目,确认后再运行 `init.py`
- 禁止未经确认直接执行 `init.py`
- 确认后必须运行 `init.py`,禁止手动创建目录结构替代
- **禁止在 skill 安装目录(含 `skills/awesome-novel` 路径)内运行 `init.py`** — 此目录是技能仓库,不是小说项目
- 如果当前目录是 skill 安装目录,应提示作者切换到目标目录后再执行
- `init.py` 执行完毕后,确认 `.agent/status.md` 与平台部署目录已生成(Claude Code → `.claude/agents/`;OpenCode → `.opencode/agents/`;Reasonix → `.reasonix/skills/`;Codex → `.codex/agents/`;ZCode → `.zcode/skills/`;dsh → `.dsh/skills/`;Grok Build → `.grok/agents/`),方可进入 novel-agent
- 如果 `init.py` 报错,必须先修复问题重新执行,不允许绕过

## 初始化 — 先询问,确认后执行,不可跳过

全新项目先询问作者是否初始化,确认后运行 `init.py`(项目路径可选,默认当前目录):
```
python <本 skill 安装目录>/tools/init.py [project-path] [--genre <编号>]
```

`<本 skill 安装目录>` 即本 SKILL.md 所在目录(如 `~/.claude/skills/awesome-novel/`、`~/.config/opencode/skills/awesome-novel/`、`~/.codex/skills/awesome-novel/`、`~/.zcode/skills/awesome-novel/`、`~/.dsh/skills/awesome-novel/`、`~/.grok/skills/awesome-novel/`)。AI 用绝对路径调用,避免在项目目录找不到 `tools/init.py`。

**禁止以任何理由跳过 init.py:** 手动创建目录、复制模板、直接调用 agent 都属于违规行为。`init.py` 是初始化入口,必须执行且完整运行。

`init.py` 会:
1. 选题材
2. 创建项目骨架(settings/、volumes/、chapters/、prompts/、archives/)
3. 部署 agent/skill 到当前平台约定目录(Claude Code → `.claude/agents/`;OpenCode → `.opencode/agents/`;Reasonix / ZCode / dsh 不部署 agents,agents 即 `.reasonix/skills/` / `.zcode/skills/` / `.dsh/skills/`;Codex → `.codex/agents/*.toml`;Grok Build → `.grok/agents/*.md`)
4. 按题材继承反 AI 规则和文风偏好到平台 knowledge 目录(`.claude/knowledge/` / `.opencode/knowledge/` / `.reasonix/knowledge/` / `.codex/knowledge/` / `.zcode/knowledge/` / `.dsh/knowledge/` / `.grok/knowledge/`)
5. 按题材继承格式规范、题材案例到平台 knowledge 目录
6. 创建空白的写作记忆文件(平台 memory 目录)
7. 创建永久记忆占位文件(平台 knowledge 目录)
8. 生成 CLAUDE.md(OpenCode / Reasonix 下同时生成 AGENTS.md)
9. 初始化状态文件 `.agent/status.md`

以上 9 步全部由 `init.py` 自动完成,AI 无需也不应手动干预。

**检查:** 运行后确认 `.agent/status.md` 存在且内容正确,方可进入 `@novel-agent`。

## 设定讨论 — novel-agent 与作者讨论后,由 updater 写入

`init.py` 完成后进入 `@novel-agent`,此时 `phase=setup`,按以下流程:

1. **novel-agent 检测到 setup 阶段**,与作者逐项讨论设定(世界观/角色/风格/题材)。如果作者需要帮忙取书名,参考 `knowledge/title-craft/index.md` 的方法论给出建议
2. 讨论完毕后,novel-agent **写 order 文件** `.agent/task/setting-update-order.md`
3. novel-agent 通过 **Agent 工具调用 updater**
4. **updater 读取 order**,写入 `settings/world-setting.md`、`settings/genre-setting.md`、`settings/character-setting/*.md` 等设定文件
5. updater 将 order 覆盖为 `status: DONE` 并结束
6. **novel-agent 确认 order 标记 DONE**(只代表写入完成),展示已写入的设定摘要给作者确认:文件清单(对照 order 的 outputs 逐项列出)+ 世界观/题材/角色/文风要点,参照 `docs/tutorial.md` 3.8 完成报告样式,面向作者用日常语言,结尾话术:"设定已写入 settings/。哪里不对直接说;没问题就说'可以',我开始规划卷纲。"
7. **作者明确确认("可以/没问题/就这样";或说"之前已确认过")→ 才可推进 phase → outline**,进入卷纲规划。作者要求修改 → nove

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

ข้อมูลจาก GitHub

ดาว GitHub
870
ผู้ทำ
modoojunko
license
AGPL-3.0
แก้โค้ดล่าสุด
25 ก.ย. 2569
ไฟล์ SKILL.md ใน repo (นับรวมสำเนาภาษาอื่นและแม่แบบ)
1
topic
agent-skill, ai-fiction, ai-novel, ai-skill, claude-code, hermes, novel-generator, novel-writing, story-generation, story-writing