AgentSkillsCN

soft-eng-from-client-to-dev

项目标准引导：项目启动时，由 AI 引导用户输入资料并补全标准文件。触发语包含：项目启动、依据项目标准补全文件、引导我从头开始建立项目文件、依据项目标准引导我输入资料、从客户到交付开发、软件工程文件、分阶段建立、依赖性建立、引导我输入资料补全、交付开发、迭代修正。

SKILL.md
--- frontmatter
name: soft-eng-from-client-to-dev
description: 專案標準引導：專案開始時由 AI 引導使用者提供資料並補足標準文件。觸發語包含：專案開始、依專案標準補足文件、引導我從頭建立專案文件、依專案標準引導我提供資料、從客戶到交付開發、軟體工程文件、分階段建立、依賴性建立、引導我提供資料補足、交付開發、迭代修正。

從客戶到交付開發：軟體工程文件引導（專案標準）

本流程為專案標準一環：專案開始時由 AI 負責引導使用者提供資料，並依階段依賴補足標準文件，有助後續開發對齊需求。完整標準見 docs/16-PROJECT-STANDARD.md。

專案開始時（預設啟動）

當使用者說「專案開始」「依專案標準補足文件」「引導我從頭建立專案文件」「依專案標準引導我提供資料」時：

  1. •視為從 00 開始的完整引導流程，依 docs/16-PROJECT-STANDARD 與本 Skill 執行。
  2. •從 00 客戶背景 開始，依序引導並補足 01～10；每階段寫入對應 .md，未提供處標「待補」。
  3. •每完成一份即說明下一份與所需資訊，並詢問是否繼續；使用者可隨時說「先做到這裡」或指定跳過某份。

文件集與路徑

  • •專案標準：docs/16-PROJECT-STANDARD.md
  • •總覽：docs/from-client-to-dev/README.md
  • •範本：docs/from-client-to-dev/00-CLIENT-BACKGROUND.md～10-HANDOVER-CHECKLIST.md

階段與依賴（建議填寫順序）

階段文件依賴引導時可問／可補
1. 客戶與專案緣起00 客戶背景—客戶名稱、產業、專案緣起、主要窗口
01 專案目的與範圍00一句話說明、成功條件、範圍邊界、時程假設
2. 利害關係人與決策02 利害關係人與決策01誰會用、誰付費、誰驗收、決策流程
3. 需求03 功能需求02功能列表、優先級、驗收條件
04 非功能需求02效能、安全、維運、整合介面
05 名詞定義與邊界03, 04關鍵術語、排除範圍
4. 情境與設計06 使用者故事與情境03, 04, 05誰、何時、做什麼、結果；對應 03 編號
07 介面與流程06畫面、流程（可待補）
5. 技術與估價08 技術備忘03, 04, 06技術棧、介面規格、權限、部署
09 估價與報價03～08項目與金額、假設與排除、期限
6. 交付開發10 交付開發檢查清單03～09檢查項、任務對應、聯絡窗口

引導流程（分階段、依賴性）

1. 確認起點

  • •若使用者說「從頭建立」：從 00 客戶背景 開始。
  • •若使用者說「從第 N 階段開始」或「先做需求」：從對應文件開始（須提醒依賴的前置文件是否已有內容）。
  • •若使用者說「補足某一份」：直接針對該文件引導。

2. 每一階段的作法

  1. •說明本階段要產出的文件與其依賴（例如：01 依賴 00）。
  2. •列出該文件需要補足的欄位（對應範本中的「待補」）。
  3. •引導使用者提供資料：可依範本逐項提問，或請使用者一次提供一段敘述，再由 AI 整理成表格／條列填入對應文件。
  4. •寫入或更新對應 .md 檔案：將使用者提供的內容依範本格式填入，未提供處保留「待補」。
  5. •提醒下一步：說明下一階段是哪一個文件、需要哪些資訊，並詢問是否繼續。

3. 提問範例（依階段）

  • •00 客戶背景：客戶名稱／單位？產業？專案緣起（為什麼要做）？主要窗口與決策者？
  • •01 專案目的與範圍：一句話說明專案？成功時長什麼樣子？明確「要做」與「不做」的範圍？預期上線或交付時點？
  • •02 利害關係人：誰會用系統？誰付費／採購？誰驗收？誰有否決權？需求變更由誰決定？
  • •03 功能需求：主要功能有哪些？可依模組或使用者故事列；每項的優先級與驗收條件？
  • •04 非功能需求：預期使用者數／併發？回應時間？安全／權限？維運與監控？需串接的既有系統或 API？
  • •05 名詞定義與邊界：專案內關鍵術語定義？排除範圍（不做的項目）？
  • •06 使用者故事與情境：主要使用情境（誰、在什麼情境、做什麼步驟、得到什麼結果）？可對應 03 編號。
  • •07 介面與流程：是否有 Wireframe、流程圖或既有系統介面可參考？可標註待補。
  • •08 技術備忘：技術棧？環境？對外／對接介面？權限與部署注意事項？
  • •09 估價與報價：分項（需求分析、設計、開發、測試、上線、維護）之人天或金額？假設與排除？有效期限與付款條件？
  • •10 交付開發檢查清單：逐項勾選 01～09 是否就緒；任務對應 03 編號；聯絡窗口與交付方式。

4. 迭代修正

  • •當使用者說「我改了 XX」「範圍變了」「需求有更新」時：
    1. •更新使用者指定的文件。
    2. •依 README 依賴關係，列出可能受影響的其他文件（例如：改 01 範圍 → 建議檢查 03、05、09、10）。
    3. •詢問是否一併更新或由 AI 建議修訂內容。

產出與格式

  • •以繁體中文為主；結構清晰、可追蹤、便於工程師執行與估價。
  • •未定稿或待補處一律標註「待補」或「（待補）」。
  • •引用其他文件請用相對路徑，例如：見 docs/from-client-to-dev/03-FUNCTIONAL-REQUIREMENTS.md。
  • •與專案既有 Rule「需求與軟工文件」對齊（專案概述、功能需求、非功能需求、名詞定義、報價章節、交付工程師結構）。

引用

  • •專案標準（專案開始時由 AI 引導）：docs/16-PROJECT-STANDARD.md
  • •總覽與依賴圖：docs/from-client-to-dev/README.md
  • •各範本：docs/from-client-to-dev/00-CLIENT-BACKGROUND.md～10-HANDOVER-CHECKLIST.md