plugins/doc
2
0
Fork 0
Code Pull Requests Activity

新增 doc-issues-analyze skill：讀 issue、拆解實作階段並交付留言 #25

Merged
admin merged 3 commits from develop into master 2026-07-03 03:37:43 +00:00
Conversation 1 Commits 3 Files Changed 5
+145 -9
jiantw83 commented 2026-07-03 03:23:15 +00:00
Member
Copy Link
Copy Source

變更摘要

新增第三個實作型 skill doc-issues-analyze，並同步更新 README 與各 plugin manifest（版本 bump 至 0.0.10）。

doc-issues-analyze 的流程：

  1. 讀取一或多筆 Gitea issue URL（優先用 tea，否則 Gitea REST API + curl + $GITEA_TOKEN，不依賴未安裝的 jq），彙整成一份完整需求文件。
  2. 依功能把需求拆成多個實作階段，每階段建立一個 issue，並沿用來源 issue 的里程碑與專案、依需求性質從既有標籤挑選填入。
  3. 配合使用者指定的 repositories 或 issue 所在 repo，對每個階段派 subagent 產生實作草稿。
  4. 產出交付文件並依 issues 分組留言到對應 issue。

建立 issue 與留言屬對外且不易復原的動作，skill 內設計為先產生全部草稿、再以 AskUserQuestion 讓使用者確認執行方式後才動 Gitea。

影響範圍

  • 純新增 skill 與文件／設定，不影響既有 doc-docker、doc-funcs 的行為。
  • 各助理（Claude Code / Codex / Antigravity / OpenCode）更新後可用 /jsc:doc-issues-analyze（或對應呼叫方式）觸發。

重點檔案／模組

  • skills/doc-issues-analyze/SKILL.md：新 skill 定義（9 階段流程 + 重要限制）。
  • README.md：intro 改為三個 skills、目錄樹、Skills 目錄新增條目、OpenCode 移除指令補上新 skill 目錄。
  • plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json：版本 0.0.9 → 0.0.10，描述補上 doc-issues-analyze。

風險或注意事項

  • skill 僅產生需求文件、階段 issue、實作草稿與交付留言，subagent 只讀程式碼、不修改原始碼。
  • 建立 issue／留言前一律先經使用者確認；留言與交付文件不得洩漏個資（PII）。
  • Gitea project API 是否可用視版本而定，不支援時 skill 會標註需人工於 UI 補掛。
## 變更摘要 新增第三個實作型 skill `doc-issues-analyze`，並同步更新 README 與各 plugin manifest（版本 bump 至 `0.0.10`）。 `doc-issues-analyze` 的流程： 1. 讀取一或多筆 Gitea issue URL（優先用 `tea`，否則 Gitea REST API + `curl` + `$GITEA_TOKEN`，不依賴未安裝的 `jq`），彙整成一份完整需求文件。 2. 依功能把需求拆成多個實作階段，每階段建立一個 issue，並沿用來源 issue 的里程碑與專案、依需求性質從既有標籤挑選填入。 3. 配合使用者指定的 repositories 或 issue 所在 repo，對每個階段派 subagent 產生實作草稿。 4. 產出交付文件並依 issues 分組留言到對應 issue。 建立 issue 與留言屬對外且不易復原的動作，skill 內設計為先產生全部草稿、再以 AskUserQuestion 讓使用者確認執行方式後才動 Gitea。 ## 影響範圍 - 純新增 skill 與文件／設定，不影響既有 `doc-docker`、`doc-funcs` 的行為。 - 各助理（Claude Code / Codex / Antigravity / OpenCode）更新後可用 `/jsc:doc-issues-analyze`（或對應呼叫方式）觸發。 ## 重點檔案／模組 - `skills/doc-issues-analyze/SKILL.md`：新 skill 定義（9 階段流程 + 重要限制）。 - `README.md`：intro 改為三個 skills、目錄樹、Skills 目錄新增條目、OpenCode 移除指令補上新 skill 目錄。 - `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`：版本 `0.0.9` → `0.0.10`，描述補上 `doc-issues-analyze`。 ## 風險或注意事項 - skill 僅產生需求文件、階段 issue、實作草稿與交付留言，subagent 只讀程式碼、不修改原始碼。 - 建立 issue／留言前一律先經使用者確認；留言與交付文件不得洩漏個資（PII）。 - Gitea `project` API 是否可用視版本而定，不支援時 skill 會標註需人工於 UI 補掛。
jiantw83 added 3 commits 2026-07-03 03:23:15 +00:00
feat(doc-issues-analyze): 新增讀取 issue 拆解實作階段並交付留言的 skill 9727fb5216 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(README): 補上 doc-issues-analyze skill 說明與目錄 c1f75b2a7c 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
chore(plugin 版本): bump 至 0.0.10 並補 doc-issues-analyze 描述 4396d31cf4 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
admin approved these changes 2026-07-03 03:37:40 +00:00
admin merged commit 9c94bca84e into master 2026-07-03 03:37:43 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/doc#25