公開分享(Go Public)
目標:使用者剛才與你共同完成的工作流程,變成一個任何人都能使用的連結:他們開啟連結、填入輸入項目、按下執行,然後得到相同類型的結果。訪客無需帳號。這個頁面會隨附一個每日免費的小額 AI 配額,供頁面運作使用。
所有操作都透過此技能資料夾中的 share.py 執行(Python 3,標準函式庫)。以下 <skill> 代表此技能資料夾的路徑。
1. 確定工作流程(詢問,不要猜測)
根據對話內容,寫下 3 到 6 行內容並展示給使用者:
- 訪客提供:每個輸入項目(文字框、單行欄位或從清單中選擇)。
- 步驟:依序進行的每個 AI 呼叫及其作用。大多數工作流程為 1 到 3 個步驟。使用本次對話中實際可行的提示詞,並將其寫成在沒有前後對話脈絡時也能理解的內容。
- 訪客得到:顯示哪些步驟的結果。
- 標題和一句話描述,讓陌生人一看就懂。
要求使用者確認或修正。如果語言不明顯,也詢問頁面應使用哪種語言。
請勿製作要求輸入密碼、付款或信用卡資訊、一次性驗證碼,或偽裝成其他公司或個人的頁面。請勿將對話中的私人資料(姓名、電子郵件、內部編號)放入提示詞或範例中;請使用虛構的範例。
2. 撰寫 workflow.json
放在使用者目前的資料夾中。格式如下:
{
"title": "會議記錄 → 後續郵件",
"description": "貼上會議的草稿記錄,即可獲得決策事項、負責人以及一封簡短的後續郵件。",
"inputs": [
{"id": "notes", "label": "您的會議記錄", "type": "textarea", "placeholder": "內容雜亂也沒關係…"},
{"id": "tone", "label": "語氣", "type": "select", "options": ["友善", "正式"]}
],
"steps": [
{"id": "facts", "prompt": "列出決策事項、待辦事項(負責人 — 任務 — 截止日期)以及未解決的問題。只使用記錄中提到的內容。純文字,不使用 Markdown。", "input": "{{notes}}", "show": true, "label": "決定了什麼"},
{"id": "email", "prompt": "用 {{tone}} 的語氣寫一封後續郵件,字數少於 150 字。純文字,不使用 Markdown。", "input": "{{facts}}", "show": true, "label": "後續郵件"}
],
"examples": [{"label": "產品同步會議", "values": {"notes": "發布延至 12 月 2 日,因付款錯誤。Raj 週五前修正錯誤…", "tone": "友善"}}]
}
規則:
type:textarea(預設)、text或select(需要options)。輸入項目皆為必填,除非設定"required": false。prompt、system或input中的{{id}}會被替換為輸入項目或先前步驟的回答。將訪客的文字放在input,指令放在prompt;可選的system用於設定角色和規則。show: true會顯示該步驟。隱藏的步驟適合用於中間處理。最後一個顯示的步驟會以串流方式輸出。- 每個步驟的
maxTokens,預設為 800(也是頁面的限制)。 - 永遠至少提供一個範例:訪客點擊即可看到頁面運作,然後再自行輸入。
- 回答以純文字顯示,因此
**粗體**會顯示為星號。每個顯示步驟的提示詞結尾請加上「純文字,不使用 Markdown。」並使用簡單的破折號來表示列表。
3. 檢查並實際測試
python3 <skill>/share.py check workflow.json
python3 <skill>/share.py try workflow.json # 使用真實 AI 執行範例 1,並印出每個步驟
像陌生人一樣閱讀輸出內容。如果某個步驟含糊不清、錯誤或過長,請修正提示詞並再次執行 try。在發布前,向使用者展示範例的最終輸出結果。
4. 建置與發布
python3 <skill>/share.py build workflow.json page.html
python3 <skill>/share.py publish page.html
publish 會印出公開連結。它會將頁面 ID 和私有的編輯令牌儲存在 .go-public.json 中(並在 git 儲存庫中將其加入 .gitignore)。告知使用者:
- 連結,可隨時發送給任何人;
.go-public.json讓使用者之後可以修改或移除頁面,請妥善保管且不要分享。
請勿手動編輯 page.html:修改 workflow.json 後重新建置即可。
5. 日後修改或移除
編輯 workflow.json,然後在相同資料夾中再次執行 build 和 publish:連結不變,內容更新。執行 python3 <skill>/share.py delete 可將頁面下架。
遇到限制時誠實告知
- 每個頁面每日有免費 AI 配額及每位訪客的速率限制(由
publish印出)。當熱門頁面配額用盡時,頁面會顯示提示並在次日恢復運作。 - 如果使用者詢問如何提高配額或查看使用量:
.go-public.json中的claim_url可讓使用者領取頁面。他們輸入電子郵件,從收件匣中確認後,該頁面就會改用該帳號自己的 AI 配額。僅在使用者詢問或配額用盡時提及此選項。每個頁面上都會保留「Made with OneTag · Report」的小標記。 - 訪客可以檢舉頁面;多人檢舉的頁面會下線進行審查。
- 頁面無法載入外部圖片、字型或函式庫,也沒有儲存空間或登入功能:它就是一個表單、AI 步驟和結果的組合。