AI-drama-pound README

The project's README from github.com/POUND0423/AI-drama-pound. As one markdown file: README.md.

AI 短劇編劇

以繁體中文完成短篇/豎屏短劇的選題、結構、角色、分場、臺詞、衝突、反轉、格式與修改。

GitHub Release v0.1.0 · MIT License

ai-short-drama-screenwriter 是一個可供 ChatGPT 桌面版 Codex、Codex CLI 與 IDE extension 使用的 standalone skill。它把故事前提與製作限制整理成可見、可聽、可拍攝,且有明確戲劇推進的短劇內容。

專案解決什麼問題

一般 AI 短劇草稿常見以下問題:

本技能用明確的任務路由、八階段編劇流程、標準短劇格式與修改清單,讓輸出保持可拍性、敘事推進與交付範圍一致。

主要功能

安裝方法

前置條件

Codex 的個人技能位置為 $HOME/.agents/skills。每個技能都必須是獨立資料夾,且資料夾內直接包含 SKILL.md。詳見 OpenAI 官方技能文件。

Windows PowerShell

git clone --depth 1 https://github.com/POUND0423/AI-drama-pound.git

$repoPath = Join-Path (Get-Location) 'AI-drama-pound'
$skillPath = Join-Path ([Environment]::GetFolderPath('UserProfile')) '.agents\skills\ai-short-drama-screenwriter'

New-Item -ItemType Directory -Force -Path $skillPath | Out-Null
Copy-Item -Path (Join-Path $repoPath 'skill-src\ai-short-drama-screenwriter\*') -Destination $skillPath -Recurse -Force

Test-Path (Join-Path $skillPath 'SKILL.md')

最後一行應輸出 True。

macOS/Linux

git clone --depth 1 https://github.com/POUND0423/AI-drama-pound.git

mkdir -p "$HOME/.agents/skills/ai-short-drama-screenwriter"
cp -R "AI-drama-pound/skill-src/ai-short-drama-screenwriter/." \
  "$HOME/.agents/skills/ai-short-drama-screenwriter/"

test -f "$HOME/.agents/skills/ai-short-drama-screenwriter/SKILL.md" \
  && echo "Skill installed"

成功時會輸出 Skill installed。Codex 通常會自動偵測技能;若沒有出現,請重新啟動 Codex。

使用方法

顯式呼叫

在提示中直接加入技能名稱:

使用 $ai-short-drama-screenwriter,把以下故事前提規劃成 8 集、每集 90 秒的都市懸疑短劇。主要場景不超過 3 個;先提供創作簡報、角色關係、全劇節拍與第一集劇本。

故事前提:外送員每天替一位失憶老人送餐,最後發現老人可能是失蹤多年的外公。

隱式呼叫

也可以直接提出符合技能範圍的需求,例如:

只修改這段短劇重逢戲的臺詞,增加潛臺詞,不要重做人物設定或全劇大綱。

技能允許隱式啟動;是否啟動取決於請求是否符合 SKILL.md 的使用範圍。

輸入輸出範例

輸入

使用 $ai-short-drama-screenwriter,將「外送員替失憶老人送餐,逐漸發現老人是失蹤多年的外公」發展成 8 集都市懸疑短劇。每集 90 秒,主要場景不超過 3 個。請提供必要假設、創作簡報、角色關係、全劇節拍與第一集劇本。

輸出節錄

必要假設
- 觀眾:偏好都市情感懸疑的短劇觀眾
- 製作限制:主要場景為外送站、老公寓與主角家

創作簡報
- 類型:都市溫情懸疑
- 主角目標:確認老人身分,同時查明家人隱瞞的往事
- 主要阻力:老人記憶破碎,主角母親阻止他繼續調查

角色關係
- 阿澤:外送員;從同情老人轉為追查自己的家族秘密
- 陳伯:失憶老人;保留與阿澤童年有關的零碎記憶
- 美玲:阿澤母親;知道老人身分,但害怕舊事再次傷害家人

全劇節拍(節錄)
- 第 1 集:阿澤在老人門口撿到自己童年的照片;母親要求他停止送餐。
- 第 4 集:老人短暫恢復記憶,叫出阿澤父親的名字。
- 第 8 集:阿澤確認血緣真相,必須決定公開秘密或保護母親。

第 1 集

1. 內景・老公寓走廊・夜

阿澤提著餐袋停在 302 室門前。門縫下壓著一張泛黃照片。

照片裡,五歲的阿澤坐在一名男子肩上。男子的臉被撕掉一半。

阿澤
陳伯,您的晚餐到了。

門內傳來老人顫抖的聲音。

陳伯(OS)
小澤,你終於回來了。

阿澤僵住。他從未告訴老人自己的小名。

切黑。

實際輸出會依故事前提、限制與指定交付形式改變,不保證與範例逐字相同。

功能邊界

專案結構

AI-drama-pound/
├── skill-src/ai-short-drama-screenwriter/
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   └── references/
│       ├── workflow.md
│       ├── format.md
│       └── checklists.md
├── validation/ai-short-drama-screenwriter/
├── docs/superpowers/
├── LICENSE
└── README.md

驗證狀態

常見問題

安裝後找不到技能

確認以下檔案直接存在:

$HOME/.agents/skills/ai-short-drama-screenwriter/SKILL.md

若路徑正確但技能仍未出現,重新啟動 Codex。

可以直接產生分鏡或影片提示詞嗎?

此技能本身負責短劇編劇。若同時要求劇本與分鏡或影片提示詞,它會先完成劇本,再嘗試銜接環境中已安裝的適用技能。

授權

本專案採用 MIT License。

AI-drama-pound (POUND0423/AI-drama-pound)

short-drama
Searching Database…

What is this?ai-short-drama-screenwriter is an agent skill for ChatGPT desktop Codex, Codex CLI, and IDE extensions that handles topic selection, structure, characters, scenes, dialogue, conflict, twists, and revisions for short/vertical dramas written in Traditional Chinese.
Is this a standalone app or a skill I add to Codex?It's a standalone skill (a SKILL.md folder) that plugs into Codex, not a separate application.
Do I need anything installed before this works?You need Git installed and a Codex environment that supports standalone skills: ChatGPT desktop Codex, Codex CLI, or the IDE extension.
Does it also generate storyboards or video prompts?No. When only a script is requested, it will not output shot-by-shot storyboards, shot types, camera movement, or AI video-model parameters; that's explicitly out of scope.
What does the 8-stage screenwriting process cover?It walks through creative brief, genre positioning, overall and episode structure, character relationships, scene breakdown, dialogue, conflict/emotion/twist/hook design, and finally a draft plus revision pass.
Can it write in languages other than Traditional Chinese?Traditional Chinese is the default output, but another language can be specified directly in the prompt.
Has this skill actually been tested?The README reports RED baseline tests showing format gaps without the skill, GREEN behavior tests passing across four scenarios, and A-F trigger-boundary micro-tests all scoring 5/5, plus validation against the official skill structure.
What happens if I ask for a script and a storyboard together?The skill finishes the screenplay first, then hands off to another storyboard or video-prompt skill already installed in the environment, since it doesn't produce those itself.
Creator
POUND0423
Size
<0.1 MB
Stars
561
Age
1mo
Commits · 90 Days