substack-skill 設計書

Appearance

substack-skillSubstack 記事自動生成スキル

AIで記事 → 挿絵 → 図 → Substack下書き、を1コマンドで

全体ロードマップ
設計書を読む
GitHub Issues
📝

4 種類の入力ソース

トピック / URL / PDF / 既存Markdown (Zenn・Qiita) のいずれかから記事を自動生成。 AI が要約・翻案・章立てを行い、Article IR に正規化する。

🎨

画像 + 図の自動生成

Higgsfield / OpenAI gpt-image でカバー・挿絵、Excalidraw でフロー図・概念図を生成。 位置決定 → 統合 → CDN アップロードまでパイプライン化。

📤

Substack 下書きアップロード

非公式 API (python-substack v0.1.22) を経由して下書きを自動作成。 slug ベース冪等性で重複防止。公開は人間が Substack エディタで最終確認。

🛡️

安全側のデフォルト

Keychain 必須・ログマスキング・中間ファイル 7日 retention・PII 検出。 公開 endpoint (publish) は本スキルで実装しない方針。

このサイトについて ​

substackTools リポジトリの設計書・進捗・課題を横断的に閲覧できる 内部ドキュメントサイトです。 ローカル開発と並行して GitHub Issues / Codex レビューを回しています。

プロジェクトの現状（2026-05-15 時点） ​

トラック親 issue件数進捗
Track 1: アカウント設定#125Phase 1 着手前
Track 2: 記事生成スキル#2637M1 基盤完了（A-1〜A-5 / E-1 マージ済み）
Track 3: X→AIニュース自動投稿#6426着手前（Track 2 完了が前提）

合計 88 件の issue + 親 tracking 3 本で管理中。

主要な設計判断 ​

  1. 採用ライブラリ: ma2za/python-substack v0.1.22（API調査参照）
  2. 認証: Cookie ベース（substack.sid）+ Keychain 保存（認証フロー参照）
  3. 画像生成: Higgsfield primary / OpenAI fallback の切替インターフェース
  4. 公開行動: substack-skill 本体では実装しない。x-news-auto track のみで承認後公開を解禁
  5. 配置: /Volumes/AIWorkSSD/AIWorkSpace/Skills/substack-skill への symlink（配置方針参照）

クイックリンク ​

substack-skill 内部設計書 — 公開非対象

© 2026 aieo-product