jezweb app-docs：把 Web App 變成操作圖文，但影片、去識別化與同步更新要另設流程

原貼、附圖與留言

2026-10-05 查核。@alice79101 分享使用 jezweb/claude-skills，請 Claude 為專案做操作圖文及短影片，並稱畫面取自程式碼、真實資料替換為模擬資料、可提供修改方式且對 token 友善。原文沒有指出具體 skill 檔名與使用 commit，不能把每項成果都直接歸於同一個內建工具。

本次已擷取主貼及公開可見留言，檢視並確認三張原作者附圖的 DOM 歸屬：民眾登記送修、志工報名／簽到／回報、管理員審核與成果統計。圖片標示畫面為示範資料，表單可見 demo@example.com 等示例。這支持『作者展示了分角色的教學成果』，不能證明所有輸出已完整去識別化，也不能驗證生成過程。

高訊號留言問：只改某一步說明時，操作圖與短片會一起更新，還是要分開請 Claude 修改？本次可見範圍沒有作者回答。這不是小問題，而是文件生產能否從一次性成果走向持續交付的關鍵。

頁面另載入相關串文的錄影。經 DOM 追溯，該影片屬於另一作者的 GitOps 工作流貼文，不是本次原貼，因此排除；不能把頁面第一個 video 元素當成原作者短影片的證據。本次未取得可歸屬於原貼的短影片，短影片完成仍屬作者自述。

官方 repo 能確認什麼

查核固定於 commit ee91a87a5c5edccd0910780dcd00aa28cec13a46。repo 為第三方 Jezweb／Jeremy Dawes 專案，不是 Anthropic 官方 skills 套件。LICENSE 為 MIT；其他執行工具及服務仍依其各自授權與條款。

最接近貼文情境的 skill 是 plugins/dev-tools/skills/app-docs/SKILL.md。這是依官方內容做的功能對應，不是作者已確認用了該檔。其 frontmatter 標示 compatibility: claude-code-only。

app-docs 的實際流程包括：

• 取得 App URL、名稱、登入方式、讀者與文件深度。
• 盤點導覽與路由，瀏覽正在執行的頁面，而不是只根據程式碼想像 UI。
• 使用 Chrome MCP、Playwright MCP 或 playwright-cli，等待畫面與資料載入後截圖。
• 對各頁寫用途、畫面元素、可執行操作與逐步流程。
• 視深度加入空白／錯誤狀態、手機版、CRUD、角色權限與疑難排解。
• 預設輸出 docs/USER_GUIDE.md 及 docs/screenshots/；深入或指定需求可產生 HTML。