由一份清單，建立
AI Agent Project Board

node -v
npm -v
git --version

projects:
  - id: p001
    name: Website Redesign
    program: Personal
    tier: 1
    status: ACTIVE
    priority: HIGH
    progress: null
    next_action: Finish homepage layout
    waiting_for: null
    last_updated: 2026-10-07
    notes: null
    links: []
    visibility: public

npm create astro@latest project-control -- --template minimal
cd project-control
npm install
npm install yaml
npm pkg set "scripts.test=node --test"

---
import { parse } from "yaml";
import yamlText from "../data/projects.yaml?raw";
const { projects = [] } = parse(yamlText);
---
<html lang="zh-HK">
  <head><meta charset="utf-8" /><title>Project Control</title></head>
  <body>
    <main>
      <h1>Project Control</h1>
      {projects.map((project) => (
        <article>
          <h2>{project.name}</h2>
          <p>Tier {project.tier} · {project.status}</p>
          <p>下一步：{project.next_action ?? "待補充"}</p>
        </article>
      ))}
    </main>
  </body>
</html>

import test from "node:test";
import assert from "node:assert/strict";
import { readFile } from "node:fs/promises";
import { parse } from "yaml";

const text = await readFile(new URL("../src/data/projects.yaml", import.meta.url), "utf8");
const { projects = [] } = parse(text);

test("Project records have unique ids and valid tiers/statuses", () => {
  assert.ok(projects.length > 0);
  assert.equal(new Set(projects.map((project) => project.id)).size, projects.length);
  for (const project of projects) {
    assert.ok([1, 2, 3].includes(project.tier));
    assert.ok(["ACTIVE", "WAITING", "PAUSED", "COMPLETED", "ARCHIVED"].includes(project.status));
  }
});

npm test
npm run build
npm run dev

<label for="tier-filter">顯示梯隊</label>
<select id="tier-filter">
  <option value="all">全部</option>
  <option value="1">Tier 1</option>
  <option value="2">Tier 2</option>
  <option value="3">Tier 3</option>
</select>
<div class="project-grid">
  {projects.map((project) => (
    <article data-project-card data-tier={project.tier}>
      <p>Tier {project.tier} · {project.status}</p>
      <h2>{project.name}</h2>
      <p>下一步：{project.next_action ?? "待補充"}</p>
    </article>
  ))}
</div>
<script>
  const filter = document.querySelector("#tier-filter");
  if (filter) {
    filter.addEventListener("change", () => {
      document.querySelectorAll("[data-project-card]").forEach((card) => {
        card.hidden = filter.value !== "all" && card.dataset.tier !== filter.value;
      });
    });
  }
</script>

.project-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: 12px;
}

[data-project-card] {
  padding: 16px;
  border: 1px solid #29343b;
  border-radius: 8px;
}

@media (min-width: 700px) {
  .project-grid {
    grid-template-columns: repeat(2, minmax(0, 1fr));
  }
}

node_modules/
dist/
.env
.env.*
!.env.example
.DS_Store

git init -b staging
git status --short
git add .
git status --short
git commit -m "Create project control dashboard"
git remote add origin https://github.com/<YOUR_ACCOUNT>/<YOUR_PRIVATE_REPO>.git

gh auth login
gh auth status
git remote -v
git push -u origin staging
git ls-remote origin refs/heads/staging

Framework preset: Astro
Build command: npm run build
Build output directory: dist
Preview branch: staging

請先閱讀 README、schema 和目前的 projects.yaml。
只更新我明確指定的 Project 和欄位；不確定的資料請先問，不要猜。
不要輸出、複製或要求任何 password、token、API key 或 credential。
不要修改 homepage、production branch 或私人部署設定。
完成後執行 npm test、npm run build、git diff --check，
列出改動檔案和 diff；未經我確認，不要 push 或 deploy。

npm test
npm run build
git diff --check
git status --short
git diff -- src/data/projects.yaml

mkdir -p snapshots
target="snapshots/projects-$(date +%F).yaml"
test ! -e "$target" || { echo "Snapshot exists; refusing overwrite"; exit 1; }
cp src/data/projects.yaml "$target"
git status --short

New-Item -ItemType Directory -Force snapshots | Out-Null
$day = Get-Date -Format yyyy-MM-dd
$target = "snapshots/projects-$day.yaml"
if (Test-Path $target) { throw "Snapshot exists; refusing to overwrite" }
Copy-Item src/data/projects.yaml $target
git status --short

每晚執行一次 dry-run：讀取目前 projects.yaml 和上一份已確認 snapshot。
只根據我明確授權的來源提出候選更新；資料不確定就標示「未確認」，不要自行改 status/progress。
如 reports/ 資料夾不存在，先建立；把候選項目和來源寫入 reports/nightly-draft.md。不得修改 projects.yaml、push、寄信或部署。
如已有同日 draft，先保留舊檔並用不同檔名；完成後回報來源時間、差異和錯誤。

根據最新已驗證的 projects.yaml 和 snapshot，產生今日 Morning Brief 草稿。
先列 Tier 1，再列等待事項和最近狀態變化；每項附上 Project id。
標示資料最後更新時間；未知值寫「未確認」，不要推斷。
不要修改資料、寄信、push 或部署，只輸出供我 review 的草稿。

CURRENT / SSG
projects.yaml → Astro build → Static HTML → Cloudflare Pages
適合：個人使用、低頻更新、內容可公開或已受保護

FUTURE / SSR
Browser → Server / Cloudflare → Database / API → Dynamic Dashboard
適合：多人登入、按使用者分資料、即時更新、手機直接編輯