mosage 0.1.0 → 0.8.0

package/template/book/book.yaml

@@ -1,42 +0,0 @@
-# ─────────────────────────────────────────────────────────────
-# 這本書的設定
-# 通常由 AI 在「立項訪談」時幫你填好；你也可以直接修改。
-# 沒寫的欄位會沿用專案根目錄 mosage.yaml 的設定。
-# ─────────────────────────────────────────────────────────────
-
-# 類型：book（書）、thesis（論文）、other（其他長篇寫作）
-type: book
-
-# 目前階段：kickoff（立項）→ outline（大綱）→ writing（撰寫）→ revising（修訂）→ done（完稿）
-stage: kickoff
-
-title: ""
-subtitle: ""
-# author: ""           # 不填則使用 mosage.yaml 的 author
-
-# 目標字數（中文字 + 英文單字），用來顯示進度；0 表示不設定
-targetWords: 0
-
-# 章節順序：列出 chapters/ 資料夾裡的檔名。
-# 沒有列在這裡的檔案會顯示為「未排入目錄的草稿」，不會匯出。
-chapters: []
-
-# ai:
-#   editMode: suggest   # 覆寫專案設定：suggest（修改建議）或 direct（直接修改）
-
-# Word 匯出設定（沒寫的欄位依類型套用預設值：
-# 書 — 新細明體 12pt、1.5 倍行距；論文 — 標楷體 12pt、左邊界 3 公分）
-export:
-  pageSize: A4 # A4 | A5 | B5 | Letter，或 { width: 170, height: 230 }（公釐）
-  # fontSize: 12         # 內文字級（pt）
-  # lineSpacing: 1.5     # 行距（倍數）
-  # firstLineIndent: 2   # 段落首行縮排（字元數）
-  # fonts:
-  #   body: 新細明體      # 中文內文字型
-  #   latin: Times New Roman
-  #   heading: 微軟正黑體
-  #   code: Consolas
-  # margins: { top: 25, bottom: 25, left: 25, right: 25 } # 公釐
-  # titlePage: true      # 書名頁
-  # toc: true            # 目錄（在 Word 開啟時自動更新頁碼）
-  # header: title        # 頁首：none | title（書名）| chapter（章名）

package/template/book/brief.md

@@ -1,6 +0,0 @@
-# 寫作企劃
-
-（尚未進行立項訪談）
-
-> 用 Claude Code 或 Codex 開啟專案資料夾，對 AI 說「開始」或輸入 `/kickoff`，
-> AI 會訪談你的寫作目的、讀者與風格，然後把結果寫在這裡。

package/template/book/notes/README.md

@@ -1,7 +0,0 @@
-# notes/ — 這本書的素材區
-
-把這本書會用到的東西放在這裡：研究資料、訪談逐字稿、讀書筆記、參考文獻、舊稿片段、靈感……
-
-- AI 撰寫與審稿時會參考這些檔案。
-- 這裡的內容**不會**匯出到 Word。
-- 所有書共用的素材（例如作者簡介）請放在專案根目錄的 `notes/`。

package/template/project/AGENTS.md

@@ -1,82 +0,0 @@
-# MoSage 寫作專案 — AI 協作守則
-
-這個資料夾是一個 **MoSage 寫作專案**，裡面可以有很多本書或論文，每一本放在 `books/<代號>/`。
-你（AI）是作者的共同寫作夥伴：協助立項、訂書名與大綱、起草、審稿與修訂 —— 但**作者擁有最後決定權**。
-
-作者會在瀏覽器裡的 MoSage 介面（`npm run dev` → http://localhost:5280）閱讀成果、編排大綱、
-選取文字留言給你，以及接受或拒絕你的修改建議。你改檔案時，介面會即時更新。
-
-## 每次對話開始：先搞清楚現況
-
-1. 執行 `npx mosage status` 看有哪些書、各在哪個階段（加 `--json` 取得完整資料）。
-2. 判斷作者現在要處理哪一本書：
-   - 作者有指名 → 就是那本。
-   - 作者說「這本」「這章」「這段」→ 讀 `.mosage/current.json`（見 `current-position` skill）。
-   - 只有一本書 → 就是那本。
-   - 還是不確定 → 列出書名問作者。
-3. 依那本書 `book.yaml` 的 `stage` 決定要做什麼：
-
-| 狀況 | 你該做的事 |
-| --- | --- |
-| `books/` 是空的（全新專案） | **主動**使用 `kickoff` skill 開始立項訪談 —— 即使作者只說了「嗨」或「開始」。 |
-| 作者想寫新的書／論文 | `kickoff`（它會用 `npx mosage new` 建立新書） |
-| `stage: kickoff`，或 `brief.md` 還是「尚未進行立項訪談」 | `kickoff` |
-| `stage: outline` | `outline`：書名、架構、章節骨架，請作者在介面「大綱」頁編排 |
-| `stage: writing` | 依作者指示 `write-chapter`；作者留了言就 `apply-comments` |
-| `stage: revising` | `review`、`apply-comments` |
-| `stage: done` | 協助最後檢查與匯出（`npx mosage export <書> docx`） |
-
-作者隨時可以回頭調整（例如寫到一半想改大綱）——照做，並更新 `stage`。
-
-## 專案結構
-
-```
-mosage.yaml              專案預設值（作者、AI 修改模式、共用匯出格式）
-notes/                   所有書共用的素材（author.md 作者簡介…）
-books/<代號>/
-  book.yaml              這本書的設定：類型、階段、書名、章節順序、Word 匯出格式
-  brief.md               寫作企劃：目的、讀者、核心主張、篇幅（立項時建立）
-  STYLE.md               風格指南：語氣、人稱、用語、標點、引用格式
-  chapters/NN-名稱.md     每章一個 Markdown 檔
-  assets/                圖片
-  notes/                 這本書的素材（不會匯出）
-output/<代號>/            匯出的 Word / HTML 檔
-.mosage/                 介面狀態與自動版本紀錄（不要手動修改）
-```
-
-## 必須遵守
-
-1. **動筆前先讀** 這本書的 `brief.md` 和 `STYLE.md`，以及 `notes/author.md`（如果有）。
-2. **只在寫作檔案裡工作**：`books/`、`notes/`、`mosage.yaml`。不要改 `package.json`、`.agents/`、`.claude/`、`.mosage/`。
-3. 章節檔格式與標記語法以 `mosage-reference` skill 為準。每章只有一個 `# 章名`。
-4. **修改作者已經寫好的文字**時，依設定的 `ai.editMode`（book.yaml 覆寫 mosage.yaml，預設 `suggest`）：
-   - `suggest` → 不直接改原文，用 `<!-- mosage:suggest … -->` 標記提出修改，作者在介面上按「接受」才生效。
-   - `direct` → 直接修改（系統會自動保留版本紀錄）。
-   - 空白章節、只有大綱要點的地方，以及作者明確叫你寫的新段落，可以直接寫。
-5. **不捏造**事實、數據、引文、案例與參考文獻。需要資料時，在該段落上方留下
-   `<!-- mosage:comment by=ai … -->` 請作者補充。
-6. 不要刪除你沒處理的標記（`mosage:comment`、`mosage:suggest`）。
-7. 預設使用台灣繁體中文與全形標點（，。「」『』、；：？！——……），除非 STYLE.md 另有規定。
-8. 不要重排或重新換行你沒修改的段落 —— 保持版本差異乾淨，作者才看得出你改了什麼。
-9. 每完成一個段落或小節就存檔，作者會在介面上即時看到進度。
-
-## Skills
-
-| Skill | 用途 |
-| --- | --- |
-| `kickoff` | 立項訪談：寫作目的、類型、讀者、風格、篇幅 → 建立新書、`brief.md`、`STYLE.md` |
-| `outline` | 書名候選、章節架構方案 → 建立章節骨架，請作者在介面編排 |
-| `write-chapter` | 撰寫、續寫、擴寫章節 |
-| `apply-comments` | 處理作者在介面上留給你的留言 |
-| `review` | 以編輯角度審稿，留下 AI 留言與修改建議（不直接改稿） |
-| `current-position` | 解讀「這一章」「這一段」—— 作者目前在介面上看的位置 |
-| `mosage-reference` | 技術參考：檔案格式、標記語法、Markdown 支援範圍、指令 |
-
-## 指令
-
-```bash
-npx mosage status [書] [--json]         # 書架／某本書的狀態、字數、待處理標記
-npx mosage new <代號> --title <書名> --type book|thesis   # 建立新書
-npx mosage export <書> [docx|html|md]   # 匯出到 output/<書>/
-npx mosage import <檔案.docx|.md> [--book <代號>]          # 匯入既有稿件
-```

package/template/project/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/template/project/README.md

@@ -1,48 +0,0 @@
-# 我的寫作專案
-
-這是一個 [MoSage](https://github.com/nickchen1998/MoSage) 寫作專案：和 AI 一起寫書、寫論文，
-在瀏覽器裡閱讀、留言、編排，最後一鍵輸出成 Word。一個專案可以放很多本書。
-
-## 開始
-
-```bash
-npm run dev        # 開啟寫作介面 → http://localhost:5280
-```
-
-另開一個終端機，在這個資料夾啟動你的 AI 工具：
-
-```bash
-claude             # Claude Code
-codex              # 或 OpenAI Codex
-```
-
-對 AI 說「**開始**」（Claude Code 也可以輸入 `/kickoff`）。AI 會：
-
-1. **立項訪談** —— 問你寫作目的、類型（書／論文）、讀者、風格、篇幅與既有素材
-2. **書名與大綱** —— 提出書名候選與幾種章節架構，建立章節骨架
-3. 你在介面的「**大綱**」頁拖曳調整章節、修改章名與摘要
-4. **撰寫** —— 「寫第一章」，AI 寫，你在介面上即時看到
-5. **修訂** —— 在介面上選取文字留言給 AI，再對 AI 說「處理留言」；
-   AI 的修改會以「修改建議」出現，你按「接受」或「拒絕」
-6. **匯出** —— 介面右上角「匯出 Word」，或 `npx mosage export <書> docx`
-
-想再寫一本？對 AI 說「我想寫一本新書」就好。
-
-## 常用指令
-
-| 指令 | 說明 |
-| --- | --- |
-| `npm run dev` | 開啟寫作介面 |
-| `npx mosage status` | 所有書的進度；`npx mosage status <書>` 看單本細節 |
-| `npx mosage new <代號>` | 建立一本新書（通常由 AI 幫你執行） |
-| `npx mosage export <書> docx` | 匯出 Word 到 `output/<書>/` |
-| `npx mosage import 舊稿.docx` | 把既有的 Word 稿匯入成一本新書（依標題切章節） |
-
-## 資料夾
-
-- `books/<代號>/` —— 每本書：`book.yaml` 設定、`brief.md` 寫作企劃、`STYLE.md` 風格指南、`chapters/` 章節
-- `notes/` —— 所有書共用的素材
-- `output/` —— 匯出的檔案
-- `.mosage/` —— 自動版本紀錄（每次 AI 或你修改前都會保存舊版，可在介面「版本紀錄」還原）
-
-所有內容都是純文字 Markdown，建議搭配 git 做版本管理。

package/template/project/gitignore

@@ -1,5 +0,0 @@
-node_modules
-.mosage
-output
-.DS_Store
-~$*.docx

package/template/project/mosage.yaml

@@ -1,23 +0,0 @@
-# ─────────────────────────────────────────────────────────────
-# MoSage 專案設定
-# 一個專案可以放很多本書（books/ 底下每個資料夾就是一本書或一篇論文）。
-# 這裡的設定是所有書的預設值；每本書可以在自己的 book.yaml 覆寫。
-# ─────────────────────────────────────────────────────────────
-
-author: ""
-language: zh-TW
-
-# 書架的排列順序（books/ 底下的資料夾名稱）；沒列到的排在後面
-books: []
-
-ai:
-  # AI 修改「已經寫好的文字」時的方式：
-  #   suggest — 以修改建議呈現，你在介面上按「接受」才會生效（建議使用）
-  #   direct  — 直接修改檔案（仍會自動保留版本紀錄）
-  editMode: suggest
-
-# 所有書共用的 Word 匯出設定（例如統一字型），每本書的 book.yaml 可以再覆寫
-export: {}
-#  fonts:
-#    body: 新細明體
-#    latin: Times New Roman

package/template/project/notes/README.md

@@ -1,8 +0,0 @@
-# notes/ — 共用素材區
-
-這裡放**所有書都會用到**的素材，例如：
-
-- `author.md` — 作者簡介、專業背景、寫作習慣（AI 立項訪談時會幫你建立，之後的新書就不用重問）
-- 共用的研究資料、參考文獻清單
-
-某一本書專用的素材，請放在 `books/<書>/notes/`。這裡的內容不會匯出到 Word。

package/template/project/package.json

@@ -1,14 +0,0 @@
-{
-  "name": "my-writing",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "mosage dev",
-    "status": "mosage status",
-    "new": "mosage new",
-    "export": "mosage export",
-    "import": "mosage import"
-  },
-  "devDependencies": {}
-}