Communitygithub.com

grahama1970/agent-stack-public

稽核、同步並更新 grahama.co 公開網站與履歷介面,資料來源為 README.md 和 RESUME.md。唯讀稽核可偵測 README 策展專案/庫存與 site/content.json 之間的差異,以及線上網站健康狀態;apply 能根據 README 重新產生 content.json;update 則將 README/RESUME 的變更串接到網站內容、履歷 JSON、Markdown、PDF、DOCX、llms.txt 與 ops-linkedin JSON 交接檔。適用於「網站是否最新」、「將網站與 README 同步」、「網站漂移」、「監控 grahamaco」等情境,或在編輯 README 專案卡片、「一覽」表格或 RESUME.md 之後使用。

agent-stack-public 是什麼?

此技能旨在自動化管理 grahama.co 網站及其相關履歷介面的同步與稽核,以 README.md 與 RESUME.md 作為唯一事實來源。它能執行唯讀的「漂移」偵測,比對 README 中的策展專案與庫存清單(如「我正在做的有趣玩意」專案卡片與「一覽」表格)與網站 site/content.json 之間的差異,同時驗證線上網站的健康狀態。主要命令包括 `audit`(僅報告,不修改內容)、`apply`(根據 README 重新產生 site/content.json,並保留現有專案描述)、以及 `update`(完整串接流程,將 README 與 RESUME 的變更同步至所有對應的輸出格式,包括履歷 PDF、DOCX、Markdown、JSON、llms.txt 以及 LinkedIn 交接檔)。該技能支援 `run.sh` 命令列介面,可與 Claude Code、Cursor 或其他支援 CLI 執行的 AI 代理工具整合。其設計核心強調可溯源性、不覆寫人工撰寫的文案,並透過明確的提交/推送步驟來確保變更能被審查。此外,它還包含嚴格的設計與語音合約檢查(如 `design-contract-check` 與 `copy-audit`),以確保網站的視覺風格與第一人稱語氣符合預設規範,避免被工具或 AI 模型任意改寫。

相容平台~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/grahama1970/agent-stack-public/tree/HEAD/skills/monitor-website

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

監控網站(monitor-website)

RESUME.md 是 grahama.co/resume 的事實來源:gen_resume.py 會將其解析為 site/resume.json,並將 PDF、DOCX 和 Markdown 匯出檔複製到 site/public/,因此頁面、/resume.pdf、/resume.docx 和 /resume.md 的內容都來自同一個提交。下方的摘要檢查可以捕捉到編輯了履歷但從未重新產生相關介面的情況。

公開網站(site/,服務於 https://grahama.co)反映了 README.md 中的兩個策展介面:「我正在做的有趣玩意」專案卡片與「一覽」庫存表格。README 是事實來源;網站則讀取 site/content.json。此技能負責確保兩者之間的一致性。

命令

# 僅報告:README 與 content.json 之間的漂移 + 線上網站健康狀態。若發生漂移則退出碼為 1。
./run.sh audit --json

# 僅報告:如果 BRAND.md / DESIGN.md 是模糊意圖的散文而非具體的品牌 + 實作設計合約,則視為失敗。
./run.sh design-contract-check --json

# 跳過對 https://grahama.co 的即時探測(離線 / DNS 生效前使用)
./run.sh audit --no-live --json

# 從 README 重新產生 site/content.json(統計資料一律更新;專案集的增減依據 slug 判斷——現有專案的簡介會保留,新專案則採用 README 卡片的簡介)。不進行提交或推送。
./run.sh apply

# 執行 apply,然後證明網站仍能建置並通過 qid 閘門。
./run.sh apply --build

# 根據當前儲存庫狀態重新產生已產生的介面(inventory.json、artifacts.json、
# generated/battle-lineage.json、research-map.json),
# 通過 qid + 建置閘門;--commit/--push 為明確參數。
# battle-lineage.json 是從記錄的 battle-004 即時測試裝置推導而來,
# 如果該測試裝置偏離其斷言的形狀,則會以失敗關閉。
# research-map.json 將專案分組到 DECLARED 研究領域分類法中
#(領域維護在 gen_research_map.py 中,非 LLM 推斷),並計算每個領域的匹配技能數量
#——首頁的迷你地圖是產生的,而非散文。
# refresh 絕不會觸碰複製內容(問題/簡介/章節)。
./run.sh refresh
./run.sh refresh --commit --push

# 一個供 Graham + 專案代理協作的本地串接流程。這是編輯 README.md 或 RESUME.md 後應執行的命令。
#
# 來源:
#   README.md  -> site/content.json 和產生的公開網站介面
#   RESUME.md  -> 履歷 PDF、DOCX、Markdown、site/resume.json、llms.txt
#   RESUME.md  -> 可編輯的 ops-linkedin.profile_entry.v1 JSON
#
# LinkedIn 僅為本地交接:execution_claim 保持 NOT_EXECUTED,此處不會發生瀏覽器或 LinkedIn 平台存取。
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build

# 給將此視為 grahama.co 監控器而非通用網站監控器的人使用的穩定別名。
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan

# 凍結章節/頁面狀態審查單元並提供迴圈能力 URL。
./run.sh review-site prepare --url http://127.0.0.1:3003/ --out /tmp/grahama-review --json
./run.sh review-site verify --run-dir /tmp/grahama-review --json
./run.sh review-site serve --run-dir /tmp/grahama-review --bind 127.0.0.1 --port 43117 --json
./run.sh review-site stop --run-dir /tmp/grahama-review --json

# 在不消耗評分員席位的情況下驗證以 URL 為優先的 G11 審查傳輸。
./run.sh design-review preflight --provider webgpt --review-url '<capability-url>' --expected-fingerprint '<sha256>' --json
./run.sh design-review submit --provider webgpt --review-url '<capability-url>' --expected-fingerprint '<sha256>' --prompt prompt.md --out /tmp/rater --json
./run.sh design-review verify --rater-dir /tmp/rater --json

一個預設停用的夜間服務已註冊在 agents/website-maintainer/services.yaml(儲存庫慣例:cron 項目在出貨時是停用的;僅在排程器環境準備就緒時啟用)。

合約

  • 預設為僅報告。 audit 永遠不會變更內容。 apply 僅寫入 site/content.json;提交、推送和 Pages 部署仍由呼叫者明確執行(推送到 main 會觸發 .github/workflows/site-deploy.yml)。
  • 文案不會被覆寫。 網站簡介可能比 README 卡片標題更豐富;apply 會保留仍存在之專案的現有簡介,僅同步成員資格(slug/href)和統計資料。
  • 證明: audit JSON 會報告每個漂移項目;在應用變更到達 main 之後,憑證是綠色的 site-deploy 執行以及對 https://grahama.co 上已變更數值進行 curl 回讀。
  • 互動閘門: 任何對 grahama.co 或 grahama.co/resume 的 UI 可見變更,在提交/推送之前必須針對已變更的介面執行 test-interactions 發現與重播。清單必須來自即時 DOM,且協定啟動控制項(例如頂部導航的電子郵件)必須作為頁面內行為進行測試,或明確分類為外部僅等待連結。這些介面上的電子郵件聯絡控制項預設為剪貼簿複製按鈕;原始的 mailto: 連結是一種回歸,除非任務明確需要本機郵件客戶端啟動行為。
  • 單來源串接: update 是專案代理/Graham 協作路徑。它會在網站產生器之前執行現有的履歷匯出器,然後將 LinkedIn 個人資料 JSON 和可選的個人資料同步規劃委派給 ops-linkedin。它不會套用 LinkedIn 變更或聲明平台驗證。
  • 審查 URL: review-site 將確定性的 candidate_fingerprint 完整性與僅執行階段的 access_nonce 路由分開。它會使用章節語料庫清單,將規範渲染複製到審查套件中,預設僅提供迴圈服務,並且永遠不會將不透明的 URL 視為對私人、受管制或 ITAR 資料的驗證。
  • 審查者收據: design-review 保持傳輸、檢查和評分員狀態分離。預檢可以證明 URL/指紋/單元/規範圖像的存取,但它永遠不會消耗評分員席位。僅在保留原始提供者輸出並回應預期的指紋、單元 ID 和審查金絲雀時,評分員才可用。

audit 檢查的項目

檢查項目來源發生漂移當…
stats.skills / sanity / agentsREADME「一覽」表格數字與 content.json 不同時
專案成員資格README 專案卡片的 <strong> 名稱 + hrefslug 僅存在於單一方,或 href 已變更時
線上網站https://grahama.co, /sitemap.xml非 200 狀態碼,或首頁缺少導航 data-qid 時
履歷介面RESUME.md 對比 site/resume.json蓋戳的提交 != HEAD,或記錄的 sourceSha256 != 實際的 RESUME.md 摘要時
線上履歷/resume, /resume.pdf, /resume.docx, /resume.md非 200 狀態碼,或提供的檔案不是預期的頁面/PDF/DOCX/Markdown 時

品牌/設計意圖——好奇心重於類別

在提議或套用 grahama.co 設計或定位變更之前,請閱讀:

  • site/BRAND.md
  • site/DESIGN.md
  • skills/monitor-website/local/docs/BRAND.md
  • skills/monitor-website/local/docs/DESIGN.md

然後執行 skills/monitor-website/run.sh design-contract-check --json。一個內容貧乏或僅靠感覺的 DESIGN.md 是失敗的合約,而非可接受的第一版。

這個網站的設計目標是能被發現、引人入勝、誠實、量身打造,並且無庸置疑是 Graham 的風格。請勿將其標準化為 AI 服務、國防科技、Palantir 風格、Straive 風格或通用的研發科技價值主張。除非當前的證據顯示存在事實、可及性、出處或損壞路徑的缺陷,否則請將非尋常性視為有意為之。

設計維護——量身打造的視覺世界合約(#1337)

grahama.co 的設計/視覺識別維護與 best-practices-bespoke-design 和 best-practices-font 組合。網站的視覺世界鎖定在 site/design-world.yml(機器事實來源)和 site/DESIGN_WORLD.md(人類可讀)中:包含一個敘事前設、三個非顏色不變量、完整的角色語法,以及被禁止的結構性 AI 模板殘留物。

絕不能僅憑散文信心就報告視覺重新設計已就緒。對於一般的本地修復工作,請執行確定性的渲染路徑:

skills/monitor-website/run.sh design-render-check --json

它會驗證來源合約、來源鎖定、可確定性檢查的禁止事項、類型收據、響應式章節裁剪幾何形狀以及工藝渲染收據。此路徑可能返回 PASS,但它明確不證明正式的量身打造設計 READY、盲測區分性、競爭對手替換抵抗力、可及性完成度或實際效能。

僅在當前任務是最終的量身打造設計閘門時,才執行正式的認證路徑:

skills/monitor-website/run.sh design-certify --json

design-certify 包含 G11 盲測評分員收據,並且除非每個閘門都是 PASS,否則會以非零退出。缺少當前的評分員輸出為 NOT_TESTED,而非網站渲染失敗。design-world-check 仍作為正式檢查器的相容性別名存在;請優先使用上述兩個明確的命令。

語音合約(#1298)

grahama.co 的第一人稱人類語音鎖定在 site/VOICE.md(合約)+ site/voice-anchors.yml(簽名行)中。自動化作業可以驗證、同步事實性中繼資料以及發布已批准的筆記,但不得改寫網站文案,除非人類撰寫的來源檔案已變更。僅報告、確定性:

skills/monitor-website/run.sh copy-audit --json

它會標記第一人稱 we/our/us、AI 新創公司的最高級形容詞、佔位符/假文,以及任何從複製內容中消失的簽名行。證據標籤仍從結構化中繼資料推導而來——文案不能強化它們。

相關技能