docs(doc-funcs): 補充 README 專案列表輸出規格

README.md

@@ -175,7 +175,7 @@ rm -rf ~/.config/opencode/skills/doc-docker ~/.config/opencode/skills/doc-funcs
 
 ### `doc-funcs`
 
-掃描目前專案所有可文件化的 function/method，建立 `.docs/doc-funcs-index.md` 與逐 function 草稿，再依草稿補齊 XML documentation comments，最後重建 README 功能列表與使用範例；遇到跨專案或跨命名空間的同名型別時會在功能名稱補上模組/專案前綴，並會跳脫 Markdown 表格、link text、heading 中的 C# 泛型角括號，檢查功能列表連結與使用範例 anchor 一致後執行合適驗證。當使用者要補齊 function 文件、產生 XML doc、為每個 method 加 summary/param/remarks、建立 .docs 草稿，或提到 doc-funcs、function 文件化、XML documentation comments 時使用此 skill。
+掃描目前專案所有可文件化的 function/method，建立 `.docs/doc-funcs-index.md` 與逐 function 草稿，再依草稿補齊 XML documentation comments，最後重建 README 專案列表、功能列表與使用範例；README 更新時間固定使用台灣時區（Asia/Taipei）與 `yyyy/MM/dd HH:mm:ss` 格式，專案列表會彙整專案描述、參考專案與 NuGet 套件；遇到跨專案或跨命名空間的同名型別時會在功能名稱補上模組/專案前綴，並會跳脫 Markdown 表格、link text、heading 中的 C# 泛型角括號，檢查功能列表連結與使用範例 anchor 一致後執行合適驗證。當使用者要補齊 function 文件、產生 XML doc、為每個 method 加 summary/param/remarks、建立 .docs 草稿，或提到 doc-funcs、function 文件化、XML documentation comments 時使用此 skill。
 
 - **Claude Code / Antigravity**：`/jsc:doc-funcs`
 - **Codex**：`$doc-funcs`，或用 `/skills` 選單

skills/doc-funcs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: doc-funcs
-description: 為目前專案的每個 function 建立 .docs/ 草稿並補齊 XML 文件，最後重建 README 功能列表與使用範例。當使用者要補齊 function 文件、產生 XML doc、為每個 method 加 summary/param/remarks、建立 .docs 草稿，或提到 doc-funcs、function 文件化、XML documentation comments 時使用此 skill。
+description: 為目前專案的每個 function 建立 .docs/ 草稿並補齊 XML 文件，最後重建 README 專案列表、功能列表與使用範例。當使用者要補齊 function 文件、產生 XML doc、為每個 method 加 summary/param/remarks、建立 .docs 草稿，或提到 doc-funcs、function 文件化、XML documentation comments 時使用此 skill。
 ---
 
 # 補齊 function 文件
@@ -20,18 +20,20 @@ description: 為目前專案的每個 function 建立 .docs/ 草稿並補齊 XML
 4. 在實作到原始碼之前，主 agent 必須檢查所有草稿內容是否以繁體中文為主、英文為輔，且沒有任何亂碼、編碼錯誤、不可讀字元或明顯破損文字。若發現問題，先修正草稿並重新檢查，通過後才能進入下一步。
 5. 所有草稿完成且通過檢查後，主 agent 要閱讀草稿並實作到原始碼。若是 C#，使用 XML documentation comments：`<summary>`、`<param>`、`<remarks>`。註解盡量使用繁體中文；保留既有正確文件，僅補齊缺漏或明顯不足處；不要為了文件改變 runtime 行為。
 6. 若遇到大量 function，仍要分批持續處理，不要只做示範。若 token 或時間不足，先完成已列入 index 的批次，並在 .docs/doc-funcs-index.md 標記 pending。
-7. 補齊後，重建專案根目錄的 README.md。若根目錄已有 README.md，先刪除既有檔案，再產生新的 README.md；不要保留或合併舊內容。README 必須包含更新時間，且只列出所有專案內的公開方法（public method、public constructor、public extension method、public operator），但不得列出單元測試方法；若方法位於測試專案、測試檔案、測試型別，或帶有測試框架屬性/命名（例如 `Test`、`Fact`、`Theory`、`TestMethod`、`TestCase`、`SetUp`、`TearDown`、`Initialize`、`Cleanup`），即使是 public 也要排除。產生 README 前，必須先為每個公開方法決定「最終功能名稱」：
+7. 補齊後，重建專案根目錄的 README.md。若根目錄已有 README.md，先刪除既有檔案，再產生新的 README.md；不要保留或合併舊內容。README 必須包含更新時間，更新時間必須使用台灣時區（Asia/Taipei）並固定輸出為 `yyyy/MM/dd HH:mm:ss` 格式，例如 `2026/06/22 18:30:05`；README 必須在功能列表前加入專案列表，並只列出所有專案內的公開方法（public method、public constructor、public extension method、public operator），但不得列出單元測試方法；若方法位於測試專案、測試檔案、測試型別，或帶有測試框架屬性/命名（例如 `Test`、`Fact`、`Theory`、`TestMethod`、`TestCase`、`SetUp`、`TearDown`、`Initialize`、`Cleanup`），即使是 public 也要排除。產生 README 前，必須先為每個公開方法決定「最終功能名稱」：
    - 預設功能名稱為 `Type.Method`。
    - 若公開方法所在的型別簡名在不同專案或不同命名空間中重複，最終功能名稱不得只使用 `Type.Method`，必須在型別前加入可辨識的專案或模組前綴，格式為 `Module.Type.Method`。例如 `Hangfire.ServiceCollectionExtension.AddHangfireOptions`、`Hangfire.SqlServer.ServiceCollectionExtension.AddSqlServerHangfire`、`Swagger.ServiceCollectionExtension.AddSwagger`、`Swagger.ApplicationBuilderExtension.UseSwaggerUI`。
    - 模組前綴優先取專案名稱、套件名稱或命名空間中最短且能區分同名型別的一段或多段名稱；若專案名稱與命名空間都可用，優先選擇對使用者最能辨識功能所屬模組的名稱。不得只靠遞增數字、隱藏 suffix 或不可見字元處理重複名稱。
    - 若同一個最終功能名稱仍因多載或同名方法重複，需在標題文字中加入可讀且語意明確的參數摘要，例如 `Module.Type.Method(string name, int count)`；同樣不得使用單純數字 suffix 當主要解法。
    - 最終功能名稱、使用範例標題、功能描述與任何會輸出到 Markdown 表格、Markdown link text 或 heading 的文字，若包含 C# 泛型角括號，輸出前必須先做 Markdown/HTML 安全跳脫：`<` 轉為 `&lt;`，`>` 轉為 `&gt;`。例如 `ResponseModelExtension.WithData<TData>` 必須輸出為 `ResponseModelExtension.WithData&lt;TData&gt;`，`ResponseModelExtension.WithData(ResponseModel<object>)` 必須輸出為 `ResponseModelExtension.WithData(ResponseModel&lt;object&gt;)`。不得在表格、link text 或 heading 中輸出裸 `WithData<TData>`、`ResponseModel<object>`、`Dictionary<string, object>` 這類泛型片段。
    - README 內部 anchor id 必須用未跳脫的最終功能名稱產生安全 slug，再移除或正規化泛型標點；anchor id 不使用 `&lt;` 或 `&gt;`。例如 `ResponseModelExtension.WithData<TData>` 的 anchor 可為 `responsemodelextensionwithdatatdata`，`ResponseModelExtension.WithData(ResponseModel<object>)` 的 anchor 可為 `responsemodelextensionwithdataresponsemodelobject`。同一個功能在功能列表與使用範例中必須共用同一個 anchor。
-   README 內容拆成兩個主要區塊：
-   - 功能列表：依專案名稱分組；每個專案使用一張 Markdown 表格呈現公開方法，欄位固定為「功能名稱」、「功能描述」。功能名稱顯示已跳脫的最終功能名稱，並需做成 Markdown 連結，導向目標專案 git `origin` 遠端上的對應檔案 function 起始行；功能描述使用已跳脫的簡單版描述，並做成 Markdown 連結，導向同一份 README 內「使用範例」區塊中該功能的標題錨點。
+   README 內容拆成三個主要區塊：
+   - 專案列表：必須放在功能列表前；依專案名稱列出每個非測試專案，使用 Markdown 表格呈現，欄位固定為「專案名稱」、「專案描述」、「參考專案列表」、「NuGet 套件列表」。專案描述要根據該專案公開功能列表推測總結，不要只複製專案名稱；若專案沒有可列出的公開功能，保守描述為「此專案未公開可列入 README 的功能」。參考專案列表列出該專案的 ProjectReference，格式為 `名稱 版本`，版本優先讀取被參考專案檔中的 `Version`、`PackageVersion`、`AssemblyVersion`，都沒有時寫 `未指定`；沒有參考專案時寫 `無`。NuGet 套件列表列出該專案的 PackageReference，格式為 `名稱 版本`，版本優先讀取 PackageReference 的 `Version` 屬性或子節點，其次讀取中央套件管理檔（例如 `Directory.Packages.props`）的對應版本，仍無法取得時寫 `未指定`；沒有 NuGet 套件時寫 `無`。多個項目以 `<br>` 分隔。
+   - 功能列表：放在專案列表後並依專案名稱分組；每個專案使用一張 Markdown 表格呈現公開方法，欄位固定為「功能名稱」、「功能描述」。功能名稱顯示已跳脫的最終功能名稱，並需做成 Markdown 連結，導向目標專案 git `origin` 遠端上的對應檔案 function 起始行；功能描述使用已跳脫的簡單版描述，並做成 Markdown 連結，導向同一份 README 內「使用範例」區塊中該功能的標題錨點。
    - 使用範例：每個功能各有一個標題，標題文字使用同一個已跳脫的最終功能名稱；標題前必須放置 `<a id="..."></a>`。`id` 必須由未跳脫的最終功能名稱產生安全 slug，且功能列表中功能描述連結的 `#anchor` 必須與對應使用範例標題前的 `<a id="anchor"></a>` 完全一致。完整版功能描述可依草稿的行為分析、`<summary>`、`<param>`、`<remarks>` 整理並完成必要跳脫；使用範例需展示典型呼叫方式、重要前置條件與預期結果。若無法可靠產生可執行範例，提供保守的情境式範例並標註需人工確認。
    功能名稱連結必須以執行此 skill 的目標專案為準，先用 `git remote get-url origin` 取得遠端，再搭配目前分支、檔案相對於目標專案根目錄的路徑與 function 起始行號產生，不得使用本 skill repo、工作區外 repo 或硬編碼的外部 repo 座標。若 origin 是 SSH 格式（例如 `git@gitea.example.com:owner/repo.git`），需轉為對應 HTTPS 瀏覽 URL；若 origin 已是 HTTPS，沿用同一個 host 與 repo path，並移除尾端 `.git`。Gitea 類網址使用 `/src/branch/<branch>/<path>#L123`，GitHub 類網址使用 `/blob/<branch>/<path>#L123`；無法可靠判斷平台時，優先採 Gitea 格式。若無法可靠解析目標專案的 `origin` 遠端、目前分支、檔案路徑或行號，才退回純文字功能名稱；README 不必列出內部呼叫方法。
 8. README 重建完成後，必須自動檢查 README 內部錨點一致性；檢查未通過時要先修正 README 再清理草稿。至少確認：
+   - 專案列表必須存在於功能列表之前，且欄位必須包含「專案名稱」、「專案描述」、「參考專案列表」、「NuGet 套件列表」。
    - 功能列表中的每個功能描述連結 `#anchor` 都存在完全相同的 `<a id="anchor"></a>`。
    - 使用範例區塊中沒有重複的 `<a id="..."></a>`。
    - 使用範例區塊中沒有未被功能列表引用的 anchor。