# 步驟 1：前往 https://github.com/organizations/plan
# 步驟 2：選擇方案（建議 GitHub Enterprise）
# 步驟 3：填寫組織資訊

# 建議的 Team 結構
├── ai-assets-admins          # 管理員（2-3 人）
├── ai-assets-maintainers     # 維護者（5-8 人，各領域代表）
├── ai-assets-reviewers       # 審查者（10-15 人，資深工程師）
└── ai-assets-contributors    # 貢獻者（全體開發人員）

# 方式一：GitHub CLI（建議）
gh repo create {org}/ai-assets \
  --description "企業 AI 資產知識庫 — Agents / Skills / Instructions / Plugins / Hooks / Workflows / Prompts / 教學手冊" \
  --internal \
  --license MIT \
  --gitignore Node \
  --clone

# 方式二：透過 Web UI
# 前往 https://github.com/organizations/{org}/repositories/new

# Branch Protection Rules（main 分支）
gh api repos/{org}/ai-assets/branches/main/protection \
  --method PUT \
  --field required_status_checks='{"strict":true,"contexts":["validate-content","validate-readme"]}' \
  --field enforce_admins=true \
  --field required_pull_request_reviews='{"required_approving_review_count":2,"dismiss_stale_reviews":true}' \
  --field restrictions=null

# 啟用 GitHub Advanced Security（若 Enterprise 方案）
gh api repos/{org}/ai-assets \
  --method PATCH \
  --field security_and_analysis='{"secret_scanning":{"status":"enabled"},"secret_scanning_push_protection":{"status":"enabled"}}'

# 🤖 {Company} AI 資產知識庫

> 集中管理企業 AI 開發資產，加速團隊知識累積與 AI 協作效率

## 📋 快速導覽

| 分類 | 數量 | 說明 |
|------|------|------|
| 🤖 [Agents](agents/) | — | 專門化 AI 代理定義 |
| 📋 [Instructions](instructions/) | — | 編碼規範與標準（依 applyTo 模式自動套用） |
| 🎯 [Skills](skills/) | — | 自包含能力包（指令 + 腳本 + 資料） |
| 🔌 [Plugins](plugins/) | — | Agent + Skill + Command 整合套件 |
| 🪝 [Hooks](hooks/) | — | Copilot Coding Agent 自動化觸發動作 |
| ⚡ [Workflows](workflows/) | — | AI 驅動 GitHub Actions 自動化（Agentic Workflows） |
| 🍳 [Cookbook](cookbook/) | — | Copy-paste-ready API 操作配方 |
| 📝 [Prompts](prompts/) | — | 結構化 AI 提示詞模板 |
| 📖 [教學手冊](tutorials/) | — | 技術教學與工具使用指南 |
| 📄 [範本](templates/) | — | 可直接複用的文件與程式碼範本 |
| 📚 [LLM Wiki](llm-wiki/) | — | LLM 持續編譯的結構化知識庫（raw → wiki → 交叉引用） |

## 🚀 如何使用

### 安裝 Plugin

```bash
# 透過 GitHub Copilot CLI
copilot plugin install <plugin-name>@{org}/ai-assets

# 若 Marketplace 未註冊，先執行一次
copilot plugin marketplace add {org}/ai-assets
copilot plugin install <plugin-name>@{org}/ai-assets

# Dependencies
node_modules/
.pnp.*

# Build outputs
dist/
build/
.next/

# IDE
.vscode/settings.json
.idea/

# OS
.DS_Store
Thumbs.db

# Secrets (嚴禁提交)
.env
.env.local
*.key
*.pem

# Logs
*.log
npm-debug.log*

# 統一換行符號
* text=auto eol=lf

# Markdown
*.md text eol=lf

# YAML
*.yml text eol=lf
*.yaml text eol=lf

# JSON
*.json text eol=lf

# Shell
*.sh text eol=lf

# Generated files (不納入 diff)
*.lock.yml linguist-generated=true
docs/README.*.md linguist-generated=true

root = true

[*]
charset = utf-8
end_of_line = lf
indent_style = space
indent_size = 2
insert_final_newline = true
trim_trailing_whitespace = true

[*.md]
trim_trailing_whitespace = false

[Makefile]
indent_style = tab

# 完整初始化流程
cd ai-assets

# 建立分支策略
git checkout -b staged
git push -u origin staged

# 建立目錄結構（對齊 awesome-copilot + 企業自建分類）
mkdir -p agents instructions skills plugins hooks workflows cookbook
mkdir -p prompts tutorials templates
mkdir -p .github/workflows .github/ISSUE_TEMPLATE .github/plugin
mkdir -p docs eng scripts data _templates

# 建立 LLM Wiki 目錄結構（詳見第 11 章）
mkdir -p llm-wiki/{raw,wiki/{tools,concepts,comparisons,analysis},schema,reports}

# 建立初始檔案
touch agents/.gitkeep
touch instructions/.gitkeep
touch skills/.gitkeep
touch plugins/.gitkeep
touch hooks/.gitkeep
touch workflows/.gitkeep
touch cookbook/.gitkeep
touch prompts/.gitkeep
touch tutorials/.gitkeep
touch templates/.gitkeep

# 建立 AGENTS.md（供 AI Agent 理解專案結構）
cat > AGENTS.md << 'EOF'
## Project Overview
企業 AI 資產知識庫，參考 github/awesome-copilot 架構設計。

## Repository Structure
- agents/ — AI 代理定義（*.agent.md）
- instructions/ — 編碼規範（*.instructions.md）
- skills/ — 能力包（{folder}/SKILL.md）
- plugins/ — 可安裝套件（{folder}/plugin.json）
- hooks/ — 自動化觸發（{folder}/hooks.json）
- workflows/ — Agentic Workflows（*.md）
- cookbook/ — API 操作配方
- prompts/ — Prompt 模板
- tutorials/ — 教學手冊
- templates/ — 文件範本
- llm-wiki/ — LLM Wiki 知識庫（raw → wiki → 交叉引用）
  - llm-wiki/raw/ — 原始資料（不可變，僅新增）
  - llm-wiki/wiki/ — LLM 編譯的知識頁面
  - llm-wiki/schema/ — Wiki Schema 定義（CLAUDE.md）
  - llm-wiki/reports/ — Lint 報告

## Setup Commands
npm ci
npm run build

## Development Workflow
All PRs must target the `staged` branch.
EOF

# 建立 LLM Wiki Schema（CLAUDE.md）
cat > llm-wiki/schema/CLAUDE.md << 'WIKIEOF'
# CLAUDE.md — LLM Wiki Schema

## Project Overview
本目錄為 LLM 持續編譯的結構化知識庫。

## Directory Structure
- raw/ — 原始資料（不可變，僅新增）
- wiki/ — LLM 編譯的知識頁面
- schema/ — 架構定義
- reports/ — Lint 報告

## Naming Conventions
- Raw: `raw/{YYYY-MM-DD}-{source-type}-{slug}.md`
- Wiki: `wiki/{category}/{slug}.md`
- 分類目錄：tools / concepts / comparisons / analysis

## Ingest Workflow
1. 將原始資料存入 raw/
2. 解析與分類
3. 更新或建立 wiki/ 中的相關頁面
4. 更新 wiki/index.md
5. 記錄至 wiki/log.md
6. 提交 Git

## Lint Rules
- 矛盾偵測：檢查頁面間矛盾陳述
- 過時檢查：標記 > 90 天未更新的頁面
- 孤立頁面：無任何交叉引用的頁面
- 缺失引用：網狀分析缺少的連結

## Quality Standards
- 每頁必含：# 標題、> 一行摘要、## 來源（含 provenance hash）
- 每頁至少 3 個交叉引用連結
- 未驗證內容標註 [unverified]
- 保留原始來源雜湊值供追溯
WIKIEOF

# 建立空索引與日誌
cat > llm-wiki/wiki/index.md << 'IDXEOF'
# Wiki 索引

（尚無內容）

---
最後更新：$(date +%Y-%m-%d)
總頁數：0
IDXEOF

cat > llm-wiki/wiki/log.md << 'LOGEOF'
# 操作日誌

（尚無操作記錄）
LOGEOF

# 建立 Codex 相容 symlink
# Linux / macOS
ln -s schema/CLAUDE.md llm-wiki/AGENTS.md
# Windows（以管理員權限執行）
# mklink llm-wiki\AGENTS.md llm-wiki\schema\CLAUDE.md

# 初始化 package.json
npm init -y
npm install gray-matter glob

# 驗證 Scaffolding 指令可用
npm run skill:create    # 快速建立合規的 Skill 骨架（互動式）
npm run plugin:create   # 快速建立合規的 Plugin 骨架（互動式）

# 提交前修正換行符號（跨平台一致性）
bash eng/fix-line-endings.sh

# 提交
git add -A
git commit -m "chore: initialize AI assets repository structure"
git push origin staged

# 建立 PR 合併至 main
gh pr create --base main --head staged --title "chore: initialize repository" --body "Initial repository setup"

ai-assets/
├── README.md                          # 主頁（動態生成表格索引）
├── CONTRIBUTING.md                    # 貢獻指南
├── AGENTS.md                          # AI Agent 專用專案說明
├── CODE_OF_CONDUCT.md                 # 行為準則
├── SECURITY.md                        # 安全政策
├── LICENSE                            # 授權條款
├── SUPPORT.md                         # 支援政策
├── package.json                       # 建構工具依賴
├── llms.txt                           # 機器可讀索引（供 AI Agent 消費）
├── context7.json                      # Context7 整合設定（選用）
├── .gitignore
├── .gitattributes
├── .editorconfig
├── .codespellrc                       # 拼字檢查設定
│
├── agents/                            # 🤖 AI 代理定義
│   ├── java-refactoring.agent.md
│   ├── security-scanner.agent.md
│   ├── code-reviewer.agent.md
│   └── ...
│
├── instructions/                      # 📋 編碼規範（依 applyTo 自動套用）
│   ├── java-spring-boot.instructions.md
│   ├── vue-typescript.instructions.md
│   ├── sql-database.instructions.md
│   └── ...
│
├── skills/                            # 🎯 能力包（遵循 agentskills.io spec）
│   ├── unit-test-generator/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   ├── references/
│   │   └── assets/
│   ├── api-doc-generator/
│   └── ...
│
├── plugins/                           # 🔌 可安裝套件（Claude Code spec）
│   ├── enterprise-java/
│   │   ├── .github/plugin/plugin.json
│   │   └── README.md
│   ├── frontend-vue/
│   └── external.json                  # 外部 Plugin 註冊表
│
├── hooks/                             # 🪝 自動化觸發
│   ├── session-init/
│   │   ├── README.md
│   │   ├── hooks.json
│   │   └── init-script.sh
│   ├── tool-guardian/
│   └── ...
│
├── workflows/                         # ⚡ Agentic Workflows（gh aw 編譯）
│   ├── pr-auto-review.md
│   ├── daily-issues-report.md
│   ├── weekly-comment-sync.md
│   └── ...
│
├── cookbook/                           # 🍳 API 操作配方
│   ├── error-recovery-hooks/
│   ├── copilot-api-examples/
│   └── ...
│
├── prompts/                           # 📝 Prompt 模板（企業自建）
│   ├── code-review/
│   │   └── prompt.md
│   ├── reverse-engineering/
│   │   └── prompt.md
│   ├── architecture-design/
│   │   └── prompt.md
│   └── ...
│
├── tutorials/                         # 📖 教學手冊（企業自建）
│   ├── claude-code-教學手冊.md
│   ├── copilot-ssdlc-教學手冊.md
│   ├── mcp-教學手冊.md
│   └── ...
│
├── templates/                         # 📄 文件範本（企業自建）
│   ├── system-analysis/
│   ├── architecture-design/
│   └── project-plan/
│
├── llm-wiki/                          # 📚 LLM Wiki 知識庫（詳見第 11 章）
│   ├── AGENTS.md -> schema/CLAUDE.md  # Codex 相容 symlink
│   ├── schema/
│   │   └── CLAUDE.md                  # Wiki Schema 定義
│   ├── raw/                           # 原始資料（不可變，僅新增）
│   │   └── .gitkeep
│   ├── wiki/                          # LLM 編譯的知識頁面
│   │   ├── index.md                   # 內容索引
│   │   ├── log.md                     # 操作日誌
│   │   ├── tools/                     # 工具與平台
│   │   ├── concepts/                  # 概念與模式
│   │   ├── comparisons/               # 對照表
│   │   └── analysis/                  # 分析與決策
│   └── reports/                       # Lint 報告
│       └── .gitkeep
│
├── docs/                              # 📚 自動生成文件
│   ├── README.agents.md
│   ├── README.skills.md
│   ├── README.instructions.md
│   ├── learning-hub/                  # 學習中心
│   └── tools/                         # 工具與 MCP Server 索引
│
├── eng/                               # 🔧 建構腳本
│   ├── update-readme.mjs
│   ├── generate-marketplace.mjs
│   ├── validate-content.mjs
│   ├── fix-line-endings.sh
│   └── ...
│
├── scripts/                           # 🛠️ 公用腳本
│   ├── lint-frontmatter.mjs
│   └── ...
│
├── .schemas/                          # 📐 JSON Schema 定義
│   ├── plugin.schema.json
│   ├── hooks.schema.json
│   └── ...
│
├── .vscode/                           # 🖥️ VS Code 設定
│   ├── tasks.json                     # 快速新增 Agent/Skill 的 Task
│   └── settings.json
│
├── .github/                           # ⚙️ GitHub 配置
│   ├── workflows/
│   │   ├── validate-content.yml
│   │   ├── validate-readme.yml
│   │   ├── publish.yml
│   │   ├── staleness-report.yml
│   │   ├── contributors.yml
│   │   ├── security-scan.yml
│   │   └── ...
│   ├── ISSUE_TEMPLATE/
│   │   ├── new-agent.yml
│   │   ├── new-skill.yml
│   │   └── bug-report.yml
│   ├── PULL_REQUEST_TEMPLATE.md
│   ├── CODEOWNERS
│   ├── labeler.yml
│   └── plugin/
│       └── marketplace.json           # 自動生成
│
├── _templates/                        # 📋 空白模板（供貢獻者複製）
│   ├── agent.template.md
│   ├── instruction.template.md
│   ├── skill.template/
│   └── ...
│
└── data/                              # 📊 設定與 Metadata
    ├── config.json
    └── tags.json                      # 標準化標籤清單

agents/
├── java-refactoring.agent.md          # Java 重構代理
├── security-scanner.agent.md          # 安全掃描代理
├── code-reviewer.agent.md             # Code Review 代理
├── database-optimizer.agent.md        # DB 優化代理
├── api-designer.agent.md              # API 設計代理
└── legacy-analyzer.agent.md           # 舊系統分析代理

instructions/
├── java-spring-boot.instructions.md   # applyTo: '**/*.java'
├── vue-typescript.instructions.md     # applyTo: '**/*.{vue,ts}'
├── sql-database.instructions.md       # applyTo: '**/*.sql'
├── python-fastapi.instructions.md     # applyTo: '**/*.py'
├── markdown-docs.instructions.md      # applyTo: '**/*.md'
└── dockerfile.instructions.md         # applyTo: '**/Dockerfile*'

skills/
├── unit-test-generator/
│   ├── SKILL.md                       # 能力說明與使用方式
│   ├── scripts/
│   │   ├── generate-junit5.sh
│   │   └── generate-vitest.sh
│   ├── references/
│   │   ├── junit5-patterns.md
│   │   └── testing-best-practices.md
│   └── assets/
│       └── test-template.java
├── api-doc-generator/
└── db-migration-helper/

plugins/
├── enterprise-java/
│   ├── .github/plugin/plugin.json     # name, description, version, agents[], commands[], skills[]
│   └── README.md
├── frontend-vue/
│   ├── .github/plugin/plugin.json
│   └── README.md
└── external.json                      # 外部 Plugin 註冊表（GitHub/npm/pip/git）

hooks/
├── session-init/
│   ├── README.md                      # name, description, tags
│   ├── hooks.json                     # hook 事件設定
│   └── init-script.sh                 # 可執行腳本（需 chmod +x）
├── tool-guardian/
│   ├── README.md
│   ├── hooks.json
│   └── guardian.sh
└── ...

workflows/
├── pr-auto-review.md                  # AI 驅動 PR 自動審查
├── daily-issues-report.md             # 每日 Issue 報告
├── weekly-comment-sync.md             # 每週留言同步
└── ...

cookbook/
├── error-recovery-hooks/              # 錯誤恢復 Hook 配方
├── copilot-api-examples/              # Copilot API 操作範例
└── ...

prompts/
├── code-review/
│   └── prompt.md                      # Code Review 用 Prompt
├── reverse-engineering/
│   └── prompt.md                      # 逆向工程用 Prompt
├── architecture-design/
│   └── prompt.md                      # 架構設計用 Prompt
├── ssdlc/
│   ├── threat-modeling.md             # 威脅建模 Prompt
│   └── security-review.md            # 安全審查 Prompt
└── README.md                         # Prompt 使用指南

tutorials/
├── claude-code-教學手冊.md
├── copilot-ssdlc-教學手冊.md
├── mcp-教學手冊.md
├── warp-教學手冊.md
├── ai-governance-教學手冊.md
└── README.md                         # 教學手冊索引

templates/
├── system-analysis/
│   ├── requirements-spec.md           # 需求規格書範本
│   └── use-case-spec.md              # 使用案例規格書範本
├── architecture-design/
│   ├── architecture-doc.md            # 架構設計文件範本
│   └── api-spec.md                   # API 規格書範本
├── project-plan/
│   └── migration-plan.md             # 架構轉換計畫範本
└── README.md                         # 範本索引

llm-wiki/
├── AGENTS.md -> schema/CLAUDE.md        # Codex 相容 symlink
├── schema/
│   └── CLAUDE.md                          # Wiki Schema 定義（目錄慣例、工作流、品質標準）
├── raw/                                   # 原始資料（不可變，僅新增）
│   ├── 2026-05-07-release-kubernetes-130.md
│   ├── 2026-05-06-meeting-arch-review.md
│   └── ...
├── wiki/                                  # LLM 編譯的知識頁面
│   ├── index.md                           # 內容索引（依分類組織）
│   ├── log.md                             # 操作日誌（時間線記錄）
│   ├── tools/                             # 工具與平台（如 redis.md、kubernetes.md）
│   ├── concepts/                          # 概念與模式（如 caching.md）
│   ├── comparisons/                       # 對照表（如 llm-providers-2026.md）
│   └── analysis/                          # 分析與決策（如 adr-001-cache-strategy.md）
└── reports/                               # Lint 報告（自動產生）
    └── wiki-lint-2026-05-07.md

---
name: 'Java Refactoring Agent'          # 人類可讀名稱（必填）
description: 'Java 程式碼重構代理，支援 Spring Boot 專案的自動化重構與現代化'
model: 'copilot'                         # 建議指定模型（copilot / claude-code）
tools:                                   # 建議指定可用工具
  - codebase
  - terminal
  - github
version: '1.0.0'
author: '{author-name}'
tags: [java, spring-boot, refactoring]
created: '2026-05-06'
updated: '2026-05-06'
status: active                           # active | deprecated | draft
---

---
description: 'Spring Boot 專案的編碼標準與規範'
applyTo: '**/*.java'                     # glob 模式（必填，需單引號）
tags: [java, spring-boot, coding-standards]
created: '2026-05-06'
updated: '2026-05-06'
---

---
name: unit-test-generator                # 必須與資料夾名一致（≤64 字元）
description: '自動生成 JUnit 5 / Vitest 單元測試，支援 mock 與 assertion 最佳實踐'
version: '1.0.0'
author: '{author-name}'
tags: [testing, junit5, vitest]
assets:
  - scripts/generate-junit5.sh
  - references/junit5-patterns.md
created: '2026-05-06'
updated: '2026-05-06'
---

{
  "name": "enterprise-java",
  "description": "企業級 Java 開發 Plugin，整合 Spring Boot Agent、編碼規範與測試生成",
  "version": "1.0.0",
  "agents": ["java-refactoring"],
  "commands": [],
  "skills": ["unit-test-generator"]
}

---
name: 'PR Auto Review'
description: 'AI 驅動的 Pull Request 自動審查工作流'
on:
  pull_request:
    types: [opened, synchronize]
permissions:
  pull-requests: write
  contents: read
safe-outputs:
  - pull_request.comment
---

---
name: code-review-prompt
description: '結構化 Code Review Prompt，涵蓋安全性、效能與可維護性'
tags: [code-review, security, performance]
model: [copilot, claude-code, codex]    # 適用的 AI 工具
difficulty: intermediate                 # beginner | intermediate | advanced
created: '2026-05-06'
updated: '2026-05-06'
---

---
name: claude-code-tutorial
title: 'Claude Code 教學手冊'
description: 'Claude Code 完整教學，涵蓋安裝、設定、SSDLC 整合與團隊導入'
tags: [claude-code, ai-development, ssdlc]
author: '{author-name}'
version: '1.0.0'
created: '2026-05-06'
updated: '2026-05-06'
status: active
---

---
name: '{Agent 顯示名稱}'
description: '{一行描述}'
model: 'copilot'
tools:
  - codebase
  - terminal
version: '1.0.0'
author: '{author}'
tags: [{tag1}, {tag2}]
created: '{date}'
updated: '{date}'
status: active
---

# {Agent 名稱}

## 概述

{Agent 的用途與適用場景}

## 知識來源

<knowledge_sources>
- {相關文件、API 文件、編碼規範}
</knowledge_sources>

## 工作流程

<workflow>
1. {步驟 1}
2. {步驟 2}
3. {步驟 3}
</workflow>

## 使用方式

```bash
# 在 VS Code Copilot Chat 中
@{agent-name} {指令}

#### 4.3.2 Instruction 模板

```markdown
---
name: {instruction-name}
description: '{一行描述}'
applyTo: '{glob-pattern}'
tags: [{tag1}, {tag2}]
created: '{date}'
updated: '{date}'
---

# {規範名稱}

## 適用範圍

本規範適用於符合 `{applyTo}` 模式的所有檔案。

## 編碼標準

### {標準 1}

{說明與範例}

### {標準 2}

{說明與範例}

## 範例

### ✅ 正確做法

```text
// Good example

// Bad example

#### 4.3.3 Skill 模板

```markdown
---
name: {skill-name}
description: '{一行描述（10-1024 字元）}'
version: '1.0.0'
author: '{author}'
tags: [{tag1}, {tag2}]
assets:
  - scripts/{script-file}
  - references/{ref-file}
created: '{date}'
updated: '{date}'
---

# {Skill 名稱}

## 用途

{Skill 的目的與適用場景}

## 使用時機

- {場景 1}
- {場景 2}

## 輸入

| 參數 | 類型 | 必填 | 說明 |
|------|------|------|------|
| {param1} | {type} | ✅ | {說明} |

## 輸出

{輸出說明}

## 範例

```bash
# 使用範例

#### 4.3.4 Prompt 模板

```markdown
---
name: {prompt-name}
description: '{一行描述}'
tags: [{tag1}, {tag2}]
model: [{model1}, {model2}]
difficulty: intermediate
created: '{date}'
updated: '{date}'
---

# {Prompt 名稱}

## 適用場景

{何時使用此 Prompt}

## Prompt 內容

## 使用說明

1. {步驟 1}
2. {步驟 2}

## 預期輸出

{AI 應該產出什麼}

## 變體

### 變體 A：{簡化版}

### 變體 B：{進階版}

## 注意事項

- {注意事項 1}
- {注意事項 2}

# {Page Title}

> {one-line summary}

## 概述

{主要內容}

## 關鍵要點

- {要點 1}
- {要點 2}

## 相關頁面

- [Related Page 1](../category/slug.md)
- [Related Page 2](../category/slug.md)
- [Related Page 3](../category/slug.md)

## 來源

- `raw/YYYY-MM-DD-source-type-slug.md` — SHA256: `{hash}`
- 狀態：[verified] / [unverified]
- 最後更新：{YYYY-MM-DD}

# {Raw Source Title}

來源：{URL 或來源說明}
日期：{YYYY-MM-DD}
來源類型：{release / meeting / article / paper / transcript}

---

{Original content, verbatim or lightly formatted}

# 貢獻指南（Contributing Guide）

感謝您願意為 AI 資產知識庫貢獻內容！請依照以下流程進行。

## 🚦 快速開始

### 步驟 1：選擇內容類型

| 類型 | 目錄 | 檔案格式 | 說明 |
|------|------|---------|------|
| Agent | `agents/` | `*.agent.md` | AI 代理定義 |
| Instruction | `instructions/` | `*.instructions.md` | 編碼規範 |
| Skill | `skills/{name}/` | `SKILL.md` + 資源 | 能力包 |
| Plugin | `plugins/{name}/` | `plugin.json` + `README.md` | 整合套件 |
| Hook | `hooks/{name}/` | `hooks.json` + `README.md` | 自動化觸發 |
| Workflow | `workflows/` | `*.md` | AI GitHub Actions |
| Prompt | `prompts/{name}/` | `prompt.md` | Prompt 模板 |
| 教學手冊 | `tutorials/` | `*.md` | 技術教學 |
| 範本 | `templates/{category}/` | `*.md` | 文件範本 |
| Wiki Raw | `llm-wiki/raw/` | `{date}-{type}-{slug}.md` | LLM Wiki 原始資料 |

> **LLM Wiki 貢獻說明**：Wiki 的貢獻方式與其他分類不同——貢獻者只需將原始資料放入 `llm-wiki/raw/`，再以 LLM 執行 Ingest 即可自動產生或更新 Wiki 頁面。詳見 [**§11.3 核心操作流程**](#113-核心操作流程)。

### 步驟 2：遵循命名慣例

- 檔案名稱使用**小寫 + 連字號**（如 `java-refactoring.agent.md`）
- 資料夾名稱使用**小寫 + 連字號**（如 `unit-test-generator/`）
- 教學手冊可使用中文（如 `claude-code-教學手冊.md`）

### 步驟 3：填寫 Frontmatter

所有內容必須包含 YAML Frontmatter，請參考 `_templates/` 目錄中的模板。

### 步驟 4：建立 Pull Request

- **目標分支**：`staged`（非 `main`）
- 使用 PR Template 填寫 Checklist
- 附上內容截圖或使用範例
- **AI Agent PR**：若由 AI Coding Agent（如 Copilot Coding Agent）產生的 PR，請在標題加上 🤖🤖🤖 標記，將獲得快速審查通道

### 步驟 5：等待審查

- 自動化檢查會在 PR 建立後自動執行
- 至少需要 2 位 Maintainer 核准（AI Agent PR 可降為 1 位）
- 若有修改建議，請在原 PR 上更新

## ⚠️ 重要規則

1. **禁止提交敏感資料**：API Key、密碼、內部 IP 等
2. **禁止提交付費服務推廣**：除非經管理員核准
3. **必須經過測試**：所有 Agent / Skill 需在 GitHub Copilot 中實際測試
4. **保持一致性**：遵循現有內容的風格與格式
5. **External Plugin 限制**：企業內部知識庫禁止安裝未經審核的外部 Plugin。awesome-copilot 官方僅接受來自 Microsoft / GitHub repos 的外部 Plugin，企業應更加嚴格
6. **分支規範**：所有功能分支必須從 `staged` 建立（`git checkout -b feature/xxx staged`），嚴禁從 `main` 分支開分支

## 📝 內容說明

<!-- 簡述此 PR 新增或修改的內容 -->

## 📋 內容類型

<!-- 請勾選適用的類型 -->

- [ ] 🤖 Agent
- [ ] 📋 Instruction
- [ ] 🎯 Skill
- [ ] 🔌 Plugin
- [ ] 🪝 Hook
- [ ] ⚡ Workflow
- [ ] 📝 Prompt
- [ ] 📖 教學手冊
- [ ] 📄 範本
- [ ] 🐛 Bug 修復
- [ ] 📝 文件更新

## ✅ 自我檢查清單

### 基本要求

- [ ] 已閱讀 [CONTRIBUTING.md](CONTRIBUTING.md)
- [ ] 內容放置在正確的目錄
- [ ] 檔案遵循命名慣例
- [ ] 包含完整的 YAML Frontmatter
- [ ] 內容結構清晰（使用 Markdown 標題層級）

### 品質要求

- [ ] 已在 GitHub Copilot / Claude Code 中實際測試
- [ ] 無敏感資料（API Key / 密碼 / 內部 IP）
- [ ] 無付費服務推廣內容
- [ ] 範例可正確執行

### 合規要求

- [ ] 符合公司 AI 使用政策
- [ ] 無版權爭議內容
- [ ] PR 目標為 `staged` 分支

## 📸 截圖 / 範例輸出

<!-- 若適用，請附上使用截圖或範例輸出 -->

## 🔗 相關連結

<!-- 相關 Issue、文件、參考資料 -->

name: 🤖 新增 Agent
description: 提議新增一個 AI Agent
title: "[Agent] "
labels: ["agent", "new-content"]
body:
  - type: input
    id: agent-name
    attributes:
      label: Agent 名稱
      placeholder: "java-refactoring"
    validations:
      required: true

  - type: textarea
    id: description
    attributes:
      label: 功能描述
      description: 此 Agent 要解決什麼問題？
    validations:
      required: true

  - type: dropdown
    id: category
    attributes:
      label: 分類
      options:
        - 程式開發
        - 程式碼審查
        - 安全掃描
        - 文件生成
        - 測試
        - 架構設計
        - 其他
    validations:
      required: true

  - type: textarea
    id: use-cases
    attributes:
      label: 使用場景
      description: 請列舉 2-3 個具體使用場景

  - type: checkboxes
    id: checklist
    attributes:
      label: 確認事項
      options:
        - label: 我已搜尋現有 Agent，確認無重複
          required: true
        - label: 我願意撰寫此 Agent 的內容

name: 📋 Validate Content

on:
  pull_request:
    branches: [staged]
    paths:
      - 'agents/**'
      - 'instructions/**'
      - 'skills/**'
      - 'plugins/**'
      - 'hooks/**'
      - 'workflows/**'
      - 'prompts/**'
      - 'tutorials/**'
      - 'templates/**'

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Validate file naming
        run: node eng/validate-naming.mjs

      - name: Validate frontmatter
        run: node eng/validate-frontmatter.mjs

      - name: Check for secrets
        run: node eng/check-secrets.mjs

      - name: Validate skill structure
        run: node eng/validate-skills.mjs

      - name: Validate plugin structure
        run: node eng/validate-plugins.mjs

      - name: Validate workflow syntax
        run: |
          # 驗證 Agentic Workflow 的 Frontmatter 格式
          # 阻擋 .yml / .lock.yml 檔案被提交到 workflows/ 目錄
          node eng/validate-workflows.mjs

      - name: Fix line endings
        run: bash eng/fix-line-endings.sh

name: 🎯 Check PR Target

on:
  pull_request:
    types: [opened, edited]

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - name: Verify PR targets staged branch
        if: github.event.pull_request.base.ref != 'staged'
        run: |
          echo "::error::PR 必須以 staged 分支為目標，而非 ${{ github.event.pull_request.base.ref }}"
          echo "請修改 PR 的 base branch 為 staged"
          exit 1

name: 📖 Update README

on:
  push:
    branches: [staged]
    paths:
      - 'agents/**'
      - 'instructions/**'
      - 'skills/**'
      - 'plugins/**'
      - 'prompts/**'
      - 'tutorials/**'
      - 'templates/**'
      - 'llm-wiki/wiki/**'

jobs:
  update:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Generate README tables
        run: node eng/update-readme.mjs

      - name: Generate category docs
        run: node eng/generate-docs.mjs

      - name: Commit changes
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add README.md docs/
          git diff --staged --quiet || git commit -m "docs: auto-update README and category docs"
          git push

name: 📊 Staleness Report

on:
  schedule:
    - cron: '0 3 * * 1'  # 每週一 UTC 03:00
  workflow_dispatch:

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Generate staleness report
        run: node eng/staleness-report.mjs

      - name: Create issue if stale content found
        uses: peter-evans/create-issue-from-file@v5
        with:
          title: "📊 每週過時內容報告"
          content-filepath: ./staleness-report.md
          labels: maintenance,staleness

name: 👥 Update Contributors

on:
  schedule:
    - cron: '0 3 * * 0'  # 每週日 UTC 03:00
  workflow_dispatch:

jobs:
  contributors:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Update contributors list
        uses: akhilmhdh/contributors-readme-action@v2.3.10
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

name: 🏷️ Label PR

on:
  pull_request:
    types: [opened]

jobs:
  label:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - name: Auto-label based on paths
        uses: actions/labeler@v5
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

# 需搭配 .github/labeler.yml

agent:
  - changed-files:
    - any-glob-to-any-file: 'agents/**'

instruction:
  - changed-files:
    - any-glob-to-any-file: 'instructions/**'

skill:
  - changed-files:
    - any-glob-to-any-file: 'skills/**'

plugin:
  - changed-files:
    - any-glob-to-any-file: 'plugins/**'

hook:
  - changed-files:
    - any-glob-to-any-file: 'hooks/**'

workflow:
  - changed-files:
    - any-glob-to-any-file: 'workflows/**'

prompt:
  - changed-files:
    - any-glob-to-any-file: 'prompts/**'

tutorial:
  - changed-files:
    - any-glob-to-any-file: 'tutorials/**'

template:
  - changed-files:
    - any-glob-to-any-file: 'templates/**'

name: 📚 Wiki Lint

on:
  schedule:
    - cron: '0 4 * * 1'  # 每週一 UTC 04:00
  workflow_dispatch:
  push:
    branches: [staged]
    paths:
      - 'llm-wiki/wiki/**'

jobs:
  lint:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Run Wiki Lint
        run: node eng/wiki-lint.mjs

      - name: Commit lint report
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add llm-wiki/reports/
          git diff --staged --quiet || git commit -m "docs: auto-generate wiki lint report"
          git push

      - name: Create issue if critical findings
        uses: peter-evans/create-issue-from-file@v5
        with:
          title: "📚 Wiki Lint Report - ${{ github.run_number }}"
          content-filepath: llm-wiki/reports/wiki-lint-latest.md
          labels: wiki-lint,automated
        if: hashFiles('llm-wiki/reports/wiki-lint-latest.md') != ''

import fs from 'fs/promises';
import path from 'path';
import matter from 'gray-matter';

const CATEGORIES = [
  { dir: 'agents', emoji: '🤖', label: 'Agents', ext: '.agent.md' },
  { dir: 'instructions', emoji: '📋', label: 'Instructions', ext: '.instructions.md' },
  { dir: 'skills', emoji: '🎯', label: 'Skills', file: 'SKILL.md' },
  { dir: 'plugins', emoji: '🔌', label: 'Plugins', file: 'plugin.json' },
  { dir: 'hooks', emoji: '🪝', label: 'Hooks', file: 'hooks.json' },
  { dir: 'workflows', emoji: '⚡', label: 'Workflows', ext: '.md' },
  { dir: 'prompts', emoji: '📝', label: 'Prompts', file: 'prompt.md' },
  { dir: 'tutorials', emoji: '📖', label: '教學手冊', ext: '.md' },
  { dir: 'templates', emoji: '📄', label: '範本', ext: '.md' },
  { dir: 'llm-wiki/wiki', emoji: '📚', label: 'LLM Wiki', ext: '.md', nested: true },
];

async function generateReadme() {
  let summaryTable = '| 分類 | 數量 | 說明 |\n|------|------|------|\n';

  for (const cat of CATEGORIES) {
    const items = await scanCategory(cat);
    summaryTable += `| ${cat.emoji} [${cat.label}](${cat.dir}/) | ${items.length} | ${cat.label} |\n`;
  }

  // 更新 README.md 中的表格區塊
  const readme = await fs.readFile('README.md', 'utf-8');
  const updated = readme.replace(
    /<!-- SUMMARY-TABLE:START -->[\s\S]*<!-- SUMMARY-TABLE:END -->/,
    `<!-- SUMMARY-TABLE:START -->\n${summaryTable}\n<!-- SUMMARY-TABLE:END -->`
  );
  await fs.writeFile('README.md', updated);
}

async function scanCategory(category) {
  const dirPath = path.resolve(category.dir);
  const entries = await fs.readdir(dirPath, { withFileTypes: true });
  const items = [];

  for (const entry of entries) {
    if (entry.name === '.gitkeep' || entry.name === 'README.md') continue;

    if (entry.isFile() && category.ext && entry.name.endsWith(category.ext)) {
      const content = await fs.readFile(path.join(dirPath, entry.name), 'utf-8');
      const { data } = matter(content);
      items.push({ name: data.name || entry.name, description: data.description || '', path: `${category.dir}/${entry.name}` });
    }

    if (entry.isDirectory() && category.file) {
      const skillPath = path.join(dirPath, entry.name, category.file);
      try {
        const content = await fs.readFile(skillPath, 'utf-8');
        const { data } = matter(content);
        items.push({ name: data.name || entry.name, description: data.description || '', path: `${category.dir}/${entry.name}/` });
      } catch { /* skip */ }
    }
  }

  return items;
}

generateReadme();

<!-- docs/README.agents.md（自動生成，勿手動修改） -->

# 🤖 Agents 索引

| 名稱 | 說明 | 標籤 | 更新日期 |
|------|------|------|---------|
| [java-refactoring](../agents/java-refactoring.agent.md) | Java 程式碼重構代理 | `java`, `spring-boot` | 2026-05-06 |
| [security-scanner](../agents/security-scanner.agent.md) | 安全掃描代理 | `security`, `sast` | 2026-05-06 |
| ... | ... | ... | ... |

{
  "version": "1.0.0",
  "generated": "2026-05-06T00:00:00Z",
  "plugins": [
    {
      "name": "enterprise-java",
      "description": "企業級 Java 開發整合套件",
      "version": "1.0.0",
      "source": "{org}/ai-assets/plugins/enterprise-java",
      "tags": ["java", "spring-boot", "enterprise"]
    }
  ],
  "external": []
}

# {Company} AI Assets Knowledge Base

## Agents
- java-refactoring: Java 程式碼重構代理，支援 Spring Boot 專案
- security-scanner: 安全掃描代理，整合 SAST/DAST
- code-reviewer: 自動化 Code Review 代理

## Instructions
- java-spring-boot: Spring Boot 編碼標準
- vue-typescript: Vue + TypeScript 元件規範

## Skills
- unit-test-generator: 自動生成 JUnit 5 / Vitest 單元測試
- api-doc-generator: 自動生成 OpenAPI 文件

## Prompts
- code-review: 結構化 Code Review Prompt
- reverse-engineering: 逆向工程分析 Prompt

## Tutorials
- claude-code-教學手冊: Claude Code 完整教學
- copilot-ssdlc-教學手冊: Copilot SSDLC 整合教學

## Wiki Knowledge Base
- tools/kubernetes: Kubernetes 平台知識（v1.30 含新功能）
- tools/redis: Redis 快取與資料結構
- concepts/caching: 快取策略與模式
- comparisons/llm-providers-2026: LLM 供應商比較（2026）

{
  "languages": ["java", "python", "typescript", "vue", "sql", "bash"],
  "frameworks": ["spring-boot", "fastapi", "vue3", "react", "junit5"],
  "domains": ["security", "testing", "code-review", "refactoring", "architecture"],
  "tools": ["copilot", "claude-code", "codex", "gemini", "mcp"],
  "processes": ["ssdlc", "devops", "ci-cd", "reverse-engineering"],
  "levels": ["beginner", "intermediate", "advanced"]
}

# Plugin 安裝指令（新版 Copilot CLI 已預設註冊 awesome-copilot marketplace）
copilot plugin install enterprise-java

# 若使用舊版 CLI 或企業內部 Marketplace，需先手動註冊來源
copilot plugin marketplace add --source {org}/ai-assets/plugins/enterprise-java

# 使用 Scaffolding 快速建立新 Plugin
npm run plugin:create

# 預設審查者
* @{org}/ai-assets-maintainers

# 各分類負責人
/agents/               @{org}/agent-team
/instructions/         @{org}/standards-team
/skills/               @{org}/skill-team
/plugins/              @{org}/plugin-team
/hooks/                @{org}/agent-team
/workflows/            @{org}/devops-team
/prompts/              @{org}/prompt-team
/tutorials/            @{org}/docs-team
/templates/            @{org}/docs-team

# LLM Wiki
/llm-wiki/schema/      @{org}/ai-assets-admins
/llm-wiki/             @{org}/wiki-team

# 基礎設施
/eng/                  @{org}/ai-assets-admins
/.github/              @{org}/ai-assets-admins

# 📊 AI 資產知識庫品質報告

**生成日期**：2026-05-06
**掃描範圍**：全部 9 個分類

## 📈 總覽

| 指標 | 數值 |
|------|------|
| 總資產數 | 120 |
| Active | 105 |
| Needs Update | 10 |
| Deprecated | 5 |
| 本週新增 | 3 |
| 本週更新 | 7 |

## ⚠️ 需關注項目

### 過時內容（> 90 天未更新）
- `agents/legacy-analyzer.agent.md` — 最後更新 120 天前
- `prompts/batch-migration/prompt.md` — 最後更新 95 天前

### 失效連結
- `tutorials/mcp-教學手冊.md` 第 45 行：https://example.com/dead-link

### Frontmatter 不完整
- `skills/db-migration/SKILL.md`：缺少 `version` 欄位

# .github/workflows/security-scan.yml
name: 🔒 Security Scan

on:
  pull_request:
    branches: [staged]

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Secret scanning
        uses: trufflesecurity/trufflehog@main
        with:
          extra_args: --only-verified

      - name: Check for hardcoded credentials
        run: |
          # 掃描常見的敏感資料模式
          if grep -rn "AKIA[0-9A-Z]\{16\}\|sk-[a-zA-Z0-9]\{48\}\|ghp_[a-zA-Z0-9]\{36\}" \
            --include="*.md" --include="*.json" --include="*.yml" .; then
            echo "::error::偵測到可能的敏感資料！請移除後重新提交。"
            exit 1
          fi

# 建立 Release
gh release create v1.0.0 \
  --title "v1.0.0 — 初始發佈" \
  --notes "## 新增內容
  - 10 個 Agents
  - 15 個 Instructions
  - 5 個 Skills
  - 8 個 Prompt Templates
  - 3 份教學手冊"

ai-assets/
├── README.md
├── CONTRIBUTING.md
├── AGENTS.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
├── SUPPORT.md
├── LICENSE
├── .gitignore
├── .gitattributes
├── .editorconfig
├── .codespellrc
├── package.json
├── llms.txt
├── context7.json
├── agents/
│   ├── README.md
│   └── {name}.agent.md
├── instructions/
│   ├── README.md
│   └── {name}.instructions.md
├── skills/
│   ├── README.md
│   └── {name}/
│       ├── SKILL.md
│       ├── scripts/
│       ├── references/
│       └── assets/
├── plugins/
│   ├── README.md
│   ├── external.json
│   └── {name}/
│       ├── .github/plugin/plugin.json
│       └── README.md
├── hooks/
│   ├── README.md
│   └── {name}/
│       ├── README.md
│       ├── hooks.json
│       └── *.sh
├── workflows/
│   ├── README.md
│   └── {name}.md
├── cookbook/
│   ├── README.md
│   └── {name}/
├── prompts/
│   ├── README.md
│   └── {name}/
│       └── prompt.md
├── tutorials/
│   ├── README.md
│   └── {name}.md
├── templates/
│   ├── README.md
│   └── {category}/
│       └── {name}.md
├── _templates/
│   ├── agent.template.md
│   ├── instruction.template.md
│   ├── skill.template/
│   ├── prompt.template.md
│   └── tutorial.template.md
├── docs/
│   ├── README.agents.md
│   ├── README.skills.md
│   ├── README.instructions.md
│   ├── README.prompts.md
│   ├── learning-hub/
│   └── tools/
├── eng/
│   ├── update-readme.mjs
│   ├── generate-docs.mjs
│   ├── generate-marketplace.mjs
│   ├── validate-naming.mjs
│   ├── validate-frontmatter.mjs
│   ├── validate-skills.mjs
│   ├── validate-plugins.mjs
│   ├── validate-workflows.mjs
│   ├── check-secrets.mjs
│   ├── fix-line-endings.sh
│   ├── staleness-report.mjs
│   ├── create-skill.mjs
│   ├── create-plugin.mjs
│   ├── validate-skill.mjs
│   ├── validate-plugin.mjs
│   ├── wiki-lint.mjs
│   └── wiki-stats.mjs
├── scripts/
│   ├── lint-frontmatter.mjs
│   └── ...
├── .schemas/
│   ├── plugin.schema.json
│   ├── hooks.schema.json
│   └── ...
├── .vscode/
│   ├── tasks.json
│   └── settings.json
├── .github/
│   ├── workflows/
│   │   ├── validate-content.yml
│   │   ├── check-pr-target.yml
│   │   ├── update-readme.yml
│   │   ├── staleness-report.yml
│   │   ├── contributors.yml
│   │   ├── wiki-lint.yml
│   │   ├── label-pr.yml
│   │   └── security-scan.yml
│   ├── ISSUE_TEMPLATE/
│   │   ├── new-agent.yml
│   │   ├── new-skill.yml
│   │   └── bug-report.yml
│   ├── PULL_REQUEST_TEMPLATE.md
│   ├── CODEOWNERS
│   ├── labeler.yml
│   └── plugin/
│       └── marketplace.json
├── llm-wiki/
│   ├── schema/
│   │   └── CLAUDE.md
│   ├── raw/
│   ├── wiki/
│   │   ├── index.md
│   │   ├── log.md
│   │   ├── tools/
│   │   ├── concepts/
│   │   ├── comparisons/
│   │   └── analysis/
│   └── reports/
└── data/
    ├── config.json
    └── tags.json

{
  "name": "ai-assets",
  "version": "1.0.0",
  "description": "企業 AI 資產知識庫",
  "type": "module",
  "scripts": {
    "build": "node eng/update-readme.mjs && node eng/generate-docs.mjs && node eng/generate-marketplace.mjs",
    "validate": "node eng/validate-naming.mjs && node eng/validate-frontmatter.mjs",
    "validate:skills": "node eng/validate-skills.mjs",
    "validate:plugins": "node eng/validate-plugins.mjs",
    "validate:workflows": "node eng/validate-workflows.mjs",
    "validate:secrets": "node eng/check-secrets.mjs",
    "validate:all": "npm run validate && npm run validate:skills && npm run validate:plugins && npm run validate:workflows && npm run validate:secrets",
    "skill:create": "node eng/create-skill.mjs",
    "plugin:create": "node eng/create-plugin.mjs",
    "skill:validate": "node eng/validate-skill.mjs",
    "plugin:validate": "node eng/validate-plugin.mjs",
    "fix:line-endings": "bash eng/fix-line-endings.sh",
    "report:staleness": "node eng/staleness-report.mjs",
    "wiki:lint": "node eng/wiki-lint.mjs",
    "wiki:stats": "node eng/wiki-stats.mjs"
  },
  "devDependencies": {
    "gray-matter": "^4.0.3",
    "glob": "^10.3.10",
    "inquirer": "^9.2.12"
  }
}

## 🚀 AI 資產知識庫初始化 Checklist

### 1. 組織與權限
- [ ] 建立 GitHub Organization（若尚未建立）
- [ ] 啟用 Two-Factor Authentication
- [ ] 建立 Teams（admins / maintainers / reviewers / contributors）
- [ ] 設定 Team 權限

### 2. Repository 建立
- [ ] 建立 Repository（Internal visibility）
- [ ] 選擇 License
- [ ] 建立 `staged` 分支
- [ ] 設定 Branch Protection（main + staged）
- [ ] 啟用 GitHub Actions

### 3. 檔案結構
- [ ] 建立所有目錄（agents / instructions / skills / plugins / hooks / workflows / cookbook / prompts / tutorials / templates）
- [ ] 建立支援目錄（_templates / .schemas / .vscode / scripts）
- [ ] 建立 README.md
- [ ] 建立 CONTRIBUTING.md
- [ ] 建立 AGENTS.md
- [ ] 建立 CODE_OF_CONDUCT.md
- [ ] 建立 SECURITY.md
- [ ] 建立 SUPPORT.md
- [ ] 建立 llms.txt
- [ ] 建立 .gitignore
- [ ] 建立 .gitattributes
- [ ] 建立 .editorconfig
- [ ] 建立 .codespellrc
- [ ] 建立 CODEOWNERS

### 4. 自動化
- [ ] 建立 validate-content.yml
- [ ] 建立 check-pr-target.yml
- [ ] 建立 validate-workflows.yml（Agentic Workflow 驗證）
- [ ] 建立 update-readme.yml
- [ ] 建立 staleness-report.yml
- [ ] 建立 contributors.yml
- [ ] 建立 label-pr.yml + labeler.yml
- [ ] 建立 security-scan.yml
- [ ] 建立 fix-line-endings.yml
- [ ] 建立 PR Template
- [ ] 建立 Issue Templates

### 5. 建構腳本
- [ ] 初始化 package.json
- [ ] 安裝 devDependencies
- [ ] 實作 update-readme.mjs
- [ ] 實作 generate-marketplace.mjs
- [ ] 實作 validate-naming.mjs
- [ ] 實作 validate-frontmatter.mjs
- [ ] 實作 validate-skills.mjs
- [ ] 實作 validate-plugins.mjs
- [ ] 實作 validate-workflows.mjs
- [ ] 實作 check-secrets.mjs
- [ ] 實作 fix-line-endings.sh
- [ ] 實作 wiki-lint.mjs
- [ ] 實作 wiki-stats.mjs

### 6. LLM Wiki 建置
- [ ] 建立 llm-wiki/ 目錄結構（schema / raw / wiki / reports）
- [ ] 建立 CLAUDE.md（Schema）
- [ ] 建立 index.md 與 log.md
- [ ] 建立 wiki-lint.yml Workflow
- [ ] 建立 Codex 相容軟連結（CLAUDE.md → wiki/CLAUDE.md）

### 7. 種子內容
- [ ] 遷移現有 Prompt 模板
- [ ] 遷移現有教學手冊
- [ ] 建立 3-5 個核心 Agent
- [ ] 建立 5-10 個 Instruction
- [ ] 建立標準標籤清單（data/tags.json）

### 8. 推廣
- [ ] 撰寫團隊公告
- [ ] 舉辦啟動說明會
- [ ] 設定 Onboarding 流程
- [ ] 建立定期 Review 機制

╔═══════════════════════════════════════════════════════════════╗
║                    AI 資產知識庫 — 快速參考卡                    ║
╠═══════════════════════════════════════════════════════════════╣
║                                                               ║
║  📁 目錄結構                                                   ║
║  ├── agents/          → *.agent.md                            ║
║  ├── instructions/    → *.instructions.md                     ║
║  ├── skills/          → {name}/SKILL.md                       ║
║  ├── plugins/         → {name}/plugin.json                    ║
║  ├── hooks/           → {name}/hooks.json                     ║
║  ├── workflows/       → *.md                                  ║
║  ├── prompts/         → {name}/prompt.md                      ║
║  ├── tutorials/       → *-教學手冊.md                          ║
║  ├── templates/       → {category}/{name}.md                  ║
║  └── llm-wiki/wiki/   → {category}/{topic}.md（知識頁）       ║
║                                                               ║
║  🔀 貢獻流程                                                   ║
║  1. Fork / Branch                                             ║
║  2. 建立內容（使用 _templates/ 模板）                           ║
║  3. PR → staged 分支                                          ║
║  4. 自動化檢查 + 2 位審查者核准                                 ║
║  5. 合併至 staged → 定期發佈至 main                            ║
║                                                               ║
║  🏷️ 命名規則                                                   ║
║  • 檔案名：小寫 + 連字號（java-refactoring.agent.md）          ║
║  • 資料夾：小寫 + 連字號（unit-test-generator/）               ║
║  • 教學手冊：可用中文（claude-code-教學手冊.md）               ║
║                                                               ║
║  ⚠️ 禁止事項                                                   ║
║  • 禁止提交 API Key / 密碼 / 內部 IP                           ║
║  • 禁止直接推送至 main 分支                                    ║
║  • 禁止未經測試的內容                                          ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

輸入：一篇關於 "Redis 7.4 新功能" 的技術文件

觸發更新：
├── wiki/tools/redis.md          ← 更新版本歷史段落
├── wiki/concepts/caching.md     ← 新增 Redis 7.4 相關資訊
├── wiki/comparisons/cache-solutions.md ← 更新比較表
├── wiki/index.md                ← 新增索引條目
└── wiki/log.md                  ← 記錄此次 Ingest

## Ingest Workflow

1. 接收原始資料，存入 `raw/` 目錄
2. 分析資料內容，識別涉及的實體、概念、工具
3. 針對每個識別到的主題：
   a. 若對應頁面已存在 → 更新相關段落，標註新來源
   b. 若對應頁面不存在 → 建立新頁面
4. 更新 `wiki/index.md`（新增條目或調整描述）
5. 在 `wiki/log.md` 頂部新增一筆 Ingest 記錄
6. 每個引用必須標註來源檔案路徑（span-level citation）

# Wiki 索引

## 工具與平台
- [Redis](tools/redis.md) — 分散式快取與資料結構伺服器（v7.4）
- [Kafka](tools/kafka.md) — 分散式事件串流平台（v3.7）
- [Kubernetes](tools/kubernetes.md) — 容器編排平台（v1.30）

## 概念與模式
- [快取策略](concepts/caching.md) — Cache-Aside / Write-Through / Write-Behind
- [RAG vs Wiki](concepts/rag-vs-wiki.md) — 兩種知識管理模式的比較

## 對照表
- [LLM 供應商比較 2026](comparisons/llm-providers-2026.md)
- [快取方案比較](comparisons/cache-solutions.md)

## 分析報告
- [企業 AI 採用策略](analysis/enterprise-ai-adoption.md)

---
最後更新：2026-05-07
總頁數：42

# 操作日誌

## 2026-05-07

### Ingest: Redis 7.4 Release Notes
- **來源**: `raw/2026-05-07-release-redis-74.md`
- **更新頁面**: `tools/redis.md`, `concepts/caching.md`, `comparisons/cache-solutions.md`
- **新增頁面**: 無
- **操作者**: Claude（自動）

### Query: "Redis 7.4 與 Valkey 的差異"
- **查詢頁面**: `tools/redis.md`, `tools/valkey.md`, `comparisons/cache-solutions.md`
- **結果**: 回存為 `comparisons/redis-vs-valkey-2026.md`

## 2026-05-06

### Lint: 每週健檢
- **掃描頁面**: 42
- **發現問題**: 3（1 矛盾、2 過時聲明）
- **詳見**: `reports/lint-2026-05-06.md`

# 安裝 qmd
pip install qmd

# 索引 Wiki 目錄
qmd index ./wiki

# 搜尋
qmd search "Redis 快取策略比較"

# 啟動 MCP Server（供 AI Agent 使用）
qmd serve --mcp

{
  "mcpServers": {
    "llm-wiki": {
      "command": "qmd",
      "args": ["serve", "--mcp", "--wiki-dir", "./wiki"],
      "description": "LLM Wiki 搜尋與管理"
    }
  }
}

# Wiki CODEOWNERS 建議
/wiki/               @wiki-maintainers
/wiki/index.md       @wiki-admins
/wiki/log.md         @wiki-admins
/raw/                @all-contributors
/schema/CLAUDE.md    @wiki-admins

# CLAUDE.md — LLM Wiki Schema

## Project Overview
這是 {team-name} 的 LLM Wiki 知識庫，由 LLM 持續維護結構化的技術知識。

## Directory Structure
- `raw/` — 原始資料（不可變，僅新增）
- `wiki/` — LLM 編譯的知識頁面
  - `tools/` — 工具與平台頁面
  - `concepts/` — 概念與模式頁面
  - `comparisons/` — 對照表
  - `analysis/` — 綜合分析報告
  - `index.md` — 主索引（必須隨每次 Ingest 更新）
  - `log.md` — 操作日誌（最新在最上方）
- `schema/` — 架構定義（本檔案）
- `reports/` — Lint 報告

## Naming Conventions
- Raw files: `raw/{YYYY-MM-DD}-{source-type}-{slug}.md`
- Wiki pages: `wiki/{category}/{slug}.md`
- 使用小寫 + 連字號，不使用空格或底線

## Ingest Workflow
1. 將原始資料存入 `raw/`
2. 分析涉及的實體、概念、工具
3. 更新或建立對應的 Wiki 頁面
4. 每個引用標註來源：`[source: raw/2026-05-07-xxx.md]`
5. 更新 `wiki/index.md`
6. 在 `wiki/log.md` 頂部新增記錄

## Query Workflow
1. 搜尋相關 Wiki 頁面
2. 合成答案，每個陳述附引用
3. 若答案具通用價值，回存為新頁面

## Lint Rules
- 每頁必須被至少一個其他頁面引用（否則為孤立頁面）
- 版本號必須與最新發佈版一致
- 同一事實在所有頁面的陳述必須一致
- Frontmatter 必須包含：title, created, updated, sources

## Quality Standards
- 每個事實陳述必須有來源引用
- 比較表格至少包含 3 個維度
- 概念頁面必須包含：定義、歷史、應用場景、相關概念

# 建立 symlink（Unix / macOS / WSL）
ln -s CLAUDE.md AGENTS.md

# Windows（需管理員權限或開啟開發人員模式）
mklink AGENTS.md CLAUDE.md

# 步驟 1：建立目錄結構
mkdir -p llm-wiki/{raw,wiki/{tools,concepts,comparisons,analysis},schema,reports}

# 步驟 2：建立 Schema
cat > llm-wiki/schema/CLAUDE.md << 'SCHEMA'
# CLAUDE.md
## Project Overview
團隊 LLM Wiki 知識庫。
## Directory Structure
- raw/ — 原始資料（不可變）
- wiki/ — 知識頁面（LLM 維護）
- schema/ — 架構定義
## Ingest Workflow
1. 原始資料存入 raw/
2. 更新或建立 Wiki 頁面
3. 更新 wiki/index.md
4. 記錄至 wiki/log.md
SCHEMA

# 步驟 3：建立空索引
echo "# Wiki 索引\n\n（尚無內容）\n\n---\n最後更新：$(date +%Y-%m-%d)\n總頁數：0" > llm-wiki/wiki/index.md

# 步驟 4：建立空日誌
echo "# 操作日誌\n\n（尚無操作記錄）" > llm-wiki/wiki/log.md

# 步驟 5：初始化 Git
cd llm-wiki && git init && git add -A && git commit -m "chore: initialize LLM Wiki"

# 步驟 6：建立 Codex 相容 symlink
ln -s schema/CLAUDE.md AGENTS.md

使用者：
  請將以下文章 Ingest 進知識庫。
  [貼上一篇關於 Kubernetes 1.30 新功能的技術文件]

LLM 執行：
  1. ✅ 存檔至 raw/2026-05-07-release-kubernetes-130.md
  2. ✅ 更新 wiki/tools/kubernetes.md（新增 v1.30 段落）
  3. ✅ 更新 wiki/concepts/container-orchestration.md（新增新功能引用）
  4. ✅ 建立 wiki/comparisons/kubernetes-130-vs-129.md（版本差異對照表）
  5. ✅ 更新 wiki/index.md（新增 3 個條目）
  6. ✅ 記錄至 wiki/log.md

  共更新 3 頁、新增 1 頁。