Knowledge Feedback

知識回饋

掃描子專案踩坑紀錄，分類並提出公司規範修改建議。

使用方式

/knowledge-feedback

參數

無（操作所有已知子專案）

前置條件

• 必須使用「公司知識管理者」(company-manager) Agent 開啟 Session
• 系統提示詞中已注入子專案清單

執行步驟

階段 1: 收集踩坑紀錄

1. 從系統提示詞中取得子專案清單（含絕對路徑）
2. 依序讀取每個子專案的 .knowledge/postmortem-log.md
3. 讀取每個子專案的 .knowledge/coding-standards.md 了解專案現況

階段 2: 分類與標記

對每筆踩坑紀錄進行分類：

| 分類 | 判斷標準 | 處理方式 | |------|---------|---------| | 通用問題 | 會在多個專案重複發生、與特定技術棧無關 | 建議更新公司規範 | | 專案特定 | 僅與該專案的技術選擇或架構有關 | 僅供參考，不更新公司規範 | | 已處理 | 已在公司規範中有對應規則 | 跳過 |

通用性判斷標準

判斷一筆踩坑紀錄是否具有通用性（應提升為公司規範），使用以下標準：

| 條件 | 判斷 | |------|------| | 同類問題出現在 ≥2 個專案 | 強通用 → 必須寫入 postmortem-common.md | | 問題與框架/語言無關（如 Git 操作、CI 流程） | 通用 → 建議寫入 | | 問題根因是架構設計或流程規範缺失 | 通用 → 建議寫入 | | 問題僅因特定版本/套件 bug | 專案特定 → 不寫入 | | 問題已在公司規範中有對應規則 | 已處理 → 跳過 |

階段 3: 產出摘要報告

輸出以下格式的報告：

# 跨專案知識回饋報告

**掃描日期**: {today}
**掃描專案數**: {count}

## 通用問題（建議更新公司規範）

| # | 來源專案 | 問題摘要 | 分類 | 建議更新的規範文件 | 建議內容 |
|---|---------|---------|------|------------------|---------|
| 1 | {project} | {summary} | {category} | {file} | {suggestion} |

## 專案特定問題（僅供參考）

| # | 來源專案 | 問題摘要 | 備註 |
|---|---------|---------|------|
| 1 | {project} | {summary} | {note} |

## 建議的規範修改

### 修改 1: {file}

**原因**: {why}

**建議新增/修改的內容**:
{diff or new content}

階段 4: 等待老闆確認

• 將報告呈報老闆
• 不得自行修改任何檔案，等待老闆逐項確認
• 老闆可能：全部接受 / 部分接受 / 全部拒絕 / 提出修改意見

階段 5: 執行更新

老闆確認後：

1. 修改 .knowledge/company/ 下的對應文件
2. 每個修改都說明：改了什麼、為什麼、影響範圍
3. 更新完成後，整理變更摘要
4. 對標記為「強通用」或「通用」的踩坑紀錄，寫入 .knowledge/company/standards/postmortem-common.md，格式：

| 日期 | 來源專案 | 分類 | 問題摘要 | 解法 | 相關規範 | |------|---------|------|---------|------|---------| | {date} | {project} | {category} | {summary} | {solution} | {reference} |

可寫入的路徑

• .knowledge/company/sop/*.md
• .knowledge/company/standards/*.md
• .knowledge/company/standards/postmortem-common.md
• .knowledge/company/templates/*.md

不可寫入的路徑

• 子專案的任何檔案（唯讀）
• .knowledge/company/skill-templates/（Skill 模板由開發流程管理）
• .knowledge/company/project-templates/（專案模板由開發流程管理）

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Stanshy
• Source: Stanshy/AgentHub
• License: MIT
• Homepage: https://agenthub.stanshy.com/

Install and usage instructions live in the source repository linked above.