tech-report-research

name	tech-report-research
description	當使用者要求建立「科技服務資訊週記」、整理近 15 天科技資訊、撰寫繁體中文技術報告，或依分類整理科技新聞時使用。此 skill 會依本 repo 內建的研究流程建立任務資料夾，並套用來源、格式、引用與知識庫規範。
version	1.0.0
author	Lazy Jerry
license	GPL-3.0-only

科技服務資訊週記 Skill

此 skill 用來在本專案中建立與執行「科技服務資訊週記」研究任務。

目的

把科技週報需求整理成可重複執行的流程，並將研究任務需要的核心工作流內建到本 repo，讓這個 skill 在沒有外部安裝的情況下也能獨立運作。

何時使用

• 使用者要求整理近 15 天科技新聞
• 使用者要求撰寫「科技服務資訊週記」
• 使用者要求建立繁體中文技術報告
• 使用者要求依分類整理科技服務資訊
• 使用者要求透過此 skill 執行技術研究或週記任務

執行流程

1. 啟動研究工作流

1. 先讀取本 repo 內建的 research workflow 文件：
   • references/file-structure.md
   • references/rules.md
   • references/knowledge-base.md
2. 以 weekly-tech-report 作為預設任務名稱，執行初始化腳本：
   • sh scripts/init-session.sh <工作區根目錄> weekly-tech-report
3. 初始化後，docs/tech-report-research/[任務名稱]-[流水號]/ 內應包含：
   • prompt.md
   • task_plan.md
   • notes.md
   • source.md
   • report.md

2. 載入本 skill 規格

初始化完成後，讀取以下專案文件作為任務規格：

• report-spec.md
• assets/weekly-report-template.md
• docs/tech-report-research/knowledge/index.md

若 knowledge/index.md 有匹配項目，再讀取對應知識檔案。

3. 寫入研究任務提示

先編輯 prompt.md 與 task_plan.md，再開始研究。prompt.md 至少填入以下內容：

• 今天日期
• 報告標題格式：YYYY-MM-DD 科技服務資訊週記
• Meta 格式：作者：{{目前使用的 AI 工具}}　報告日期：YYYY-MM-DD
• 讀者目標：程式設計師
• 必要分類
• 四大段落要求
• 來源時間範圍與權重規則
• source.md 蒐集格式要求
• 完成前檢查要求（分類完整性、資訊權重、搜尋時間範圍、資料來源正確性、內文引用編號與參考資料編號一致性、錯誤修正狀態）

內容請以 report-spec.md 為準，不要自行縮減需求。

task_plan.md 至少應包含以下階段：

1. 確認日期範圍與分類
2. 蒐集來源並整理 source.md
3. 依權重篩選正式參考資料
4. 檢查各分類是否缺漏
5. 撰寫總結、亮點、趨勢分析
6. 整理參考資料表與引用
7. 檢查分類完整性、資訊權重、搜尋時間範圍、資料來源正確性、內文引用編號與參考資料編號一致性，以及錯誤修正狀態
8. 依模板完成 report.md
9. 複製交付物到 tech/{指定日期}/

編輯完 prompt.md 與 task_plan.md 後，執行：

• sh scripts/validate-task-files.sh docs/tech-report-research/[任務名稱]-[流水號]

4. 建立 source.md

在研究過程中，所有候選來源先整理到 source.md，再決定是否納入 report.md。

source.md 的每筆資料至少包含：

• 來源網址
• 繁體中文標題
• 100 至 500 字繁體中文摘要
• 權重分數（1-10/10）
• 發布日期
• 分類
• 是否納入正式參考資料

5. 研究與撰寫規則

• 優先使用高權重且日期明確的來源
• 以台灣主流媒體與權威科技來源為優先參考
• 若來源無法確認在近 15 天內，直接排除
• 若分類資料不足，必須補搜
• source.md 應保留候選來源與淘汰判斷依據
• 所有內容需標註來源編號
• 引用、錨點、參考資料表格式需符合知識庫規範
• 文章內容必須使用繁體中文與台灣用語
• 完成前必須檢查分類完整性、資訊權重、搜尋時間範圍、資料來源正確性、內文引用編號與參考資料編號一致性，以及錯誤來源或整理內容是否已修正；實際內容以 report-spec.md 的「完成前檢查」為準
• 建立 report.md 時，請以 assets/weekly-report-template.md 作為起始模板，再依當期資料替換內容、日期與目前使用的 AI 工具名稱

6. 驗證與交付

每個重要階段開始前：

1. 檢查 docs/tech-report-research/knowledge/index.md 中是否有相關知識檔案需要參考或套用
2. 如有匹配項目，讀取相關知識檔案

交付前至少完成一次：

1. 檢查分類完整性、資訊權重、搜尋時間範圍、資料來源正確性、內文引用編號與參考資料編號一致性，以及錯誤修正狀態
2. 確認每個分類都有資料，或明確註記缺漏原因
3. 驗證任務資料夾檔案完整
4. 將成果複製到 tech/{指定日期}/

建議驗證指令：

• sh scripts/validate-task-files.sh docs/tech-report-research/[任務名稱]-[流水號]
• sh scripts/validate-task-completion.sh <工作區根目錄> [任務名稱]-[流水號]

{指定日期} 若使用者未另外指定，預設使用報告日期。

複製規則如下：

• report.md 複製並改名為 tech/{指定日期}/{指定日期} 科技服務資訊週記.md
• source.md 複製到 tech/{指定日期}/source.md
• task_plan.md 複製到 tech/{指定日期}/task_plan.md
• notes.md 另存為 tech/{指定日期}/note.md
• 蒐集完成的正式參考資料清單另存為 tech/{指定日期}/references.md

交付物

最終應至少包含：

• docs/tech-report-research/[任務名稱]-[流水號]/report.md
• docs/tech-report-research/[任務名稱]-[流水號]/source.md
• 更新後的 notes.md
• 更新後的 task_plan.md
• tech/{指定日期}/{指定日期} 科技服務資訊週記.md
• tech/{指定日期}/source.md
• tech/{指定日期}/task_plan.md
• tech/{指定日期}/note.md
• tech/{指定日期}/references.md

如過程中發現新的固定規則，需評估是否新增到 docs/tech-report-research/knowledge/。