setup

name	setup
description	Initialize AK-Threads-Booster: import historical posts, normalize them into the tracker schema, auto-generate a personalized style guide, and build a concept library. Run on first use or whenever the user wants to backfill account history.
version	2.0.0
allowed-tools	Read, Write, Edit, Bash, Glob, Grep, WebFetch

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.

Step 4.6: Generate Low-Token Compiled Memory

Run scripts/build_compiled_memory.py --tracker ./threads_daily_tracker.json after the tracker and companion files exist. This produces compiled/account_wiki.md, compiled/account_state.md, compiled/personal_signal_memory.md, compiled/next_move_queue.md, compiled/post_feature_index.jsonl, compiled/cluster_wiki.json, compiled/exemplar_bank.md, and compiled/recent_window.md.

Compiled memory is a derived runtime cache, not a new source of truth. If the script is missing or fails, setup still succeeds; report that downstream skills will use tracker-only fallback until compiled memory is built.

Step 5: Completion Report

Report:

1. How many posts were imported.
2. Which import path was used.
3. 2–3 strongest style findings.
4. How many concepts were indexed.
5. Whether the tracker is full-data or partial-data.
6. That /analyze, /predict, and /review can already run, even if some enriched fields are still null.
7. Whether compiled memory was built successfully or tracker-only fallback is active.
8. Proactively ask whether the user wants to enable weekly GitHub update checks for AK-Threads-Booster. Explain that it is opt-in, fast-forward only, and stops instead of overwriting local changes. If the user says yes, route to skills/update/SKILL.md to install the automation.

If post count is below 20, say the historical base is still limited.

If the user has API access, tell them they can later run scripts/update_snapshots.py on a schedule to keep metrics snapshots current.

Regardless of API access, tell them they can run scripts/update_topic_freshness.py to build semantic clusters and estimate topic freshness / fatigue from account history.

If they do not have API access, rely on /review checkpoints plus scripts/update_topic_freshness.py.

---

Handling Insufficient Data

Use the shared rubric at knowledge/data-confidence.md (Glob **/knowledge/data-confidence.md). Report the dataset-level gate in the completion report so the user knows whether downstream skills will run in Directional / Weak / Usable / Strong / Deep mode.

---

Output File Checklist

After setup, the user's working directory should contain:

1. threads_daily_tracker.json — canonical data (machine-readable)
2. style_guide.md
3. concept_library.md
4. posts_by_date.md (or 歷史貼文-按時間排序.md) — human-readable post archive
5. posts_by_topic.md (or 歷史貼文-按主題分類.md) — topic-grouped index
6. comments.md (or 留言記錄.md) — flat comment log
7. compiled/ — low-token runtime cache generated from the tracker