autocrew 0.1.0

package/skills/write-script/SKILL.md

@@ -0,0 +1,232 @@
+---
+name: write-script
+description: |
+  Write one complete content draft for Chinese social media. Activate when user asks to write a post, create content, draft an article, or produce copy. This is the executor — it does the actual writing.
+---
+
+# Write Script
+
+> Executor skill. Single responsibility: generate one complete original script and save it.
+
+## Prerequisites
+
+Before writing, load these reference documents:
+- `HAMLETDEER.md` — Content philosophy, HKRR framework, Clock Theory, Micro-Retention Techniques
+- `skills/title-craft/SKILL.md` — Title methodology (8 types + quality checklist)
+
+For video scripts: apply the **Clock Theory** from HAMLETDEER.md. Map the script to clock positions (12/3/6/9) and ensure every position has a bang moment. Short-form video: pick ONE HKRR element and commit. Long-form: combine all four.
+
+## Steps
+
+1. **Load style & memory context:**
+
+   a. Read `~/.autocrew/STYLE.md` — absorb brand voice, personality, boundaries.
+   b. Read `~/.autocrew/MEMORY.md` — check for writing preferences, past feedback, audience persona.
+   c. Read `~/.autocrew/creator-profile.json` — check `styleCalibrated`, `platforms`, `writingRules`, `contentPillars`.
+   d. If none exist, proceed with sensible defaults and note that style calibration is recommended.
+
+2. **Content positioning check:**
+
+   a. Identify which **content pillar** this content belongs to (from `creator-profile.json` → `contentPillars`).
+   b. If no pillar match, ask the user: "这条内容属于你的哪个内容支柱？" and list available pillars.
+   c. Load the pillar's `targetPersona`, `toneGuide`, and `exampleAngles` as writing context.
+   d. If `contentPillars` is not configured, skip this step and note that content positioning is recommended.
+
+3. **Traffic hypothesis (MANDATORY):**
+
+   Before writing, state the hypothesis for this content:
+   - "I believe [this angle/hook/format] will [expected outcome] because [reason]"
+   - Classify: `title_test` / `hook_test` / `format_test` / `angle_test`
+   - If testing against a previous content, note the `controlRef` (content ID being compared to)
+
+   If the user doesn't provide a hypothesis, infer one from the topic and state it explicitly.
+
+4. If a topic was specified, load its details via `autocrew_topic` action="list" and find the matching topic.
+
+5. **Check for relevant teardowns:**
+
+   Search `~/.autocrew/data/pipeline/intel/_teardowns/` for teardown reports related to this topic. If found, use them as reference for what works in this space.
+
+6. **Write the script:**
+
+   a. **Hook** — pick the ONE strongest type for this topic:
+
+   | Type | When to use | Example pattern |
+   |------|-------------|-----------------|
+   | Pain point | Audience has an obvious unresolved frustration | "XX最大的问题不是YY，而是ZZ" |
+   | Suspense | Topic has a counterintuitive truth or surprising data | "我花了X万测试，结果发现…" |
+   | Ideal state | Topic sells a desirable outcome | "X个月后，我再也不用YY了" |
+   | Emotional resonance | Topic touches identity, belonging, or aspiration | "每个做XX的人都经历过这一刻" |
+   | Contrast | Clear gap between common belief and reality | "别人XX，你却在YY" |
+
+   Write 1-3 sentences. NEVER open with "哈喽大家好", "你有没有想过", or any generic greeting.
+
+   b. **Body** — the core content. NOT a list of points. A conversation.
+
+   **Writing rules (non-negotiable):**
+   - Write like you're talking to ONE person sitting across from you, not lecturing to a crowd.
+   - Vary sentence length deliberately: 3-4 short sentences, then one longer one. Then a one-word sentence. "真的。"
+   - Each claim needs: why it's true + concrete example (named, specific, verifiable when possible).
+   - Total body: 800-1500 characters (text) or platform-specific limit.
+
+   **Anti-patterns (NEVER do these):**
+   - ❌ "总而言之" / "综上所述" / "值得一提的是" — essay transitions that kill conversational tone
+   - ❌ "首先…其次…最后…" — numbered structure that screams AI/lecture
+   - ❌ Balanced "一方面…另一方面…" hedging — pick a side
+   - ❌ Lists of exactly 5 items — AI signature pattern
+   - ❌ Every paragraph same length — real people write unevenly
+   - ❌ Generic examples ("某个企业", "一家公司") — name it or don't use it
+
+   **Must-include elements:**
+   - 1-2 expectation-breaking twists (contrarian flip, data bomb)
+   - 1-2 interaction hooks (questions, "你猜怎么着", comment prompts)
+   - HKRR annotation: for each section, note which HKRR element is active (in your planning, not in output)
+
+   **Micro-retention techniques (use at least 2):**
+   - **Open Loop**: raise a question early, resolve it later — "后面告诉你为什么"
+   - **Curiosity Gap**: end paragraphs with forward momentum — "但这还不是最离谱的"
+   - **Visual Anchor**: standalone one-liner between paragraphs — a quotable insight
+   - **Rhythm Break**: sudden short sentence after buildup — "错。" / "但这不重要。"
+
+   c. **Comment triggers (MANDATORY — annotate 1-2):**
+
+   After writing the body, identify and annotate comment trigger points:
+
+   | Type | What it does | Example |
+   |------|-------------|---------|
+   | Controversy plant | Leave a debatable opinion | "我知道很多人不同意，但我觉得XX根本没用" |
+   | Unanswered question | Raise but don't fully answer | "至于为什么大厂不这么做？评论区聊" |
+   | Quote hook | One sentence worth screenshotting | "AI不是来替你干活的，是来替你做决定的" |
+
+   Record as: `commentTriggers: [{ type: "controversy", position: "paragraph 3" }]`
+
+   d. **CTA** — 1-2 sentences guiding a specific action (save/comment/follow).
+   Must connect to the content's value — "收藏这条，下次用得上" beats "觉得有用就点赞".
+
+   e. **Title — generate 3-5 candidates using title formulas:**
+
+   | Formula | Pattern | Example |
+   |---------|---------|---------|
+   | Number + Result | 数字+具体结果 | "用了3个月AI，我把团队从12人砍到3人" |
+   | Contrarian | 反直觉声明 | "AI写的代码比人快10倍，但我劝你别用" |
+   | Identity + Pain | 身份标签+痛点 | "传统老板看过来：这3种AI项目100%是坑" |
+   | Curiosity Gap | 悬念缺口 | "花了20万做AI系统，结果…" |
+   | Contrast | 对比结构 | "别人用AI赚钱，你用AI亏钱，差在哪？" |
+   | Resonance Question | 共鸣提问 | "为什么你学了那么多AI课，还是不会用？" |
+
+   Rules:
+   - Generate 3-5 candidates, annotate which formula each uses.
+   - Also call `generateForPlatform(baseTopic, platform)` from title-hashtag.ts for additional variants.
+   - Pick the best as primary. 15-25 characters. Can include emoji if it adds value.
+   - If `web_search` is available, search 2-3 trending keywords and embed 1 naturally.
+
+   f. **Hashtags** — generate platform-specific hashtags:
+   - Call `generateHashtags(topic, platform, tags)` from `title-hashtag.ts`.
+   - Append hashtags to the body (for platforms that use inline hashtags like XHS/Douyin).
+   - Save hashtags separately in the `hashtags` field.
+
+   g. **Clock mapping (video content):**
+   Before finalizing, map the script to clock positions:
+
+   | Clock | Content section | Bang moment type | HKRR element |
+   |-------|----------------|-----------------|-------------|
+   | 12:00 | [your hook] | [e.g., pattern break] | [e.g., Resonance] |
+   | 3:00 | [paragraph X] | [e.g., data bomb] | [e.g., Knowledge] |
+   | 6:00 | [paragraph Y] | [e.g., framework reveal] | [e.g., Knowledge] |
+   | 9:00 | [CTA section] | [e.g., audience mirror] | [e.g., Resonance] |
+
+7. **Self-review before saving** (fix any failure, don't just check):
+   - [ ] 800+ characters total?
+   - [ ] Contains at least 2 concrete examples or scenarios (not vague claims)?
+   - [ ] Has a non-obvious insight or twist?
+   - [ ] Tone matches STYLE.md profile (if available)?
+   - [ ] No generic greetings, no essay-style paragraphs?
+   - [ ] No anti-pattern violations (总而言之, 首先其次最后, balanced hedging)?
+   - [ ] Body is plain text with blank-line separators (no markdown headers)?
+   - [ ] Title within platform character limit? Uses a title formula?
+   - [ ] At least 1 comment trigger annotated?
+   - [ ] At least 2 micro-retention techniques used?
+   - [ ] Hypothesis stated?
+   - [ ] Content pillar specified (if pillars configured)?
+   - [ ] Hashtags generated and relevant?
+
+8. **Save via tool:**
+   ```json
+   {
+     "action": "save",
+     "title": "The single best title (no emoji in title field)",
+     "body": "Full script as plain text. Blank lines between sections.",
+     "platform": "xiaohongshu",
+     "topicId": "topic-xxx (if based on a topic)",
+     "tags": ["tag1", "tag2"],
+     "hashtags": ["#标签1", "#标签2"],
+     "status": "draft",
+     "hypothesis": "I believe [angle] will [outcome] because [reason]",
+     "experiment_type": "hook_test",
+     "content_pillar": "AI落地避坑",
+     "comment_triggers": [{"type": "controversy", "position": "paragraph 3"}]
+   }
+   ```
+
+   Note: Auto-humanize runs automatically inside the save tool. You do NOT need to call humanize separately.
+
+9. **Auto-review (MANDATORY — runs silently):**
+   - After saving, ALWAYS run content review:
+     ```json
+     { "action": "full_review", "content_id": "<saved-id>", "platform": "<platform>" }
+     ```
+   - If review passes → proceed to output.
+   - If review finds issues → auto-fix what can be fixed, then proceed to output.
+   - Do NOT ask the user "要审核吗?" — just do it.
+
+10. **Output to user:**
+    Show the complete draft in chat, including:
+    - Title (with 2-3 alternative variants + formula annotations)
+    - Content pillar tag
+    - Hypothesis
+    - Full body text
+    - Comment trigger annotations
+    - Micro-retention technique annotations
+    - Hashtags
+    - Clock mapping (for video)
+    - Review result summary (pass/issues found)
+    - **File location**:
+      > 📄 内容已保存到：`~/.autocrew/contents/{content-id}/draft.md`
+      > 打开方式：在终端执行 `open ~/.autocrew/contents/{content-id}/` 或用 Obsidian 打开 `~/.autocrew/` 文件夹
+    Then:
+    > 要修改的话直接说，或者确认后我帮你标记为待发布。
+
+11. **If adaptation is needed:**
+    - Do not just trim one draft for another platform.
+    - Use `platform-rewrite` / `autocrew_rewrite` to create the first platform-native version.
+
+## Platform-Specific Adjustments
+
+| Platform | Chars | Style notes |
+|----------|-------|-------------|
+| xiaohongshu | 300-1000 | Emoji-rich, casual, hashtags at end (5-15) |
+| douyin | Script format | [Scene] + [Voiceover] + [Text overlay], hook in 3s |
+| wechat_mp | 1500-3000 | Subheadings every 300-500 chars, more structured |
+| wechat_video | 300-800 | Educational tone, include text summary |
+| bilibili | 500-2000 | 年轻化表达，可以用梗，【】标注类型 |
+
+## Title & Hashtag Integration
+
+The `title-hashtag.ts` module provides:
+- `generateTitleVariants(topic, platform)` → 3-5 title variants with style labels
+- `generateHashtags(topic, platform, tags)` → deduplicated, platform-limited hashtags
+- `generateForPlatform(topic, platform)` → titles + hashtags + tips in one call
+
+Always use these for structured title/hashtag generation. The AI agent refines the output — these are starting points, not final answers.
+
+## Error Handling
+
+| Failure | Action |
+|---------|--------|
+| Style/Memory files missing | Write with sensible defaults. Suggest running style-calibration. |
+| Topic not found | Ask user for topic details directly. |
+| Save fails | Output the content in chat so user can copy it. Retry save once. |
+| Review fails to run | Save the draft anyway. Note that review was skipped. |
+| title-hashtag returns empty | Fall back to manual title + basic hashtags from tags. |
+| Content pillars not configured | Skip pillar check, suggest configuring pillars. |
+| No teardowns found | Skip reference step, write from scratch. |

package/skills/xhs-cover-review/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: xhs-cover-review
+description: |
+  小红书封面审核 skill。基于真实原型生成 A/B/C 三个不同结构候选，进入 review_pending，等用户选定后推进到 publish_ready。
+---
+
+# XHS Cover Review
+
+## Purpose
+
+Turn one saved draft into a structured Xiaohongshu cover approval flow.
+
+## Rules
+
+1. A / B / C must represent three different structural prototypes, not three color variants.
+2. At least one variant should come from same-track references.
+3. At least one variant should come from cross-track transfer.
+4. Approval is mandatory before publish-ready.
+5. Do not silently skip review and jump to publish.
+
+## Tool Usage
+
+Create candidates:
+
+```json
+{
+  "action": "create_candidates",
+  "content_id": "content-xxx"
+}
+```
+
+Approve one:
+
+```json
+{
+  "action": "approve",
+  "content_id": "content-xxx",
+  "label": "b"
+}
+```
+
+## Output
+
+Always report:
+
+- review status
+- the three prototype directions
+- which cover was approved

package/src/adapters/browser/browser-cdp.ts

@@ -0,0 +1,260 @@
+import type {
+  BrowserAdapter,
+  BrowserPlatform,
+  BrowserResearchQuery,
+  BrowserSessionStatus,
+  ResearchItem,
+} from "./types.js";
+
+const DEFAULT_PROXY_URL = process.env.AUTOCREW_CDP_PROXY_URL || "http://127.0.0.1:3456";
+
+type ProxyEvalResult = {
+  result?: { value?: unknown };
+  exceptionDetails?: unknown;
+};
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function buildPlatformUrl(platform: BrowserPlatform): string {
+  switch (platform) {
+    case "xiaohongshu":
+      return "https://www.xiaohongshu.com/";
+    case "douyin":
+      return "https://www.douyin.com/";
+    case "wechat_mp":
+      return "https://mp.weixin.qq.com/";
+    case "wechat_video":
+      return "https://channels.weixin.qq.com/platform/";
+    case "bilibili":
+      return "https://www.bilibili.com/";
+    default:
+      return "https://www.xiaohongshu.com/";
+  }
+}
+
+function buildSearchUrl(platform: BrowserPlatform, keyword: string): string {
+  const encoded = encodeURIComponent(keyword);
+  switch (platform) {
+    case "xiaohongshu":
+      return `https://www.xiaohongshu.com/search_result?keyword=${encoded}`;
+    case "douyin":
+      return `https://www.douyin.com/search/${encoded}?type=video`;
+    case "bilibili":
+      return `https://search.bilibili.com/all?keyword=${encoded}`;
+    case "wechat_mp":
+      return `https://weixin.sogou.com/weixin?type=2&query=${encoded}`;
+    case "wechat_video":
+      return `https://channels.weixin.qq.com/platform/`;
+    default:
+      return `https://www.xiaohongshu.com/search_result?keyword=${encoded}`;
+  }
+}
+
+function sessionCheckExpression(platform: BrowserPlatform): string {
+  return `(() => {
+    const href = location.href;
+    const text = (document.body?.innerText || "").slice(0, 2000);
+    const checks = {
+      xiaohongshu: /login|登录/.test(href) || /登录后查看更多|立即登录/.test(text),
+      douyin: /login|sso\\.douyin/.test(href) || /扫码登录|手机号登录/.test(text),
+      wechat_mp: /login/.test(href) || /扫码登录|微信公众平台/.test(text),
+      wechat_video: /login/.test(href) || /扫码登录|视频号助手/.test(text),
+      bilibili: /passport|login/.test(href) || /请先登录|登录后/.test(text),
+    };
+    const loggedIn = !checks[${JSON.stringify(platform)}];
+    return JSON.stringify({
+      href,
+      title: document.title,
+      loggedIn,
+      textHint: text.slice(0, 200),
+    });
+  })()`;
+}
+
+function researchExpression(platform: BrowserPlatform, limit: number): string {
+  return `(() => {
+    const limit = ${limit};
+    const abs = (href) => {
+      try { return new URL(href, location.href).href; } catch { return href || ""; }
+    };
+    const dedupe = new Set();
+    const push = (items, item) => {
+      if (!item || !item.title) return;
+      const key = item.title + "::" + (item.url || "");
+      if (dedupe.has(key)) return;
+      dedupe.add(key);
+      items.push(item);
+    };
+    const text = (el) => (el?.innerText || el?.textContent || "").replace(/\\s+/g, " ").trim();
+    const items = [];
+
+    if (${JSON.stringify(platform)} === "xiaohongshu") {
+      const cards = Array.from(document.querySelectorAll("section, .note-item, [data-index], a"));
+      for (const card of cards) {
+        const titleEl = card.querySelector?.("a[href*='/explore/'], a[href*='/discovery/item/'], a[href*='/note/'], .title span, .desc, .note-title") || card;
+        const linkEl = card.querySelector?.("a[href*='/explore/'], a[href*='/discovery/item/'], a[href*='/note/']") || card.closest?.("a");
+        const authorEl = card.querySelector?.(".author, .name");
+        const title = text(titleEl);
+        const url = linkEl?.href ? abs(linkEl.href) : "";
+        if (title.length >= 4 && url.includes("xiaohongshu.com")) {
+          push(items, { title, url, author: text(authorEl) });
+        }
+        if (items.length >= limit) break;
+      }
+    } else if (${JSON.stringify(platform)} === "douyin") {
+      const cards = Array.from(document.querySelectorAll("a[href*='/video/'], [data-e2e='search-result-container'] a, .ECMy_Zdt"));
+      for (const card of cards) {
+        const titleEl = card.querySelector?.("span, p, h3") || card;
+        const url = card.href ? abs(card.href) : abs(card.querySelector?.("a")?.href || "");
+        const title = text(titleEl);
+        if (title.length >= 4 && url.includes("douyin.com")) {
+          push(items, { title, url });
+        }
+        if (items.length >= limit) break;
+      }
+    } else if (${JSON.stringify(platform)} === "bilibili") {
+      const cards = Array.from(document.querySelectorAll("a[href*='/video/'], .bili-video-card a, .video-list-item a"));
+      for (const card of cards) {
+        const title = card.getAttribute?.("title") || text(card);
+        const url = card.href ? abs(card.href) : "";
+        if (title && url.includes("bilibili.com")) {
+          push(items, { title, url });
+        }
+        if (items.length >= limit) break;
+      }
+    } else {
+      const links = Array.from(document.querySelectorAll("a"));
+      for (const link of links) {
+        const title = text(link);
+        const url = link.href ? abs(link.href) : "";
+        if (title.length >= 6 && url) {
+          push(items, { title, url });
+        }
+        if (items.length >= limit) break;
+      }
+    }
+
+    return JSON.stringify(items.slice(0, limit));
+  })()`;
+}
+
+class WebAccessProxyClient {
+  constructor(private readonly baseUrl: string) {}
+
+  async isReachable(): Promise<boolean> {
+    try {
+      const response = await fetch(`${this.baseUrl}/json/version`);
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+
+  async open(url: string): Promise<string> {
+    const response = await fetch(`${this.baseUrl}/new?url=${encodeURIComponent(url)}`);
+    if (!response.ok) {
+      throw new Error(`Failed to open tab for ${url}`);
+    }
+    const data = await response.json();
+    return data.id || data.targetId || data.tabId;
+  }
+
+  async eval(tabId: string, expression: string): Promise<unknown> {
+    const response = await fetch(`${this.baseUrl}/eval/${encodeURIComponent(tabId)}`, {
+      method: "POST",
+      headers: { "content-type": "text/plain;charset=UTF-8" },
+      body: expression,
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to eval expression for tab ${tabId}`);
+    }
+    const data = (await response.json()) as ProxyEvalResult;
+    if (data.exceptionDetails) {
+      throw new Error(`Browser eval failed for tab ${tabId}`);
+    }
+    return data.result?.value;
+  }
+
+  async close(tabId: string): Promise<void> {
+    await fetch(`${this.baseUrl}/close/${encodeURIComponent(tabId)}`);
+  }
+}
+
+async function withTab<T>(url: string, fn: (client: WebAccessProxyClient, tabId: string) => Promise<T>): Promise<T> {
+  const client = new WebAccessProxyClient(DEFAULT_PROXY_URL);
+  const tabId = await client.open(url);
+  try {
+    await sleep(2500);
+    return await fn(client, tabId);
+  } finally {
+    await client.close(tabId).catch(() => undefined);
+  }
+}
+
+async function getSessionStatus(platform: BrowserPlatform): Promise<BrowserSessionStatus> {
+  const client = new WebAccessProxyClient(DEFAULT_PROXY_URL);
+  const reachable = await client.isReachable();
+  if (!reachable) {
+    return {
+      platform,
+      loggedIn: false,
+      note: `CDP proxy unreachable at ${DEFAULT_PROXY_URL}`,
+    };
+  }
+
+  try {
+    return await withTab(buildPlatformUrl(platform), async (tabClient, tabId) => {
+      const raw = await tabClient.eval(tabId, sessionCheckExpression(platform));
+      const parsed = typeof raw === "string" ? JSON.parse(raw) : {};
+      return {
+        platform,
+        loggedIn: Boolean(parsed.loggedIn),
+        note: parsed.href || parsed.title || "session checked",
+      };
+    });
+  } catch (error: any) {
+    return {
+      platform,
+      loggedIn: false,
+      note: error?.message || "session check failed",
+    };
+  }
+}
+
+async function research(query: BrowserResearchQuery): Promise<ResearchItem[]> {
+  const client = new WebAccessProxyClient(DEFAULT_PROXY_URL);
+  const reachable = await client.isReachable();
+  if (!reachable) {
+    return [];
+  }
+
+  try {
+    return await withTab(buildSearchUrl(query.platform, query.keyword), async (tabClient, tabId) => {
+      const raw = await tabClient.eval(tabId, researchExpression(query.platform, query.limit || 5));
+      const parsed = typeof raw === "string" ? JSON.parse(raw) : [];
+      if (!Array.isArray(parsed)) {
+        return [];
+      }
+      return parsed.map((item: any) => ({
+        title: String(item.title || "").trim(),
+        summary: item.author ? `参考账号：${String(item.author).trim()}` : "来自浏览器登录态搜索结果",
+        url: item.url ? String(item.url) : undefined,
+        author: item.author ? String(item.author) : undefined,
+        platform: query.platform,
+        source: "browser_cdp" as const,
+      }));
+    });
+  } catch {
+    return [];
+  }
+}
+
+export const browserCdpAdapter: BrowserAdapter = {
+  id: "browser_cdp",
+  description:
+    "Browser-first adapter using a web-access style CDP proxy. Reads the user's own logged-in browser session through HTTP endpoints.",
+  getSessionStatus,
+  research,
+};