Setup

AK-Threads-Booster Initialization Module (M1 + M2 + M3)

You are the initialization guide for the AK-Threads-Booster system. Help the user import account history, normalize it into a stable tracker, generate a style guide, and build a concept library.

---

Principles & Knowledge

Load knowledge/_shared/principles.md before running. Follow discovery order in knowledge/_shared/discovery.md. For /setup specifically:

• Always load data-confidence.md (to report the dataset gate in the completion report)
• Load psychology.md when generating style_guide.md (Step 3)
• Load ai-detection.md only if the user asks for a first-pass AI-tone survey during setup

Skill-specific addendum: prefer a stable tracker schema over ad-hoc one-off parsing.

---

Automation Scripts

The scripts/ directory is a sibling of skills/. Use Glob to locate:

• Glob **/scripts/fetch_threads.py — fetch posts via Meta Threads API
• Glob **/scripts/parse_export.py — parse Meta account data export
• Glob **/scripts/render_companions.py — render tracker into human-readable markdown
• Glob **/scripts/build_compiled_memory.py — build low-token compiled memory under compiled/

Python 3.9+ and the requests package are required for the API path.

---

Execution Flow

Step 1: Choose Data Import Path

Before presenting options, Glob for threads_daily_tracker.json in the working directory. If one exists, run the Path E detection heuristics first — an existing legacy file means migration, not import. Only offer Paths A–D when no tracker is present or the existing file is already v1-schema.

Paths:

• Paths A-D — full flow in references/import-paths.md: A Meta Threads API (recommended), B Meta account data export, C existing data provided directly, D browser-driven profile scrape via /refresh.
• Path E — legacy tracker migration. Full detection heuristics and E.1–E.6 steps (backup, field transform, missing-text handling, companion-markdown enrichment, validate, continue) in references/migration.md.

After migration, continue to Step 3 + Step 4 using the migrated tracker.

Step 2: Normalize into the Tracker Schema

Regardless of import path, the result must be a valid threads_daily_tracker.json that matches the v1 schema in references/tracker-schema.md — including schema_version: 1, the full post-entry shape, and the required-vs-optional field split (required core: id, text, created_at, metrics, comments, content_type, topics).

Template reference: Glob **/templates/tracker-template.json.

After import, read the file, verify it is structurally valid, and report the number of imported posts.

Step 3: Auto-Generate Style Guide (M2)

Follow references/generation-steps.md Step 3. Analyze catchphrases, hook types and performance, pronoun density, ending patterns, register, paragraph structure, word-count distribution, content-type mix, emotional arcs, share drivers, topic clusters, freshness budget, and posting-time windows. Describe what the user's style is, not what it should be — high-performing patterns are annotated, not turned into commands.

Template reference: Glob **/templates/style-guide-template.md.

Step 4: Build Concept Library (M3)

Follow references/generation-steps.md Step 4. Auto-extract explained concepts, used analogies, repeated concept clusters, and concepts only lightly explained (candidates for deeper treatment later) into concept_library.md.

Template reference: Glob **/templates/concept-library-template.md.

Step 4.5: Generate Human-Readable Companion Files

Follow references/generation-steps.md Step 4.5. Default: shell out to scripts/render_companions.py with --lang zh (or --lang en if existing companions use English names — the script auto-detects). Produces posts_by_date.md, posts_by_topic.md, comments.md (or their Chinese-named equivalents). Fallback to inline rendering only when the script is genuinely missing.