Skip to content
Back to search

project-map

SkillWorks with Claude CodeGitHub

"把项目现状画成非专业用户一眼能懂的内联卡片:路线、模块、清单、问题、进度、取舍。触发场景:大改开工/收口、结构变化、故障排查、方案选择,或用户说画项目地图、看看做到哪了、哪里有问题。先按内容选配方,再选风格;内容少就直接说,不硬做卡。不用于界面设计(交给 wf-design)或纯代码修改(交给 wf-vibecode)。"

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hayou2002--project-map/badge.svg)](/listings/hayou2002--project-map)

HTML

<a href="/listings/hayou2002--project-map"><img src="/api/listings/hayou2002--project-map/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add hayou2002/project-map

也可以把 `project-map/` 整个目录放进你的技能库。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 126 lines
  1. ---
  2. name: project-map
  3. description: "把项目现状画成非专业用户一眼能懂的内联卡片:路线、模块、清单、问题、进度、取舍。触发场景:大改开工/收口、结构变化、故障排查、方案选择,或用户说画项目地图、看看做到哪了、哪里有问题。先按内容选配方,再选风格;内容少就直接说,不硬做卡。不用于界面设计(交给 wf-design)或纯代码修改(交给 wf-vibecode)。"
  4. license: MIT
  5. metadata:
  6. version: "0.2.0"
  7. ---
  8. # project-map
  9. 一句话:**先定用户要做的判断,再决定长什么样。**
  10. 同一份项目状态,顺序清楚用路线图,模块多就用模块图,条目多用表格,问题多用看板,有数字用进度,二选一用对比。没有默认版式。
  11. ## 什么时候用
  12. - 大改开工前:有哪些模块、这次改哪、第一片是什么。
  13. - 大改收口:做完了什么、哪里还有问题、下一步是什么。
  14. - 过程中结构变了:新增模块、换方案、发现阻塞,重出一张。
  15. - 故障排查:把阻塞、待修、观察分开。
  16. - 方案取舍:把 A/B 的代价翻成人话。
  17. 不用:普通界面设计(交给 `wf-design`)、纯代码修改(交给 `wf-vibecode`)、只读代码探索(交给 `oil-explore`)。内容只有两三句时,直接写在对话里。
  18. ## 三条铁律
  19. 1. **内容决定形式。** 先问「用户现在要做什么判断」,再选配方;不要先挑模板再塞内容。
  20. 2. **一张卡一个主配方,最多一个辅助。** 例如路线图 + 顶部进度条;不要同时塞表、图、看板。
  21. 3. **一屏读完。** 主区不超过 7 块;超过就换表格、拆卡,或让正文区内部滚动。
  22. ## 六种配方
  23. | 用户现在要看 | 用哪个 | 典型场景 |
  24. | --- | --- | --- |
  25. | 先后、阶段、做到哪了 | [roadmap](recipes/roadmap.md) | 采集 → 识别 → 分类 → 报表 |
  26. | 谁连谁、谁依赖谁 | [module-map](recipes/module-map.md) | 页面 → 接口 → 数据库 |
  27. | 很多条要对比、扫读 | [status-table](recipes/status-table.md) | 文件清单、接口清单、状态表 |
  28. | 哪里坏了、先修什么 | [issue-board](recipes/issue-board.md) | 阻塞 / 待修 / 观察 |
  29. | 数字、里程碑、完成度 | [progress](recipes/progress.md) | 4 个模块完成 1 个 |
  30. | 两个方案怎么选 | [comparison](recipes/comparison.md) | A 方案 vs B 方案 |
  31. 拿不准:先问一句「你现在想看顺序、连接、数量还是问题」,或先用三五句话说明;不要向用户报一串模板名让他选。
  32. ## 我们的风格:图纸手记·清纸
  33. 完整规范见 [house-style.md](references/house-style.md)。关键几条:
  34. - 近白冷纸底 `#F6F8F7`,青绿主色 `#356B64`,雾蓝辅助 `#4E6F8A`,陶土提示 `#9A5B45`。
  35. - **只做亮色**;不写暗色模式,不跟随系统切换。
  36. - 衬线标题 + 无衬线正文 + 等宽编号;字重只用 400/500。
  37. - 0.5px 发丝线,4~8px 小圆角,没有大阴影、发光、玻璃拟态。
  38. - 页眉一层 32px 图纸网格;小印章、双色顶栏、编号、批注线做识别。
  39. - 状态必须同时有文字和颜色;不用 emoji。
  40. - 皮肤可以换雾蓝或便笺,但只换温度,不换结构;清单见 [style-recipes.md](references/style-recipes.md)。
  41. ## 尺寸与滚动
  42. - 最大宽度 `768px`,与 Codex 会话正文同宽;窄屏 `width:100%`。
  43. - 正文区 `max-height:520px`;内容超出时在卡片内部滚动,页眉和页脚保持可见。
  44. - 窄屏正文区 `max-height:62vh`;390px 宽不横向溢出。
  45. - 表格在 560px 以下变成逐条卡片,不横向滚动。
  46. - 不把整张卡做成无限长;内容多时先删、拆或换配方。
  47. ## 卡片骨架
  48. 一张卡最多五段,按顺序,没有内容的段直接删:
  49. 1. **标题**:项目或功能名,一句话。
  50. 2. **现在在哪**:一句进度或结论。
  51. 3. **主区**:选中的配方本体。
  52. 4. **结论区**:这次改哪 / 问题 / 下一步,最多三条。
  53. 5. **术语**:最多 3 个,放最后。
  54. ## 内容驱动的开关
  55. - `detail.kind` 为 `none`:不出现标签或开关。
  56. - `inline`:一行说明,直接显示。
  57. - `expand`:多行说明,默认收起;只有这种才出现“展开”。
  58. - `tags` 可以为 0;只放真正有信息量的词,最多 2 个;不默认套“页面 / 接口 / 逻辑”。
  59. - 问题看板只显示有内容的列;只有一列时改成单列列表。
  60. - 表格行的 `detail` 为空时,不出现“看细节”。
  61. - 没有术语就不留术语区;没有要解释的按钮就不放按钮。
  62. ## 输出
  63. 1. 写一个 HTML 片段(不要 `DOCTYPE/html/head/body`),存到当前会话的 visualization 目录或项目的 `work/` 下。
  64. 2. 在最终回复里单独一行放:
  65. `visualize{"path":"<绝对路径>.html"}`
  66. 3. 项目需要留档时,渲染成独立 HTML,放到:
  67. - 有项目目录:`projects/<name>/outputs/项目地图.html`
  68. - 无项目目录:`<工作区>/outputs/项目地图.html`
  69. 4. 不要把 `.arch/`、`graph.json` 或内部节点 ID 直接展示给用户。
  70. ## 数据来源
  71. - 有 `.arch/graph.json`:读 `nodes[].label/spec/status/stage/file_path/last_tag` 和 `edges[].contract`。
  72. - 没有图:从本次施工单或对话里整理,不凭空补结构。
  73. - 状态映射:`solid + file_path/last_tag` → 能用;当前焦点 → 在做;`solid` 未落地 → 还没做;`hole` → 没定;`fog` → 以后再说。
  74. - 问题区最多 3 条,写「现象 + 影响 + 下一步」,不贴整段报错。
  75. ## 与工作流
  76. - `wf-vibecode`:大改开工前出一次,收口再出一次;结构变了随时重出。
  77. - `oil-bug-fix`:问题多时用 issue-board,不要用路线图硬塞。
  78. - `wf-design`:界面改版用 module-map 或页面预览,细节交给 `wf-design`。
  79. - 其他工作流需要「让用户看懂现状」时,直接调用本 skill。
  80. ## 自检
  81. - 768px 和 390px 都真截图看过,不横向溢出。
  82. - 主区不超过 7 块;只用一个主配方。
  83. - 没有空标题、空列、空卡片、空展开。
  84. - 每个专业词都有括号解释,或已在术语表里。
  85. - 状态同时有文字和颜色;没有 emoji。
  86. - 只做亮色,没有暗色分支。
  87. - 正文区超出 520px 时能内部滚动,页眉和页脚仍在。
  88. ## 资源导航
  89. - [roadmap](recipes/roadmap.md) · [module-map](recipes/module-map.md) · [status-table](recipes/status-table.md) · [issue-board](recipes/issue-board.md) · [progress](recipes/progress.md) · [comparison](recipes/comparison.md)
  90. - [recipe-selection.md](references/recipe-selection.md):更细的选择与组合规则。
  91. - [house-style.md](references/house-style.md):清纸色板、字体、尺寸、识别点与禁用项。
  92. - [style-recipes.md](references/style-recipes.md):清纸 / 雾蓝 / 便笺三套皮肤。
  93. - [hana-style.md](references/hana-style.md):借了什么、没借什么。
  94. - [notice.md](references/notice.md):来源与许可。
  95. - `templates/`:六种配方的完整可运行模板;`scripts/build_templates.py` 是统一生成器。
README.md · README · 76 lines
  1. # project-map
  2. ![project-map:把项目现状画成一眼能懂的图](assets/readme/hero.svg)
  3. 把项目现状画成非专业用户一眼能懂的内联卡片。不是一套固定模板,而是六种配方:路线、模块、清单、问题、进度、取舍。
  4. 一句话原则:**先把内容看清楚,再决定长什么样。**
  5. ## 六种配方
  6. | 用户要看 | 配方 | 典型场景 |
  7. | --- | --- | --- |
  8. | 先后、阶段、做到哪了 | roadmap | 采集 → 识别 → 分类 → 报表 |
  9. | 谁连谁、谁依赖谁 | module-map | 页面 → 接口 → 数据库 |
  10. | 很多条要对比、扫读 | status-table | 文件清单、接口清单 |
  11. | 哪里坏了、先修什么 | issue-board | 阻塞 / 待修 / 观察 |
  12. | 数字、里程碑、完成度 | progress | 4 个模块完成 1 个 |
  13. | 两个方案怎么选 | comparison | A 方案 vs B 方案 |
  14. 配方可以自由组合:一个主配方 + 最多一个辅助。内容少就不做卡,直接说话。
  15. ## 风格:图纸手记·清纸
  16. - 近白冷纸 `#F6F8F7`,青绿 `#356B64`,雾蓝 `#4E6F8A`,陶土 `#9A5B45`。
  17. - 只做亮色,不跟随系统暗色。
  18. - 衬线标题 + 无衬线正文 + 等宽编号;0.5px 发丝线,小圆角。
  19. - 页眉图纸网格、小印章、双色顶栏、批注线;识别点够用就停。
  20. - 状态同时有文字和颜色;不用 emoji。
  21. 三种温度:清纸(默认)、雾蓝(架构)、便笺(问题分组)。只换温度,不换结构。
  22. ## 尺寸
  23. - 最大宽度 `768px`,与 Codex 会话正文同宽;窄屏 `width:100%`。
  24. - 正文区 `max-height:520px`;内容长了在卡片内部滚动,页眉和页脚保持可见。
  25. - 390px 宽不横向溢出;表格在 560px 以下变成逐条卡片。
  26. ## 安装
  27. ```bash
  28. npx skills add hayou2002/project-map
  29. ```
  30. 也可以把 `project-map/` 整个目录放进你的技能库。
  31. ## 用法
  32. 1. 先判断用户要做什么:看顺序、连接、数量、问题,还是取舍。
  33. 2. 选一个配方;读它的 `recipes/*.md`,按数据形状整理内容。
  34. 3. 从 `templates/*.html` 里挑最接近的一张,替换顶部 `MODEL`;渲染器会自动隐藏空段、决定是否出现展开和标签。
  35. 4. 输出 HTML 片段,或在 Codex 里用 `visualize` 显示。
  36. 5. 768px 和 390px 都截图看一眼,再交付。
  37. ## 和工作流的关系
  38. - `wf-vibecode`:大改开工前出一张,收口再出一张;结构变了随时重出。
  39. - `oil-bug-fix`:问题多时用 issue-board。
  40. - `wf-design`:界面改版用 module-map 或页面预览,细节交给它。
  41. ## 目录
  42. ```text
  43. project-map/
  44. ├── SKILL.md
  45. ├── recipes/ # 六种内容配方
  46. ├── references/ # 选配方、风格、来源
  47. ├── templates/ # 六种可运行模板
  48. ├── scripts/ # 统一生成器
  49. └── assets/ # 纸纹理、README 配图
  50. ```
  51. ## 来源与许可
  52. 纸张层次与 folio 结构参考 Open Hanako 的公开配方(Apache-2.0);配色、排版、印章、编号和内容规则是本项目自己的组合。详见 [references/notice.md](references/notice.md)。
  53. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.