doc-issues 系列 skill 加入不落地檔案絕對準則並調整 sync 專案查詢 #29

2026-07-14T06:46:46Z

jiantw83 commented

2026-07-14 06:46:46 +00:00

變更摘要

doc-issues-sync 與 doc-issues-analyze 各加入一條「絕對準則（不可違反）」：全程不得在磁碟落地任何檔案（不建立 .docs/、不寫草稿檔、不寫暫存檔），所有中間成果只留在對話與 subagent 回傳值，最終只透過 tea 或 Gitea API 寫回議題正文／標籤／留言。doc-issues-analyze 明確保留唯一例外：使用者確認實作某議題後、在該議題範圍內對目標 repository 原始碼的正常程式修改與 git commit。
doc-issues-sync 專案查詢改法：因 tea 與 Gitea API 目前都無法直接查詢專案掛載的議題，改為「先取得該 repo 所有開啟中（open）議題，再過濾掉與此專案無關的議題」；無法判斷歸屬時以 AskUserQuestion 請使用者決定。
doc-issues-sync TODO 判斷準則：由「是否足以追蹤完成進度」改為「是否足以追蹤議題描述的需求」，補 TODO 亦須對應議題描述的需求。
對應更新 README 的 skill 說明，並將三份 plugin manifest 版本 bump 至 0.1.3。

影響範圍

skills/doc-issues-sync/SKILL.md：新增絕對準則、改寫第 1 步專案查詢、第 3～7 步全面改為不落地（subagent 回傳而非寫檔）、5.1 措辭。
skills/doc-issues-analyze/SKILL.md：新增絕對準則區塊。
README.md：doc-issues-sync／doc-issues-analyze 說明同步。
plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json：版本 0.1.2 → 0.1.3。

風險與注意事項

皆為 skill 定義與文件變更，無程式邏輯；各助理需更新 plugin 才會生效。
doc-issues-sync 對專案的「議題是否屬於此專案」目前依議題可取得的 project 關聯資訊比對，若 tea／API 完全取不到關聯，會走 AskUserQuestion 由使用者決定，屬預期行為。

🤖 Generated with Claude Code

## 變更摘要 - **`doc-issues-sync` 與 `doc-issues-analyze` 各加入一條「絕對準則（不可違反）」**：全程不得在磁碟落地任何檔案（不建立 `.docs/`、不寫草稿檔、不寫暫存檔），所有中間成果只留在對話與 subagent 回傳值，最終只透過 `tea` 或 Gitea API 寫回議題正文／標籤／留言。`doc-issues-analyze` 明確保留唯一例外：使用者確認實作某議題後、在該議題範圍內對目標 repository 原始碼的正常程式修改與 git commit。 - **`doc-issues-sync` 專案查詢改法**：因 `tea` 與 Gitea API 目前都無法直接查詢專案掛載的議題，改為「先取得該 repo 所有開啟中（open）議題，再過濾掉與此專案無關的議題」；無法判斷歸屬時以 AskUserQuestion 請使用者決定。 - **`doc-issues-sync` TODO 判斷準則**：由「是否足以追蹤完成進度」改為「是否足以追蹤**議題描述的需求**」，補 TODO 亦須對應議題描述的需求。 - 對應更新 README 的 skill 說明，並將三份 plugin manifest 版本 bump 至 `0.1.3`。 ## 影響範圍 - `skills/doc-issues-sync/SKILL.md`：新增絕對準則、改寫第 1 步專案查詢、第 3～7 步全面改為不落地（subagent 回傳而非寫檔）、5.1 措辭。 - `skills/doc-issues-analyze/SKILL.md`：新增絕對準則區塊。 - `README.md`：`doc-issues-sync`／`doc-issues-analyze` 說明同步。 - `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`：版本 `0.1.2` → `0.1.3`。 ## 風險與注意事項 - 皆為 skill 定義與文件變更，無程式邏輯；各助理需更新 plugin 才會生效。 - `doc-issues-sync` 對專案的「議題是否屬於此專案」目前依議題可取得的 project 關聯資訊比對，若 tea／API 完全取不到關聯，會走 AskUserQuestion 由使用者決定，屬預期行為。 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jiantw83 added 3 commits 2026-07-14 06:46:46 +00:00

feat(doc-issues skills): 加入不落地任何檔案的絕對準則，並改 sync 專案查詢為先撈 open 議題再過濾 0237bcf55d

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(README): 更新 doc-issues-sync／analyze 的不落地檔案與專案查詢說明 13666aeecd

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

chore(plugin 版本): bump 至 0.1.3 136d2e5729

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

jiantw83 added 2 commits 2026-07-14 07:08:20 +00:00

feat(doc-issues skills): 產生議題描述時盡量附 Mermaid 流程圖以協助理解議題 9de3ecd56c

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

chore(plugin 版本): bump 至 0.1.4 f02f5a1c5f

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

admin approved these changes 2026-07-14 07:09:09 +00:00

admin merged commit 3b22ccfdac into master

2026-07-14 07:09:11 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#29