Agent-Skills.md

Agent Skills: Opportunity Factory

Run a reusable opportunity-to-artifact workflow: discover unmet needs, set up workspace factories, schedule recurring commander/worker/reporter prompts, batch-refine many items, optionally use SQLite state, build small artifacts, review quality, and track outcomes. Use when the user wants to repeatedly create apps, games, products, content, or experiments from market/user needs.

UncategorizedID: aktsmm/agent-skills/opportunity-factory

Repository

aktsmm/agent-skills
aktsmmLicense: NOASSERTION
213

Install this agent skill to your local

pnpm dlx add-skill https://github.com/aktsmm/Agent-Skills/tree/HEAD/opportunity-factory

Skill Files

Browse the full folder contents for opportunity-factory.

Download Skill

Loading file tree…

opportunity-factory/SKILL.md

Skill Metadata

Name
opportunity-factory
Description
"Run a reusable opportunity-to-artifact workflow: discover unmet needs, set up workspace factories, schedule recurring commander/worker/reporter prompts, batch-refine many items, optionally use SQLite state, build small artifacts, review quality, and track outcomes. Use when the user wants to repeatedly create apps, games, products, content, or experiments from market/user needs."

Opportunity Factory

ニーズ発見から小さな成果物、レビュー、計測、学習までを回す汎用ワークフロー。

When to Use

  • 「ニーズを探して、レビューして、作る」を継続的に回したい
  • スマホアプリ、Steam ゲーム、SaaS、教材、社内改善などを量産したい
  • アイデアをラバーダックで壁打ちし、実行可能な queue に分解したい
  • 単発回答ではなく、反復可能な workspace factory を設計・運用したい
  • テーマだけを与えて、workspace、状態管理、定期ワークフロー、レビューゲートを自律設計させたい
  • 2〜3 個の定期プロンプトで状態を見ながら継続改善したい
  • /Refine-Product-100 all のように多数の対象を複数passで改善したい

When Not to Use

  • 1 回だけの実装、調査、レビューなら通常対応でよい
  • 常時守るコーディング規約なら instruction にする
  • 特定 persona や tool 制限が主目的なら custom agent にする
  • deterministic な同期、変換、検証だけなら script / hook にする

Core Idea

抽象ループは次の通り。

discover -> research -> evaluate -> design -> build -> review -> launch/track -> learn

各ループは「次に作るもの」ではなく「どの痛み・需要を検証するか」から始める。

Workflow

  1. Frame the factory 対象ドメイン、成果物タイプ、成功指標、禁止事項を 5 行以内で定義する。
  2. Rubber-duck the intent 前提、誰の痛みか、既存代替、最小検証、失敗条件を質問で露出させる。
  3. Design the workspace loop ユーザーがテーマだけを与えた場合は、状態ファイル、dashboard、Top-N/portfolio、候補深掘り、週次 workflow review まで含む自走ループを設計する。
  4. Create the queue 作業を discover|research|evaluate|design|build|review|track|learn に分ける。
  5. Produce artifacts 各 task は 1 つの evidence artifact を残す。判断、根拠、次アクションを分離する。
  6. Run review gates UX、技術、法務/規約、配布、収益/成果指標をドメインに合わせて確認する。
  7. Track outcomes 実測、推定、未確認を区別し、当たりだけを次サイクルで厚くする。

Operating Rules

  • 先に「誰のどんな未充足ニーズか」を固定してから解決策を作る。
  • 1 task は 1 artifact に収まる粒度にする。
  • Advisory-only schedules are safe but too slow for a real factory; if the user expects progress, add at least one bounded mutating worker that writes one artifact and updates local state.
  • 複数 worker で回す場合は、discovery/research worker、build/decision worker、reporter-learner など役割を分け、各 run は 1 task / 1 artifact / 明示的 state 更新に制限する。
  • 小さい queue では commander/worker を別々にスケジュールせず、1本の single-cycle automation で commander -> 1 worker -> reducer を回してよい。ただし auto-eligible task、lock、JSON backup/parse validation が必須。
  • Mutating workers need duplicate-run prevention such as a short-lived lock file before they update queue or outcome state.
  • Maintain a canonical dashboard/status state for future sessions and user status answers; every workflow that changes artifacts, queues, gates, portfolio ranking, blockers, or schedules must update it with backup + stale-write checks.
  • Add a workflow-review loop as a first-class workflow for self-improving factories; it reviews cadence, queue quality, Top-N replacements, dashboard drift, missing gates, and unsafe autonomy at a slower cadence than workers.
  • Portfolio factories need a Top-N state with explicit replacement rules; do not grow candidate lists forever, and do not replace an incumbent without comparative evidence and reviewer critique.
  • When a selected task hits an approval boundary, record it as blocked with the exact approval needed, then run or create one safe fallback task instead of stalling the factory.
  • Do not rely on chat history for factory state; write a README/resume contract that tells future sessions which state, queue, outcome, log, and artifact files to read first.
  • Keep prototype/build lanes in the same factory when the user wants end-to-end production, but gate source generation on a structured candidate-level continue decision plus an MVP boundary artifact.
  • If the current host cannot build-verify the target platform, mark generated code as compile-oriented and verification-blocked; never report it as built, running, or tested without a platform verification artifact.
  • 指標は実測、推定、仮説を明示して混ぜない。
  • 課金、ログイン、外部公開、個人情報、法的リスクは人間承認の境界にする。
  • ワークスペース固有パスや秘密情報を skill 本体へ埋め込まない。

AI-Autonomous Operation

AUTO 既定、承認は security-approve のみ。Skill には hard rule (変更不可) と reference default (workspace が実運用で改善可) が混在、詳細は §Tunable vs Hard Rules。詳細は各 references。

| # | 章 | 骨子 | 詳細 | | --- | --- | --- | --- | | A | Approval Policy | 2 バケット (auto / security-approve)。金銭発生は後者の 1 例。AI usage は skill 対象外。Backup-First で reversible は auto。 | references/approval-policy.md | | B | Autonomy Mode | Normal / AUTO 既定 / FULL / ALL の 4 段階。setup Phase 0 で mode 未指定なら AUTO 提案 + 確認。secret 露出等は全 mode で対象外。 | references/runtime-modes.md (ai-autonomous preset) | | C | Fallback Lane | blocked/stall/idle 時 10 lane 順次 auto-dequeue (1 Portfolio → 2 Prompt review → 3 Advisory Critic → 4 Anti-pattern → 5 Discovery → 6 Small-Bet → 7 Learning → 8 Cleanup → 9 Real-surface RO → 10 Digest)。Discovery Floor 5 サイクル。browser 書込みは defer。 | references/fallback-lane.md | | D | Genuine Blocker Test | failed/stall で即 blocker 認定せず 4 問 gate (外部 signal 確認 / 別 approach N / replan / 制御不能)。4/4 Yes のみ HITL、以外は fallback へ。 | references/fallback-lane.md | | E | Persistence Profile | Standard / Persistent (既定) / Exhaustive。task class 別マッピング。cost/quota は skill 対象外 (adapter 任せ)。worker は自分で approach 増やさず commander が replan。 | references/persistence-profile.md | | F | Cadence + Adapter | worker=hourly / workflow-review=weekly + ad-hoc trigger / digest=daily。per-hour override 可。Adapter は環境依存 (Copilot Scheduler / Scout / OpenClaw / Copilot App / GH Actions / Task Scheduler / cron)。Push cadence は setup で 1 度質問、既定 manual。 | references/runtime-modes.md | | G | Goal + Focus Theme | 無限稼働、停止は user 明示のみ。Setup で north-star + focus theme (3 ヶ月、workspace override 可) の 2 段合意。Theme apply は Layer 3 blocking critic gate (hard rule)。Candidate 完了 = Top-N 自然消滅 + shipped 明示。 | references/workspace-setup.md + references/rubber-duck-review.md |

Tunable vs Hard Rules

Skill は hard rule (変更不可) と reference default (AI/workspace が実運用で改善可) の 2 層。Hard rules: approval bucket 構造 (auto/security-approve)、backup-first 原則、blocker test 4 問 gate、critic 3 layer、layer 3 blocking gate 対象 5 種、fallback lane auto-refill、north-star + focus theme 合意事実、independence 契約。詳細と reference default 一覧: references/tunable-defaults.md

Output Modes

Rubber Duck / Factory Plan / Workspace Setup / Self-Designing Workspace Setup / Run Slice / Periodic Runtime / Throughput Setup / Prototype Lane / Review — 用途別に責務を切替。Prototype Lane は validated candidates only + dummy data + WIP 制限 + platform-verification 必須。

References

  • AI-Autonomous 基盤: rubber-duck-review.md (Layer 1/2/3 + Layer 3 SSOT) / approval-policy.md / fallback-lane.md / persistence-profile.md / tunable-defaults.md / runtime-modes.md (ai-autonomous preset)
  • Workflow / Setup: workflow.md / workspace-setup.md / self-designing-factory.md / battle-tested-patterns.md / prompt-self-improvement.md / batch-refinement.md / sqlite-state-store.md
  • State: dashboard-state.md / assets/templates/dashboard-state.json / assets/templates/factory-state.json / assets/templates/factory-state.sqlite.sql / assets/templates/first-run-queue.json / assets/templates/task.json / assets/templates/artifact.md
  • Prompts: assets/prompts/commander.md / assets/prompts/worker.md / assets/prompts/reporter-learner.md
  • Scripts: scripts/validate_factory_skill.py / scripts/init_factory_workspace.py / scripts/init_factory_sqlite.py / scripts/smoke_test_initializers.py
  • Templates / Examples: assets/templates/factory-plan.md / assets/templates/setup-preflight.md / assets/examples/setup-packets.md

Done Criteria

  • Primitive choice is still Skill, not prompt/instruction/agent/hook
  • Domain, artifact type, success metric, and constraints are explicit
  • Target surfaces, state store, prompt runner, schedule capability, and approval boundaries are explicit
  • Queue has at least one next executable task
  • Every task has an artifact contract and review gate
  • Human approval boundaries are named
  • A canonical status dashboard or equivalent resume contract exists, and status answers use it first
  • Self-improving factories include a scheduled or manual workflow-review loop
  • Prompt self-improvements are workspace-local, evidenced by an artifact, reversible, and dashboard-recorded
  • Portfolio factories define Top-N capacity, replacement criteria, and demotion/watchlist/rejected states
  • If scheduled progress is expected, at least one safe mutating worker exists; advisory-only automation is called out as intentionally slow
  • Approval-boundary blockers do not empty the run: the runtime records the blocker and keeps at least one safe fallback lane available
  • Future sessions can resume from durable state files without reading the original chat transcript
  • Prototype/source-generation tasks require candidate-level continue state, an MVP boundary artifact, dummy data only, WIP limits, and honest platform-verification status