Communitygithub.com

grahama1970/agent-stack-public

审计、同步并更新公开的 grahama.co 网站及简历展示面,确保 README.md 和 RESUME.md 中的信息与网站内容一致。

agent-stack-public 是什么?

这是一个用于监控和同步 grahama.co 个人网站的技能。它以 README.md 和 RESUME.md 为唯一真实来源,自动检测网站内容是否与源文件存在偏差(drift),并能将源文件变更同步到网站内容、简历、PDF、DOCX 等多种格式中。该技能支持 '仅审计' 模式(不修改任何内容)和 '应用' 模式(执行同步),并内置了品牌设计检查、设计渲染检查和语音一致性检查等契约。它适用于 Claude Code 等平台,可作为持续集成流程的一部分,确保网站始终反映最新的个人项目和简历信息。

兼容平台~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 实时夹具,
# 如果该夹具与其声称的形状存在偏差,则会安全失败(fails closed)。
# research-map.json 将项目分组到一个声明的研究领域分类中
# (领域在 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 运行以及通过 curl 读取 https://grahama.co 上已更改的值。
  • 交互门控: 对 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,但它明确不能证明正式的定制设计就绪、盲法区分度、竞争对手替换抵抗力、可访问性完成或现场性能。

仅当当前任务是最终的定制设计门控时才运行正式的认证流程:

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 初创公司夸张用语、占位符/lorem 以及任何从副本中消失的签名行。证据标签始终源自结构化元数据——文字描述不能增强它们。

相关技能