awesome-novel-agent Skill
ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ไฟล์คำสั่งให้ AI อ่าน ไม่ต่อบริการใด
- บัญชีหรือคีย์ ไม่ต้องใส่คีย์
- หมวด เขียนโค้ด
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
让 AI agent成为你的小说创作搭档。从世界观搭建到角色塑造,从章节规划到正文写作,一步步陪你完成整部小说。สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/skills/modoojunko-awesome-novel-agent)ใช้คู่กับ
MCP ที่ต่อ AI เข้ากับบริการในงานเดียวกัน
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Skill ที่ทำงานคล้ายกัน
หมวดงานเดียวกัน เรียงแบบเดียวกับหน้ารายการ Skill
| ตัวนี้ awesome-novel-agent | rea | graphify | archify | security-audit-skill | |
|---|---|---|---|---|---|
| ผู้ทำ | modoojunko | morluto | Graphify-Labs | tt-a1i | cloudflare |
| จำนวน Skill | 1 | 1 | 1 | 1 | 1 |
| ดาว GitHub | 870 | 461,751 | 148,352 | 96,757 | 73,156 |
| แก้โค้ดล่าสุด | 25 ก.ย. 2569 | 16 พ.ย. 2569 | 16 พ.ย. 2569 | 15 พ.ย. 2569 | 15 ก.ย. 2569 |
| สัญญาอนุญาต | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
ชุดคำสั่ง (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 (เว็บและแอป)
ดาวน์โหลดจาก GitHub
Skill นี้ใช้ใบอนุญาต AGPL-3.0 ซึ่งไม่อยู่ในรายการที่เราแจกต่อ เราจึงไม่แจกไฟล์ ZIP จากเว็บเรา ดาวน์โหลดจาก GitHub แล้วจัดโฟลเดอร์เอง หรือใช้ทาง "ให้ AI ติดตั้งให้" ด้านบนซึ่งง่ายกว่า
ดาวน์โหลดจาก GitHub (ทั้ง repo) ↗
แตกไฟล์ แล้วบีบอัดเฉพาะโฟลเดอร์ awesome-novel-agent ใหม่ ZIP ต้องมีโฟลเดอร์ awesome-novel ที่มี SKILL.md อยู่ชั้นบนสุด ห้ามวางไฟล์หลวมไว้ชั้นบนสุด
เปิดหน้า Skills ใน claude.ai แล้วอัปโหลด
+Create skillUpload a skillเลือกไฟล์ awesome-novel.zip
ไม่เห็นปุ่ม 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 จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.claude/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด 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 จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ 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 จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Codex ใหม่ แล้วสั่งงานที่ตรงเรื่อง Codex จะเห็น skill นี้ในรายการ
ทางที่ 1ให้ Cursor ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Cursor
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก awesome-novel-agent
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: cursor.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.cursor/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ใน 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 ไปวาง
ตรวจโฟลเดอร์ 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