菜单
系统透明化层:维护一张『永远当前、agent 一遍读懂』的系统全景 —— 目标/能力/规划/架构/未来 + 多端×UI×业务流×系统流。当用户说『这系统是什么/有哪些能力/架构是什么/产品全景/系统现状/onboard 这个项目/系统地图/system map』,或任何 agent 开工前要秒懂现状时,先读 docs/system-map/INDEX.md。本 skill 定义该地图的结构、防漂移机制、与 product-pipeline 的读写闭环;它不重写已有权威文档,而是把它们 INDEX 化 + 给『结构』加代码生成的当前性。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
管理首页行动卡片 — 创建、查询、完成、归档。当用户想把某条建议固化到首页、查看当前行动计划、标记完成，使用这个 skill。
Assess chronic disease risk — cardiovascular (modified Framingham), metabolic syndrome (IDF criteria), and 90-day trend analysis. Integrates wearable data (Garmin), labs, vitals, and genetic markers for personalized risk scoring with confidence intervals.
Family health management - medical reports, medications, review calendar, family daily health check. Use when user asks about family members' health, medical exams, medications, checkup schedules, or wants to manage health for parents/spouse/children.
Query and analyze user genetic test data (基因检测). Cross-reference genetics with medical reports, Garmin wearable data, and current health status for personalized nutrition, exercise, drug sensitivity, disease risk, and sleep advice.
Get AI health analysis, daily recommendations, health trend predictions, and health scores. Use when the user asks for health advice, trend analysis, risk assessment, or wellness recommendations.
综合查询健康数据 — Digital Health Twin 快照、Safety 告警、长期趋势、Orchestrator 多专家分析。当用户想了解自己的整体健康状况、趋势变化、安全风险时使用。
| name | system-map |
| description | 系统透明化层:维护一张『永远当前、agent 一遍读懂』的系统全景 —— 目标/能力/规划/架构/未来 + 多端×UI×业务流×系统流。当用户说『这系统是什么/有哪些能力/架构是什么/产品全景/系统现状/onboard 这个项目/系统地图/system map』,或任何 agent 开工前要秒懂现状时,先读 docs/system-map/INDEX.md。本 skill 定义该地图的结构、防漂移机制、与 product-pipeline 的读写闭环;它不重写已有权威文档,而是把它们 INDEX 化 + 给『结构』加代码生成的当前性。 |
一句话:让任意 agent 读一个入口(
docs/system-map/INDEX.md)就知道「这系统有什么、在哪、怎么扩」,且不会过时。 铁律(命根子):一个事实只允许两种状态 —— ① 从代码生成进无人手改的文件(docs/_generated/system-map.json),或 ② 带last-reviewed日期的纯叙事(显式不含 live 数字)。致命的第三态——手打 live 数字进叙事——结构性禁止(实证:它害死了 ARCHITECTURE(51 条)、PRODUCT_ROADMAP 当日写错56)。
docs/system-map/
├── INDEX.md ← agent 先读。read-order + 6 facet 指针 + 三层分治 + 防漂移
└── product-map.md ← 多端 × UI × 业务流 × 系统流(叙事 + last-reviewed)
docs/_generated/
└── system-map.json ← 代码派生:计数 + roster。无人手改;scripts/dump_system_map.py 生成
scripts/dump_system_map.py ← 生成器(复用 check_doc_drift 扫描器,确定性输出)
scripts/check_doc_drift.py ← CI 已跑;新增校验 committed JSON == 代码(不符即红)
多数 facet 不在 system-map 里重写,INDEX 指向已有权威文档(governance/PRD/ARCHITECTURE/surface-inventory)。本 skill 的价值 = 入口 + 防漂移 + 维护协议。
| 层 | 内容 | 真源 | 漂移 |
|---|---|---|---|
| A 叙事 | 目标/规划理由/为什么/流程/端 roster | INDEX + facet 文档(last-reviewed) | 靠新鲜度门 + S8 回写 |
| B 代码生成 | 一切计数 + roster | docs/_generated/system-map.json | 零 |
| C 在途 | 当前在做的 feature | docs/dossiers/ | 零 |
scripts/dump_system_map.py —— 复用 check_doc_drift.py 的扫描器(单一真源),输出确定性 JSON(全 sorted、无时间戳)。改代码后跑它重新生成。check_doc_drift.py(CI 已跑)新增:build_map() 重算 vs committed docs/_generated/system-map.json,不符即 exit 1。地图与代码不符 → CI 红 → product-pipeline G3 拦住,物理上无法带漂移上线。 另加 regex 补丁堵 规则分类(N 条) 子标题漏检(Hook 3)。last-reviewed: YYYY-MM-DD;读者据此判断「叙事是否可信、计数永远信 _generated」。docs/dossiers/ 由 product-pipeline 写,天然当前。dump_system_map.py 提交(否则 G3 红);② A 层 —— 动了某 facet 域则更新该文档 + bump last-reviewed。INDEX 顶部 READ ORDER:① 能力/目标 → INDEX 表;② 功能在哪/怎么连 → product-map;③ 地图可不可信 → _generated/system-map.json(它是计数真源);④ 怎么扩 → product-pipeline 契约;⑤ 当前在做 → dossiers。每文档 YAML front-matter + 稳定锚点,LLM 不靠猜。
把它从 A 叙事挪进 B 代码生成:① dump_system_map.py 加一个 build_map() 字段(复用/新增 check_doc_drift 扫描器);② 跑生成器更新 JSON;③ check_doc_drift 的等值比对自动覆盖(无需改比对逻辑);④ 叙事里删掉手打的该数字,改引用 _generated。
CLAUDE.md doc-map + AGENTS.md 指向 docs/system-map/INDEX.md(agent 开工先读);研发 skill 触发绑定见 docs/agent-skill-binding.md。product-pipeline-contract.md 并列(全局 ~/work/personal/PRACTICES/);每项目建自己的 docs/system-map/INDEX.md + dump_system_map.py 填本项目实情。last-reviewed,不钉 CI(否则逼出假 bump)。每 feature 上线(S8)更新地图;每发现一类新「会漂的结构」按上面 4 步挪进 B 层。地图越用越准。实证:本 skill 首次落地,regex 补丁即逮到 main 上 ARCHITECTURE (51 条) 真漂移(代码 63)。