表达结构
- 作者仓库星标 56,229
- 作者仓库 claude-code-best-practice
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @shanraisshan · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Presentation Structure Skill
Knowledge about how the presentation at `presentation/index.html` is structured.
## File Location
`presentation/index.html` — a single-file HTML presentation with inline CSS and JS.
## Slide Format
Each slide is a div with `data-slide` (sequential number) and optional `data-level` (journey level at transition points):
```html
<!-- Regular slide — inherits level from previous data-level slide -->
<div class="slide" data-slide="12">
<h1>Slide Title</h1>
<!-- content -->
</div>
<!-- Level transition slide — sets new level for this slide and all following -->
<div class="slide section-slide" data-slide="10" data-level="low">
<h1>Section Name</h1>
<p class="section-desc">Level: Low — description of this section</p>
</div>
<!-- Title slide (centered) -->
<div class="slide title-slide" data-slide="1">
<h1>Presentation Title</h1>
<p class="subtitle">Subtitle text</p>
</div>
```
## Journey Bar Level System
The presentation uses a 4-level system instead of cumulative percentages:
- Levels are set via `data-level` attribute on key transition slides (section dividers)
- All slides after a `data-level` slide inherit that level until the next transition
- The journey bar fills to 25% / 50% / 75% / 100% for Low / Medium / High / Pro respectively
- The bar is hidden on slide 1 (title slide); from slide 2 onward the bar is shown
- Slides before the first `data-level` (slides 2–9) show an empty bar (no level yet set)
- A `.level-badge` is JS-injected on the `<h1>` of slides that carry `data-level` — do NOT hardcode in HTML
### Level Transitions by Section
| Section | Slide Range | data-level | Bar Height |
|---------|-------------|------------|------------|
| Part 0: Introduction | Slides 1-4 | (none) | hidden / empty |
| Part 1: Prerequisites | Slides 5-9 | (none) | empty |
| Part 2: Better Prompting | Slides 10-17 | `low` | 25% |
| Part 3: Project Memory | Slides 18-24 | `medium` | 50% |
| Part 4: Structured Workflows | Slides 25-28 | (inherits medium) | 50% |
| Part 5: Domain Knowledge | Slides 29-33 | `high` | 75% |
| Part 6: Agentic Engineering | Slides 34-46 | `high` | 75% |
| Appendix | Slides 47+ | (inherits high) | 75% |
## Navigation System
- `goToSlide(n)` — used in TOC links, must match actual `data-slide` numbers
- `totalSlides` is auto-computed from DOM (`document.querySelectorAll('[data-slide]').length`)
- Arrow keys, Space, and touch swipe for navigation
- Slide counter shows `current / total` at bottom-left
## Renumbering Rules
After adding, removing, or reordering slides:
1. Renumber ALL `data-slide` attributes sequentially starting from 1
2. Update all `goToSlide()` calls in the TOC/Journey Map slide
3. The JS `totalSlides` auto-computes — no manual update needed
4. Verify no gaps or duplicates exist
## Section Divider Format
Section dividers use the `section-slide` class. Level-transition section dividers carry `data-level` and show the level name in the description:
```html
<div class="slide section-slide" data-slide="10" data-level="low">
<p class="section-number">Part 2</p>
<h1>Better Prompting</h1>
<p class="section-desc">Level: Low — effective prompting for real results.</p>
</div>
```
The JS will inject a `.level-badge` (e.g., "→ Low") into the `<h1>` at runtime when the level transitions — do not add these manually in HTML.
章节与文件索引
按说明文件中的顺序排列。
文件位置
幻灯片格式
旅程酒吧水平系统
按部分进行电平转换
导航系统
文件/命令 -> presentation/index.html · data-slide · data-level · .level-badge · <h1> · low · medium · high
内容校验值 -> 93eb6296d906
当前原文的自动摘译,尚未人工审校。
文件位置
presentation/index.html— 带有内联 CSS 和 JS 的单文件 HTML 演示文稿。幻灯片格式
每张幻灯片都是一个带有
data-slide(序号)和可选的data-level(过渡点的旅程级别)的 div:旅程酒吧水平系统
演示文稿使用 4 级系统而不是累积百分比: 级别通过关键过渡幻灯片(部分分隔符)上的
data-level属性设置data-level幻灯片之后的所有幻灯片都会继承该级别,直到下一个过渡 旅程栏分别填充为低/中/高/专业的 25% / 50% / 75% / 100% 该栏隐藏在幻灯片 1 上(标题幻灯片);从幻灯片 2 开始显示该栏按部分进行电平转换
部分·幻灯片范围·数据级别·条形高度第0部分:简介·幻灯片1-4·(无)·隐藏/空第1部分:先决条件·幻灯片5-9·(无)·空第2部分:更好的提示·幻灯片10-17·
low·25%第3部分:项目内存·幻灯片18-24·medium·50%导航系统
goToSlide(n)— 用于 TOC 链接,必须与实际的data-slide数字匹配totalSlides从 DOM 自动计算 (document.querySelectorAll('[data-slide]').length) 箭头键、空格键和触摸滑动进行导航 滑动计数器在左下角显示current / total