Flatten skill category directory structure

2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -0,0 +1,86 @@
+# Phase 0: Import Book
+
+## Workflow
+
+1. Ask the user to provide a book file (supports .txt / .md / .pdf / .epub)
+2. Read file contents:
+   - `.txt` / `.md`: Read directly
+   - `.pdf`: Use the `Read` tool (supports PDF reading)
+   - `.epub`: Use `Bash` tool to run Python parsing (see below)
+3. Save parsed plain text to `source/book.txt`
+4. Confirm with the user that content was read correctly (show a preview of the first few hundred characters)
+
+## State File
+
+After import, write `.audiobook-state.json` using Python `json.dumps()`.
+
+**`skillScriptsPath` must be the real absolute path** — not a placeholder. Derive it from the `available_skills` list visible in your system context:
+
+- Find the `<location>` entry for the audiobook skill, e.g.:
+  `file:///Users/alice/.hub/skills/audiobook/SKILL.md`
+- Strip `file://` and `/SKILL.md`, then append `/scripts`:
+  → `/Users/alice/.hub/skills/audiobook/scripts`
+
+That string is your `skill_scripts_path`. Use it literally — do not guess or reconstruct from memory.
+
+```python
+import json, os, sys
+from pathlib import Path
+
+# Replace the string below with the path you derived above — do this BEFORE running the script.
+# Example: "/Users/alice/.hub/skills/audiobook/scripts"
+skill_scripts_path = "/FILL_IN_BEFORE_RUNNING/audiobook/scripts"
+
+# Verify the path exists before continuing
+if not Path(skill_scripts_path).is_dir():
+    print(f"ERROR: skillScriptsPath does not exist: {skill_scripts_path}", file=sys.stderr)
+    sys.exit(1)
+
+# Locate the state file (project-relative, not skill-relative)
+audiobook_root = Path(os.getcwd()) / ".audiobook"
+book_dir = audiobook_root / "<book_name>"
+book_dir.mkdir(parents=True, exist_ok=True)
+
+state = {
+    "currentStep": "parse",
+    "bookName": "<book_name>",
+    "sourceFile": "source/book.txt",
+    "skillScriptsPath": skill_scripts_path,
+    "totalChapters": 0,
+    "characters": [],
+    "voiceMapping": {
+        "narrator": {"voiceId": None, "speed": 0.9},
+        "characters": {}
+    },
+    "chaptersCompleted": [],
+    "currentChapter": 0
+}
+(book_dir / ".audiobook-state.json").write_text(json.dumps(state, ensure_ascii=False, indent=2))
+print(f"State file written. skillScriptsPath={skill_scripts_path}")
+```
+
+**Before running**: replace `skill_scripts_path` with the actual value derived above. The `print` at the end confirms what was written.
+
+## EPUB Parsing
+
+```python
+import zipfile
+from html.parser import HTMLParser
+
+class TextExtractor(HTMLParser):
+    def __init__(self):
+        super().__init__()
+        self.text = []
+        self.skip = False
+    def handle_starttag(self, tag, attrs):
+        if tag in ('script', 'style'):
+            self.skip = True
+    def handle_endtag(self, tag):
+        if tag in ('script', 'style'):
+            self.skip = False
+        if tag in ('p', 'div', 'br', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6'):
+            self.text.append('\n')
+    def handle_data(self, data):
+        if not self.skip:
+            self.text.append(data)
+```