| name | context-collector |
| description | 當 Codex 需要在 issue docs、specs、workspace prep、實作或工作流程路由之前,從 GitHub issues、使用者 briefs、QA 報告、branch 脈絡或聚焦的 repo 證據進行正規 issue context 蒐集時使用。在不修改 source、tests、specs、PRs 或 GitHub state 的前提下,產生或更新 .agent-output/context/<issue-id-or-slug>.md 作為 facts/inference/open-questions 的主要來源。 |
Context Collector
把此 skill 作為正規的 issue context 來源。
角色
- 角色:issue context 蒐集者。
- 策略:事實只蒐集一次,讓下游 skills 讀取同一來源。
可以修改
不可修改
- Production code。
- Tests。
docs/issues/*。
docs/issues/specs/*。
- PRs。
- GitHub 留言或 State。
輸入
接受任何 issue 來源:
- GitHub issue id。
- 使用者提供的 issue brief。
- QA 報告。
- Feature request。
- 當前 branch 脈絡。
- 既有 issue doc 或 spec 的更新請求。
工作流程
- 解析 subject。
- 視情況從 GitHub issue、使用者 brief、branch 脈絡、QA 證據與聚焦的 repo 檢視中讀取來源事實。
- 區分事實、推論與未解問題。
- 只檢視理解可能受影響區域所需的程式碼。
- 寫入或更新
.agent-output/context/<subject>.md。
- 在同一檔案內保留精簡的
History 表格。
- 回報 context 檔路徑,以及它是否已可供 issue doc、workspace prep 使用,或處於 blocked。
路徑規則
每個 subject 使用單一正規檔案:
- 有 issue id:
.agent-output/context/<ISSUE-ID>.md
- 無 issue id:
.agent-output/context/<slug>.md
不要在檔名加上 -context,因為資料夾本身已定義 artifact 類型。
若更新同一 subject,覆寫同一檔案並更新 History。不要建立 history/ 資料夾。
必要章節
使用此結構:
# <Subject> Context
## Source
## Summary
## Facts
## Code Observations
## Inference
## Open Questions
## Suggested Slug
## Handoff
## History
| Time | Change | Source | Notes |
| --- | --- | --- | --- |
Handoff 必須為以下之一:
issue-doc-ready
workspace-prep-ready
blocked
blocked 時附上 blocker 原因。
History 規則
- 每次 context 更新新增一列表格。
- 摘要變更、來源與注意事項。
- 不要貼上完整舊內容或完整來源文字。
輸出規則
- 主要語言:
zh-tw。
- 保留必要的
en-us 技術術語。
- 只回報 context 路徑、就緒度、blockers,與建議的下一個 skill。