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