From d0f56176c8dd99132ba4aa0246980aa1018ad266 Mon Sep 17 00:00:00 2001 From: stevending1st Date: Wed, 7 Jan 2026 00:06:41 +0800 Subject: [PATCH] docs: make checklist checkbox attributes semantic --- .../1.2.4-code-review.md | 32 ++++++------- .../2.2.5-mixed-rendering.md | 10 ++-- .../2.4-api-contract/2.4.3-parallel-dev.md | 30 ++++++------ .../3.1.1-file-system-routing.md | 8 ++-- .../3.1.2-dynamic-routes.md | 8 ++-- .../3.1.3-route-groups.md | 8 ++-- .../3.1.4-data-fetching.md | 10 ++-- .../3.1-app-router-routing/index.md | 6 +-- .../03-frontend/3.2-components/3.2.1-props.md | 8 ++-- .../03-frontend/3.2-components/3.2.2-state.md | 10 ++-- .../3.2-components/3.2.3-global-state.md | 8 ++-- .../3.2-components/3.2.4-effects.md | 8 ++-- .../3.2-components/3.2.5-custom-hooks.md | 8 ++-- .../3.2-components/3.2.6-component-design.md | 8 ++-- .../03-frontend/3.2-components/index.md | 8 ++-- .../03-frontend/3.3-figma-to-code/index.md | 10 ++-- .../3.4-tailwind-and-ui/3.4.1-tailwind-css.md | 8 ++-- .../3.4-tailwind-and-ui/3.4.2-shadcn-ui.md | 8 ++-- .../3.4.3-design-system.md | 8 ++-- .../3.4.4-responsive-design.md | 10 ++-- .../03-frontend/3.4-tailwind-and-ui/index.md | 8 ++-- .../3.5-debugging/3.5.1-network-tab.md | 8 ++-- .../3.5-debugging/3.5.2-console.md | 8 ++-- .../3.5-debugging/3.5.3-performance.md | 8 ++-- .../3.5-debugging/3.5.4-devtools.md | 8 ++-- .../03-frontend/3.5-debugging/index.md | 8 ++-- .../3.6-api-routes/3.6.1-structure.md | 8 ++-- .../3.6-api-routes/3.6.2-validation.md | 8 ++-- .../3.6-api-routes/3.6.3-service-logic.md | 8 ++-- .../3.6-api-routes/3.6.4-error-handling.md | 8 ++-- .../03-frontend/3.6-api-routes/index.md | 8 ++-- .../3.7-availability/3.7.1-error-boundary.md | 8 ++-- .../3.7-availability/3.7.2-empty-state.md | 8 ++-- .../3.7-availability/3.7.3-loading-state.md | 8 ++-- .../3.7-availability/3.7.4-retry.md | 8 ++-- .../3.8-accessibility/3.8.1-wcag.md | 12 ++--- .../3.8-accessibility/3.8.2-design-tokens.md | 8 ++-- .../3.8-accessibility/3.8.3-contrast.md | 10 ++-- .../3.8-accessibility/3.8.4-i18n.md | 10 ++-- .../3.8-accessibility/3.8.5-l10n.md | 12 ++--- .../4.1-data-modeling/4.1.3-normalization.md | 6 +-- .../4.1.4-denormalization.md | 10 ++-- .../4.4-prisma/4.4.3-model-definition.md | 12 ++--- .../4.4.7-modeling-best-practices.md | 12 ++--- .../4.5-migrations/4.5.2-rollback.md | 10 ++-- .../04-database/4.5-migrations/index.md | 12 ++--- .../5.4-structured-prd/5.4.4-markdown.md | 2 +- .../8.1-git-basics/8.1.3-conflicts.md | 8 ++-- .../8.1-git-basics/8.1.4-rollback.md | 8 ++-- .../8.1-git-basics/8.1.5-gitignore.md | 8 ++-- .../08-workflow/8.1-git-basics/index.md | 10 ++-- .../8.2-branch-strategy/8.2.1-git-flow.md | 8 ++-- .../8.2-branch-strategy/8.2.2-github-flow.md | 8 ++-- .../8.2.3-branch-protection.md | 8 ++-- .../8.2-branch-strategy/8.2.4-code-review.md | 46 +++++++++---------- .../08-workflow/8.2-branch-strategy/index.md | 8 ++-- .../8.3-commit-config/8.3.1-format.md | 8 ++-- .../8.3-commit-config/8.3.2-types.md | 8 ++-- .../8.3-commit-config/8.3.3-linting.md | 8 ++-- .../8.3-commit-config/8.3.4-changelog-gen.md | 8 ++-- .../08-workflow/8.3-commit-config/index.md | 8 ++-- .../8.4-gitignore-advanced/8.4.1-artifacts.md | 8 ++-- .../8.4-gitignore-advanced/8.4.2-secrets.md | 8 ++-- .../8.4.3-system-files.md | 8 ++-- .../8.4.4-pre-commit.md | 8 ++-- .../8.4-gitignore-advanced/index.md | 8 ++-- .../8.5-workflow-process/8.5.1-alignment.md | 30 ++++++------ .../8.5-workflow-process/8.5.2-tech-review.md | 34 +++++++------- .../8.5-workflow-process/8.5.3-acceptance.md | 8 ++-- .../8.5.4-deployment-process.md | 32 ++++++------- .../08-workflow/8.5-workflow-process/index.md | 8 ++-- .../10.2-1panel-deployment/10.2.2-config.md | 10 ++-- .../10.2.5-troubleshooting.md | 16 +++---- .../10.5-monitoring/10.5.4-profiling.md | 24 +++++----- .../11.3-knowledge-base/11.3.3-curriculum.md | 18 ++++---- .../07-creating-project.md | 8 ++-- .../02-vibecoding-workflow.md | 14 +++--- .../1.5-hello-world/1.5.1-goals.md | 6 +-- .../1.5-hello-world/1.5.2-step-by-step.md | 18 ++++---- .../2.1.1-jtbd-intro-theory.md | 10 ++-- .../2.2.2-pre-mortem-failure-patterns.md | 40 ++++++++-------- .../2.2.3-pre-mortem-practical-guide.md | 24 +++++----- .../2.3.4-practice-guide.md | 10 ++-- .../2.4-story-thinking/2.4.6-practice.md | 18 ++++---- .../2.5-soul-questions/2.5.4-why-you.md | 8 ++-- .../2.6.2-data-analysis.md | 10 ++-- .../2.6.3-automation.md | 10 ++-- .../2.6.4-personal-tools.md | 10 ++-- .../2.6.5-for-family.md | 14 +++--- docs/Basic/02-mindset/appendix/C-mistakes.md | 16 +++---- .../3.1.2-context-is-king.md | 22 ++++----- .../3.1.3-common-mistakes.md | 10 ++-- .../3.2.5-framework-guide.md | 18 ++++---- .../3.3.6-technique-guide.md | 12 ++--- .../3.4-first-prd/3.4.2-integrate-chapter2.md | 8 ++-- .../3.4.4-priority-development.md | 18 ++++---- .../3.4-first-prd/3.4.5-prd-practice.md | 30 ++++++------ .../3.5.2-iteration-pattern.md | 18 ++++---- .../3.6.2-diagnose-problems.md | 6 +-- .../3.6.4-fallback-strategies.md | 10 ++-- .../3.6-debugging-ai/3.6.5-prevention.md | 28 +++++------ docs/Basic/03-technique/appendix/index.md | 10 ++-- .../4.1.3-environment-check.md | 26 +++++------ .../4.1-before-start/4.1.4-checklist.md | 18 ++++---- .../4.2-build-page/4.2.1-first-prompt.md | 16 +++---- .../4.2-build-page/4.2.2-generate-static.md | 18 ++++---- .../4.2-build-page/4.2.3-adjust-style.md | 30 ++++++------ .../4.2-build-page/4.2.4-checkpoint.md | 26 +++++------ .../4.3-core-features/4.3.1-add-task.md | 10 ++-- .../4.3-core-features/4.3.2-delete-task.md | 8 ++-- .../4.3-core-features/4.3.3-complete-task.md | 12 ++--- .../4.3-core-features/4.3.4-iterate.md | 6 +-- .../4.3-core-features/4.3.5-checkpoint.md | 26 +++++------ .../4.4-data-storage/4.4.1-why-storage.md | 6 +-- .../4.4-data-storage/4.4.2-localstorage.md | 16 +++---- .../4.4.3-test-persistence.md | 18 ++++---- .../4.4.4-final-verification.md | 12 ++--- .../4.5-debug/4.5.4-debug-mindset.md | 30 ++++++------ .../4.6-summary/4.6.1-project-showcase.md | 8 ++-- .../4.6-summary/4.6.2-journey-review.md | 8 ++-- .../4.6-summary/4.6.3-what-learned.md | 8 ++-- .../4.6-summary/4.6.4-next-steps.md | 34 +++++++------- .../5.1-version-control/5.1.2-ide-history.md | 8 ++-- .../5.1-version-control/5.1.5-practice.md | 16 +++---- .../5.1.6-best-practices.md | 14 +++--- .../5.2-deployment/5.2.3-zeabur.md | 16 +++---- .../5.2-deployment/5.2.4-vercel.md | 14 +++--- .../5.2-deployment/5.2.9-checklist.md | 22 ++++----- .../5.3-security/5.3.3-code-risks.md | 8 ++-- .../5.3-security/5.3.4-checklist.md | 22 ++++----- .../5.3-security/5.3.6-always-review.md | 14 +++--- .../5.4-iteration/5.4.2-feedback.md | 10 ++-- .../5.4-iteration/5.4.3-new-features.md | 10 ++-- .../5.4-iteration/5.4.4-optimize.md | 10 ++-- .../5.4-iteration/5.4.5-portfolio.md | 8 ++-- .../5.5-boundaries/5.5.3-upgrade-signals.md | 24 +++++----- .../5.5-boundaries/5.5.5-advanced-preview.md | 22 ++++----- .../5.6-summary/5.6.4-prepare-advanced.md | 20 ++++---- docs/Basic/99-appendix/b-4-content.md | 10 ++-- 139 files changed, 906 insertions(+), 906 deletions(-) diff --git a/docs/Advanced-old/01-concept/1.2-vibe-coding-mindset/1.2.4-code-review.md b/docs/Advanced-old/01-concept/1.2-vibe-coding-mindset/1.2.4-code-review.md index cedc0d5..3df67c1 100644 --- a/docs/Advanced-old/01-concept/1.2-vibe-coding-mindset/1.2.4-code-review.md +++ b/docs/Advanced-old/01-concept/1.2-vibe-coding-mindset/1.2.4-code-review.md @@ -32,34 +32,34 @@ graph TD #### 1. 功能正确性 -- [ ] 代码是否实现了预期功能？ -- [ ] 逻辑流程是否正确？ -- [ ] 返回值和类型是否正确？ +- +- +- #### 2. 安全性检查 -- [ ] 是否暴露了敏感信息（API Key、密码）？ -- [ ] 是否有 SQL 注入风险？ -- [ ] 是否有 XSS 风险？ -- [ ] 用户输入是否经过验证？ +- +- +- +- #### 3. 代码规范 -- [ ] 命名是否符合项目约定？ -- [ ] 代码风格是否一致？ -- [ ] 是否有适当的注释？ +- +- +- #### 4. 性能考量 -- [ ] 是否有不必要的重复计算？ -- [ ] 是否有 N+1 查询问题？ -- [ ] 是否有内存泄漏风险？ +- +- +- #### 5. 边界情况 -- [ ] 空值/空数组如何处理？ -- [ ] 超大数据量如何处理？ -- [ ] 网络错误如何处理？ +- +- +- ### AI 常见的"胡说八道" diff --git a/docs/Advanced-old/02-tech-stack/2.2-rendering-strategies/2.2.5-mixed-rendering.md b/docs/Advanced-old/02-tech-stack/2.2-rendering-strategies/2.2.5-mixed-rendering.md index ca412ad..f137bd4 100644 --- a/docs/Advanced-old/02-tech-stack/2.2-rendering-strategies/2.2.5-mixed-rendering.md +++ b/docs/Advanced-old/02-tech-stack/2.2-rendering-strategies/2.2.5-mixed-rendering.md @@ -168,11 +168,11 @@ flowchart TD 当你设计页面渲染策略时，检查以下问题： -- [ ] 这个页面需要被搜索引擎收录吗？ -- [ ] 内容是所有用户相同，还是因人而异？ -- [ ] 数据多久更新一次？ -- [ ] 页面对首屏速度要求高吗？ -- [ ] 服务器能承受多大并发？ +- +- +- +- +- ## 本节小结 diff --git a/docs/Advanced-old/02-tech-stack/2.4-api-contract/2.4.3-parallel-dev.md b/docs/Advanced-old/02-tech-stack/2.4-api-contract/2.4.3-parallel-dev.md index d7f7c09..e7abfc8 100644 --- a/docs/Advanced-old/02-tech-stack/2.4-api-contract/2.4.3-parallel-dev.md +++ b/docs/Advanced-old/02-tech-stack/2.4-api-contract/2.4.3-parallel-dev.md @@ -113,14 +113,14 @@ export function PostList() { ### 前端开发清单 -- [ ] 基于契约创建 TypeScript 类型 -- [ ] 创建 Mock 数据工厂 -- [ ] 开发页面组件 -- [ ] 处理加载状态 -- [ ] 处理错误状态 -- [ ] 处理空状态 -- [ ] 表单验证 -- [ ] 响应式适配 +- +- +- +- +- +- +- +- ## 后端并行开发实践 @@ -173,13 +173,13 @@ describe('POST /api/posts', () => { ### 后端开发清单 -- [ ] 基于契约定义响应类型 -- [ ] 编写 API 路由处理 -- [ ] 实现数据验证（Zod） -- [ ] 实现业务逻辑 -- [ ] 编写单元测试 -- [ ] 处理错误情况 -- [ ] 实现权限控制 +- +- +- +- +- +- +- ## 协作规范 diff --git a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.1-file-system-routing.md b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.1-file-system-routing.md index f8c3a38..840273d 100644 --- a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.1-file-system-routing.md +++ b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.1-file-system-routing.md @@ -158,7 +158,7 @@ export default function Loading() { ### 验收清单 -- [ ] 根目录有 `layout.tsx` 且包含 `` 和 `` -- [ ] 每个需要访问的路径都有对应的 `page.tsx` -- [ ] 布局正确嵌套，导航时父布局不闪烁 -- [ ] 数据加载较慢的页面有 `loading.tsx` 骨架屏 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.2-dynamic-routes.md b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.2-dynamic-routes.md index 1826290..060a9d0 100644 --- a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.2-dynamic-routes.md +++ b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.2-dynamic-routes.md @@ -168,7 +168,7 @@ export default function ProductsPage({ searchParams }: Props) { ### 验收清单 -- [ ] 动态路由能正确匹配不同的 URL 路径 -- [ ] `params` 能正确获取到 URL 中的动态部分 -- [ ] 无效的动态参数能触发 404 页面 -- [ ] 需要 SEO 的页面已配置 `generateStaticParams` +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.3-route-groups.md b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.3-route-groups.md index 601f969..3fbed3f 100644 --- a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.3-route-groups.md +++ b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.3-route-groups.md @@ -158,7 +158,7 @@ app/ ### 验收清单 -- [ ] 路由组名称使用圆括号包裹 -- [ ] URL 中不包含路由组名称 -- [ ] 每个路由组有独立的 layout.tsx（如需要） -- [ ] 同一 URL 路径下只有一个 page.tsx +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.4-data-fetching.md b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.4-data-fetching.md index 99a4855..5d37ef6 100644 --- a/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.4-data-fetching.md +++ b/docs/Advanced-old/03-frontend/3.1-app-router-routing/3.1.4-data-fetching.md @@ -191,8 +191,8 @@ const posts = await fetch('https://api.example.com/posts', { ### 验收清单 -- [ ] 数据在服务端获取，HTML 中已包含内容 -- [ ] 缓存策略与业务需求匹配 -- [ ] 多个数据源使用 `Promise.all` 并行获取 -- [ ] fetch 错误有适当处理 -- [ ] 需要立即更新的场景配置了手动重新验证 +- +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.1-app-router-routing/index.md b/docs/Advanced-old/03-frontend/3.1-app-router-routing/index.md index 1519a2a..5ee7d27 100644 --- a/docs/Advanced-old/03-frontend/3.1-app-router-routing/index.md +++ b/docs/Advanced-old/03-frontend/3.1-app-router-routing/index.md @@ -84,9 +84,9 @@ graph TD **验收清单：** -- [ ] 访问 `http://localhost:3000/` 能看到首页？ -- [ ] 访问 `http://localhost:3000/about` 能看到关于页？ -- [ ] 两个页面是否都有相同的导航栏（来自 `layout.tsx`）？ +- +- +- ### 第二步：处理动态内容（Dynamic Routes） diff --git a/docs/Advanced-old/03-frontend/3.2-components/3.2.1-props.md b/docs/Advanced-old/03-frontend/3.2-components/3.2.1-props.md index bbfb83b..f03733d 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/3.2.1-props.md +++ b/docs/Advanced-old/03-frontend/3.2-components/3.2.1-props.md @@ -179,7 +179,7 @@ function List({ items, renderItem }: ListProps) { ### 验收清单 -- [ ] Props 接口定义完整，类型准确 -- [ ] 可选 props 有合理的默认值 -- [ ] 使用 `children` 实现内容插槽 -- [ ] 复杂组件使用泛型保持类型安全 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.2-components/3.2.2-state.md b/docs/Advanced-old/03-frontend/3.2-components/3.2.2-state.md index 6aa05a7..b7f8828 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/3.2.2-state.md +++ b/docs/Advanced-old/03-frontend/3.2-components/3.2.2-state.md @@ -206,8 +206,8 @@ function Display({ value }: { value: string }) { ### 验收清单 -- [ ] 正确使用 `'use client'` 声明 -- [ ] 对象/数组状态更新时创建新引用 -- [ ] 依赖前值的更新使用函数式写法 -- [ ] 复杂状态逻辑使用 useReducer -- [ ] 共享状态正确提升到公共父组件 +- +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.2-components/3.2.3-global-state.md b/docs/Advanced-old/03-frontend/3.2-components/3.2.3-global-state.md index 2d77c19..20b5a98 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/3.2.3-global-state.md +++ b/docs/Advanced-old/03-frontend/3.2-components/3.2.3-global-state.md @@ -201,7 +201,7 @@ graph TD ### 验收清单 -- [ ] 选择了合适的状态管理方案 -- [ ] 状态结构设计合理 -- [ ] 使用 selector 进行细粒度订阅 -- [ ] Provider 包裹在正确的层级 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.2-components/3.2.4-effects.md b/docs/Advanced-old/03-frontend/3.2-components/3.2.4-effects.md index f9652f2..8011d10 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/3.2.4-effects.md +++ b/docs/Advanced-old/03-frontend/3.2-components/3.2.4-effects.md @@ -194,7 +194,7 @@ useEffect(() => { ### 验收清单 -- [ ] 依赖数组完整且正确 -- [ ] 需要清理的副作用有返回清理函数 -- [ ] 异步请求有竞态处理 -- [ ] 考虑过是否可用 Server Component 替代 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.2-components/3.2.5-custom-hooks.md b/docs/Advanced-old/03-frontend/3.2-components/3.2.5-custom-hooks.md index 93108d7..aab450a 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/3.2.5-custom-hooks.md +++ b/docs/Advanced-old/03-frontend/3.2-components/3.2.5-custom-hooks.md @@ -192,7 +192,7 @@ function Search() { ### 验收清单 -- [ ] Hook 名称以 `use` 开头 -- [ ] 返回值类型定义清晰 -- [ ] 内部回调用 useCallback 包裹 -- [ ] 有明确的使用场景和文档 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.2-components/3.2.6-component-design.md b/docs/Advanced-old/03-frontend/3.2-components/3.2.6-component-design.md index 5331626..2215cb4 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/3.2.6-component-design.md +++ b/docs/Advanced-old/03-frontend/3.2-components/3.2.6-component-design.md @@ -221,7 +221,7 @@ components/ ### 验收清单 -- [ ] 每个组件有清晰的单一职责 -- [ ] 展示逻辑和业务逻辑适当分离 -- [ ] 使用组合模式实现灵活性 -- [ ] 文件组织清晰合理 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.2-components/index.md b/docs/Advanced-old/03-frontend/3.2-components/index.md index c82fea7..ebd585d 100644 --- a/docs/Advanced-old/03-frontend/3.2-components/index.md +++ b/docs/Advanced-old/03-frontend/3.2-components/index.md @@ -117,7 +117,7 @@ export function Counter() { ### 验收清单 -- [ ] 理解 Server/Client Component 的区别 -- [ ] 知道何时使用 `'use client'` -- [ ] 能够设计合理的 Props 接口 -- [ ] 理解数据流动方向（Props 向下，Events 向上） +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.3-figma-to-code/index.md b/docs/Advanced-old/03-frontend/3.3-figma-to-code/index.md index f5a33d2..d761c21 100644 --- a/docs/Advanced-old/03-frontend/3.3-figma-to-code/index.md +++ b/docs/Advanced-old/03-frontend/3.3-figma-to-code/index.md @@ -122,11 +122,11 @@ Figma 的 Dev Mode 可以导出： AI 生成代码后，按以下清单验收： -- [ ] **布局正确**：元素位置、间距与设计稿一致 -- [ ] **响应式**：在不同屏幕尺寸下正常显示 -- [ ] **交互完整**：悬停、点击等状态正确 -- [ ] **无障碍**：有 alt 文本、正确的语义标签 -- [ ] **代码质量**：无重复代码、Props 类型正确 +- +- +- +- +- ### 常见问题与解决 diff --git a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.1-tailwind-css.md b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.1-tailwind-css.md index 71fb9ac..281b2ab 100644 --- a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.1-tailwind-css.md +++ b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.1-tailwind-css.md @@ -204,7 +204,7 @@ export default config ### 验收清单 -- [ ] 类名使用正确，样式符合预期 -- [ ] 响应式断点设置合理 -- [ ] 无冗余的自定义 CSS -- [ ] 颜色使用设计系统中的值 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.2-shadcn-ui.md b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.2-shadcn-ui.md index 4af72c7..dd8dcf6 100644 --- a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.2-shadcn-ui.md +++ b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.2-shadcn-ui.md @@ -213,7 +213,7 @@ export function LoginForm() { ### 验收清单 -- [ ] 组件正确安装到 `components/ui/` -- [ ] 导入路径使用 `@/components/ui/xxx` -- [ ] 使用 `cn()` 合并额外的类名 -- [ ] 表单使用 Form 组件并配置验证 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.3-design-system.md b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.3-design-system.md index 9486855..a8133f8 100644 --- a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.3-design-system.md +++ b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.3-design-system.md @@ -224,7 +224,7 @@ export default { ### 验收清单 -- [ ] 颜色使用语义化变量，不是硬编码值 -- [ ] 字号使用 Tailwind 预设类 -- [ ] 间距遵循 4px 倍数规律 -- [ ] 暗色模式颜色正确切换 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.4-responsive-design.md b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.4-responsive-design.md index 41fa900..4156181 100644 --- a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.4-responsive-design.md +++ b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/3.4.4-responsive-design.md @@ -228,8 +228,8 @@ function BreakpointIndicator() { ### 验收清单 -- [ ] 默认样式针对移动端 -- [ ] 关键断点（md、lg）有对应样式 -- [ ] 导航在移动端可用（汉堡菜单或底部导航） -- [ ] 图片使用 `sizes` 属性优化加载 -- [ ] 触控元素足够大 +- +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/index.md b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/index.md index 542c0fb..5371b49 100644 --- a/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/index.md +++ b/docs/Advanced-old/03-frontend/3.4-tailwind-and-ui/index.md @@ -90,7 +90,7 @@ npx shadcn@latest add input ### 验收清单 -- [ ] Tailwind 配置正确，样式生效 -- [ ] shadcn/ui 组件正确安装和导入 -- [ ] 组件使用 `cn()` 合并样式类 -- [ ] 响应式断点设置合理 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.1-network-tab.md b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.1-network-tab.md index a040cda..0f32164 100644 --- a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.1-network-tab.md +++ b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.1-network-tab.md @@ -186,7 +186,7 @@ curl 'https://api.example.com/users' \ ### 验收清单 -- [ ] 能够找到指定的 API 请求 -- [ ] 能够查看请求的状态码和响应内容 -- [ ] 能够分析请求的时间消耗 -- [ ] 知道如何复制请求为 cURL +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.2-console.md b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.2-console.md index dd19c84..bbafa6a 100644 --- a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.2-console.md +++ b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.2-console.md @@ -217,7 +217,7 @@ function ProductList({ products }) { ### 验收清单 -- [ ] 能够使用 console.log 输出变量值 -- [ ] 能够看懂错误信息并定位问题文件和行号 -- [ ] 知道如何设置断点进行调试 -- [ ] 能够使用单步执行追踪代码流程 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.3-performance.md b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.3-performance.md index 5494e3c..ee40bbe 100644 --- a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.3-performance.md +++ b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.3-performance.md @@ -191,7 +191,7 @@ const handleClick = useCallback(() => { ### 验收清单 -- [ ] 能够录制并分析 Performance 数据 -- [ ] 能够识别火焰图中的长任务 -- [ ] 知道如何检测内存泄漏 -- [ ] 了解 React 常用的性能优化方法 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.4-devtools.md b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.4-devtools.md index bd265b7..35e85d0 100644 --- a/docs/Advanced-old/03-frontend/3.5-debugging/3.5.4-devtools.md +++ b/docs/Advanced-old/03-frontend/3.5-debugging/3.5.4-devtools.md @@ -202,7 +202,7 @@ ThemeContext.displayName = 'ThemeContext' ### 验收清单 -- [ ] 已安装 React Developer Tools 扩展 -- [ ] 能够在组件树中定位目标组件 -- [ ] 能够查看和修改组件的 Props 和 State -- [ ] 能够使用 Profiler 分析渲染性能 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.5-debugging/index.md b/docs/Advanced-old/03-frontend/3.5-debugging/index.md index 69cfbc8..fedb2e8 100644 --- a/docs/Advanced-old/03-frontend/3.5-debugging/index.md +++ b/docs/Advanced-old/03-frontend/3.5-debugging/index.md @@ -82,7 +82,7 @@ graph LR ### 验收清单 -- [ ] 知道如何打开 Chrome DevTools（F12 或 Cmd+Option+I） -- [ ] 能够在 Network 面板找到请求并查看响应 -- [ ] 能够在 Console 面板看懂错误信息 -- [ ] 已安装 React Developer Tools 扩展 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.1-structure.md b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.1-structure.md index 446f922..b965548 100644 --- a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.1-structure.md +++ b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.1-structure.md @@ -257,7 +257,7 @@ const headers = { ### 验收清单 -- [ ] API 路径遵循 RESTful 规范 -- [ ] HTTP 方法使用正确 -- [ ] 状态码符合语义 -- [ ] 响应格式统一 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.2-validation.md b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.2-validation.md index 777afcf..4be37b3 100644 --- a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.2-validation.md +++ b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.2-validation.md @@ -279,7 +279,7 @@ export async function POST(request: Request) { ### 验收清单 -- [ ] 所有 API 入口都有参数验证 -- [ ] 验证 Schema 与 TypeScript 类型同步 -- [ ] 错误响应包含清晰的字段级错误信息 -- [ ] 验证逻辑可复用（抽离到独立文件） +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.3-service-logic.md b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.3-service-logic.md index b2da684..31c748f 100644 --- a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.3-service-logic.md +++ b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.3-service-logic.md @@ -295,7 +295,7 @@ src/ ### 验收清单 -- [ ] 服务层不依赖 HTTP 相关对象 -- [ ] 业务规则集中在服务层 -- [ ] 使用事务处理多步骤操作 -- [ ] 抛出有意义的错误信息 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.4-error-handling.md b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.4-error-handling.md index 16e22d4..af1b691 100644 --- a/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.4-error-handling.md +++ b/docs/Advanced-old/03-frontend/3.6-api-routes/3.6.4-error-handling.md @@ -332,7 +332,7 @@ try { ### 验收清单 -- [ ] 有自定义错误类体系 -- [ ] 有统一的错误处理函数 -- [ ] 错误响应格式一致 -- [ ] 有适当的日志记录 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.6-api-routes/index.md b/docs/Advanced-old/03-frontend/3.6-api-routes/index.md index 6edacf7..513446b 100644 --- a/docs/Advanced-old/03-frontend/3.6-api-routes/index.md +++ b/docs/Advanced-old/03-frontend/3.6-api-routes/index.md @@ -122,7 +122,7 @@ export async function create(data: PostData) { ### 验收清单 -- [ ] API Route 只处理请求和响应 -- [ ] 业务逻辑封装在 Service 层 -- [ ] 使用 Zod 进行参数验证 -- [ ] 有统一的错误处理机制 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.7-availability/3.7.1-error-boundary.md b/docs/Advanced-old/03-frontend/3.7-availability/3.7.1-error-boundary.md index 674559b..249c28b 100644 --- a/docs/Advanced-old/03-frontend/3.7-availability/3.7.1-error-boundary.md +++ b/docs/Advanced-old/03-frontend/3.7-availability/3.7.1-error-boundary.md @@ -293,7 +293,7 @@ graph TD ### 验收清单 -- [ ] 关键功能模块有 Error Boundary 保护 -- [ ] 有合适的 fallback UI -- [ ] 支持错误重试 -- [ ] 生产环境有错误上报 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.7-availability/3.7.2-empty-state.md b/docs/Advanced-old/03-frontend/3.7-availability/3.7.2-empty-state.md index 907a66a..1f18b7a 100644 --- a/docs/Advanced-old/03-frontend/3.7-availability/3.7.2-empty-state.md +++ b/docs/Advanced-old/03-frontend/3.7-availability/3.7.2-empty-state.md @@ -313,7 +313,7 @@ function PostList({ category }: { category?: string }) { ### 验收清单 -- [ ] 所有列表都有空态处理 -- [ ] 空态有明确的下一步引导 -- [ ] 搜索/筛选有对应的空态 -- [ ] 空态风格与品牌一致 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.7-availability/3.7.3-loading-state.md b/docs/Advanced-old/03-frontend/3.7-availability/3.7.3-loading-state.md index 4965ee2..39f5316 100644 --- a/docs/Advanced-old/03-frontend/3.7-availability/3.7.3-loading-state.md +++ b/docs/Advanced-old/03-frontend/3.7-availability/3.7.3-loading-state.md @@ -325,7 +325,7 @@ function useDelayedLoading(isLoading: boolean, delay = 200) { ### 验收清单 -- [ ] 页面级加载有 loading.tsx -- [ ] Skeleton 匹配真实布局 -- [ ] 按钮有 loading 状态 -- [ ] 快速请求无闪烁 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.7-availability/3.7.4-retry.md b/docs/Advanced-old/03-frontend/3.7-availability/3.7.4-retry.md index 6317353..733a71e 100644 --- a/docs/Advanced-old/03-frontend/3.7-availability/3.7.4-retry.md +++ b/docs/Advanced-old/03-frontend/3.7-availability/3.7.4-retry.md @@ -361,7 +361,7 @@ graph TD ### 验收清单 -- [ ] 失败请求有明确的错误提示 -- [ ] 提供手动重试按钮 -- [ ] 关键请求有自动重试 -- [ ] 离线状态有提示 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.1-wcag.md b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.1-wcag.md index 35745cb..6aa5667 100644 --- a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.1-wcag.md +++ b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.1-wcag.md @@ -246,9 +246,9 @@ module.exports = { ### 验收清单 -- [ ] 所有功能可通过键盘操作 -- [ ] 焦点状态清晰可见 -- [ ] 图片有合适的替代文本 -- [ ] 表单有关联的标签 -- [ ] 使用语义化 HTML -- [ ] 通过 axe/Lighthouse 检测 +- +- +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.2-design-tokens.md b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.2-design-tokens.md index c9cd657..ef0c77a 100644 --- a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.2-design-tokens.md +++ b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.2-design-tokens.md @@ -313,7 +313,7 @@ function DesignTokensDoc() { ### 验收清单 -- [ ] 颜色使用语义化令牌 -- [ ] 支持暗色模式切换 -- [ ] 间距/字体使用统一令牌 -- [ ] 有令牌文档或展示页 +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.3-contrast.md b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.3-contrast.md index 543b1e4..4486bd9 100644 --- a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.3-contrast.md +++ b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.3-contrast.md @@ -238,8 +238,8 @@ console.log(`对比度: ${ratio.toFixed(2)}:1`) // 4.51:1 ### 验收清单 -- [ ] 文字对比度达到 4.5:1 (AA) -- [ ] 大字对比度达到 3:1 -- [ ] 不只依赖颜色传达信息 -- [ ] 焦点状态清晰可见 -- [ ] 暗色模式对比度达标 +- +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.4-i18n.md b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.4-i18n.md index 9264b83..d513ee6 100644 --- a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.4-i18n.md +++ b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.4-i18n.md @@ -282,8 +282,8 @@ declare global { ### 验收清单 -- [ ] 文本从代码中抽离 -- [ ] 支持语言切换 -- [ ] 日期/数字正确格式化 -- [ ] SEO 元数据多语言支持 -- [ ] 翻译键有 TypeScript 类型 +- +- +- +- +- diff --git a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.5-l10n.md b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.5-l10n.md index 4a5efd0..867a473 100644 --- a/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.5-l10n.md +++ b/docs/Advanced-old/03-frontend/3.8-accessibility/3.8.5-l10n.md @@ -263,9 +263,9 @@ function pseudoLocalize(text: string): string { ### 验收清单 -- [ ] 日期/时间按地区格式化 -- [ ] 货币按地区显示 -- [ ] 地址/姓名顺序正确 -- [ ] 布局适应文本长度变化 -- [ ] RTL 语言正确显示 -- [ ] 符合目标地区法规 +- +- +- +- +- +- diff --git a/docs/Advanced-old/04-database/4.1-data-modeling/4.1.3-normalization.md b/docs/Advanced-old/04-database/4.1-data-modeling/4.1.3-normalization.md index efc06b5..9c69119 100644 --- a/docs/Advanced-old/04-database/4.1-data-modeling/4.1.3-normalization.md +++ b/docs/Advanced-old/04-database/4.1-data-modeling/4.1.3-normalization.md @@ -168,9 +168,9 @@ model Customer { 设计表时，逐项检查： -- [ ] **1NF**：所有字段都是原子值？没有数组或逗号分隔的值？ -- [ ] **2NF**：所有非主键字段都依赖于完整的主键？ -- [ ] **3NF**：非主键字段之间没有依赖关系？ +- +- +- ### 实际开发中的权衡 diff --git a/docs/Advanced-old/04-database/4.1-data-modeling/4.1.4-denormalization.md b/docs/Advanced-old/04-database/4.1-data-modeling/4.1.4-denormalization.md index 39e9bdc..8770694 100644 --- a/docs/Advanced-old/04-database/4.1-data-modeling/4.1.4-denormalization.md +++ b/docs/Advanced-old/04-database/4.1-data-modeling/4.1.4-denormalization.md @@ -162,11 +162,11 @@ await queue.add('syncAuthorName', { userId, newName }) 在决定反范式化之前，问自己： -- [ ] **确实有性能问题吗**？有实际的监控数据支撑吗？ -- [ ] **其他方案试过了吗**？索引、缓存、查询优化？ -- [ ] **能接受数据不一致的风险吗**？ -- [ ] **有能力维护数据同步逻辑吗**？ -- [ ] **未来数据量增长后还适用吗**？ +- +- +- +- +- ### Vibe Coding 中的实践建议 diff --git a/docs/Advanced-old/04-database/4.4-prisma/4.4.3-model-definition.md b/docs/Advanced-old/04-database/4.4-prisma/4.4.3-model-definition.md index 8e33e6e..b7577eb 100644 --- a/docs/Advanced-old/04-database/4.4-prisma/4.4.3-model-definition.md +++ b/docs/Advanced-old/04-database/4.4-prisma/4.4.3-model-definition.md @@ -239,12 +239,12 @@ model TeamMember { 定义模型时，检查以下几点： -- [ ] 每个模型都有 `@id` 主键 -- [ ] 必填字段没有加 `?` -- [ ] 外键字段类型与引用字段一致 -- [ ] 一对一关系的外键有 `@unique` -- [ ] 需要搜索/排序的字段有索引 -- [ ] 审计字段（createdAt、updatedAt）已添加 +- +- +- +- +- +- ### 本节小结 diff --git a/docs/Advanced-old/04-database/4.4-prisma/4.4.7-modeling-best-practices.md b/docs/Advanced-old/04-database/4.4-prisma/4.4.7-modeling-best-practices.md index d6f9b15..ad382f4 100644 --- a/docs/Advanced-old/04-database/4.4-prisma/4.4.7-modeling-best-practices.md +++ b/docs/Advanced-old/04-database/4.4-prisma/4.4.7-modeling-best-practices.md @@ -230,12 +230,12 @@ model Category { ### 设计检查清单 -- [ ] 每个模型有 id、createdAt、updatedAt -- [ ] 外键字段命名规范 -- [ ] 一对一关系外键有 @unique -- [ ] 多对多关系配置了 onDelete 行为 -- [ ] 查询频繁的字段有索引 -- [ ] 敏感数据考虑了软删除 +- +- +- +- +- +- ### 本节小结 diff --git a/docs/Advanced-old/04-database/4.5-migrations/4.5.2-rollback.md b/docs/Advanced-old/04-database/4.5-migrations/4.5.2-rollback.md index af66024..cbefd65 100644 --- a/docs/Advanced-old/04-database/4.5-migrations/4.5.2-rollback.md +++ b/docs/Advanced-old/04-database/4.5-migrations/4.5.2-rollback.md @@ -123,11 +123,11 @@ ALTER TABLE users DROP COLUMN name; ### 回滚检查清单 -- [ ] 迁移前已备份数据库 -- [ ] 已准备回滚 SQL 脚本 -- [ ] 已记录当前应用版本 -- [ ] 已通知相关人员 -- [ ] 已准备回滚后的验证步骤 +- +- +- +- +- ### 本节小结 diff --git a/docs/Advanced-old/04-database/4.5-migrations/index.md b/docs/Advanced-old/04-database/4.5-migrations/index.md index 3401756..f1cf24d 100644 --- a/docs/Advanced-old/04-database/4.5-migrations/index.md +++ b/docs/Advanced-old/04-database/4.5-migrations/index.md @@ -61,12 +61,12 @@ npx prisma migrate deploy ### 迁移前检查清单 -- [ ] 已在本地测试迁移 -- [ ] 已在测试环境验证 -- [ ] 已备份生产数据库 -- [ ] 了解迁移的预计执行时间 -- [ ] 准备好回滚方案 -- [ ] 安排在低峰期执行 +- +- +- +- +- +- ### 本章小结 diff --git a/docs/Advanced-old/05-product/5.4-structured-prd/5.4.4-markdown.md b/docs/Advanced-old/05-product/5.4-structured-prd/5.4.4-markdown.md index 7f45539..a2e7d64 100644 --- a/docs/Advanced-old/05-product/5.4-structured-prd/5.4.4-markdown.md +++ b/docs/Advanced-old/05-product/5.4-structured-prd/5.4.4-markdown.md @@ -158,7 +158,7 @@ const user = await prisma.user.create({ ## 任务列表 - [x] 已完成 -- [ ] 未完成 +- ## 分隔线 ``` diff --git a/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.3-conflicts.md b/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.3-conflicts.md index 2e435c6..7153f7b 100644 --- a/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.3-conflicts.md +++ b/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.3-conflicts.md @@ -171,7 +171,7 @@ git show :3:src/auth.ts # 被合并分支 ## 验收清单 -- [ ] 理解冲突产生的原因 -- [ ] 能识别冲突标记并手动解决 -- [ ] 能使用 IDE 的可视化工具解决冲突 -- [ ] 知道如何放弃合并或选择某一方版本 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.4-rollback.md b/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.4-rollback.md index a9e7a8c..c13e638 100644 --- a/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.4-rollback.md +++ b/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.4-rollback.md @@ -165,7 +165,7 @@ git stash apply stash@{1} ## 验收清单 -- [ ] 理解 reset 和 revert 的区别 -- [ ] 能根据场景选择正确的回滚方式 -- [ ] 知道如何用 reflog 找回误删的提交 -- [ ] 能使用 stash 暂存工作进度 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.5-gitignore.md b/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.5-gitignore.md index 9c4198b..5d26b0b 100644 --- a/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.5-gitignore.md +++ b/docs/Advanced-old/08-workflow/8.1-git-basics/8.1.5-gitignore.md @@ -180,7 +180,7 @@ curl -sL https://www.toptal.com/developers/gitignore/api/node,nextjs > .gitignor ## 验收清单 -- [ ] 理解 .gitignore 的作用和重要性 -- [ ] 能编写基本的忽略规则 -- [ ] 知道如何移除已追踪的文件 -- [ ] 了解全局 .gitignore 的配置方法 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.1-git-basics/index.md b/docs/Advanced-old/08-workflow/8.1-git-basics/index.md index c2fdf7e..34e60ee 100644 --- a/docs/Advanced-old/08-workflow/8.1-git-basics/index.md +++ b/docs/Advanced-old/08-workflow/8.1-git-basics/index.md @@ -60,8 +60,8 @@ flowchart LR ## 验收清单 -- [ ] 能独立完成 clone → 修改 → commit → push 流程 -- [ ] 能创建分支、切换分支、合并分支 -- [ ] 能处理简单的合并冲突 -- [ ] 理解 reset 和 revert 的区别 -- [ ] 能正确配置 .gitignore 文件 +- +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.1-git-flow.md b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.1-git-flow.md index 5875a2b..77f212c 100644 --- a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.1-git-flow.md +++ b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.1-git-flow.md @@ -181,7 +181,7 @@ git flow release finish 1.0.0 ## 验收清单 -- [ ] 理解五种分支类型的作用 -- [ ] 能正确执行 feature 分支的创建和合并 -- [ ] 理解 release 和 hotfix 的区别 -- [ ] 了解 Git Flow 的适用场景 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.2-github-flow.md b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.2-github-flow.md index 081aeb1..77b641b 100644 --- a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.2-github-flow.md +++ b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.2-github-flow.md @@ -176,7 +176,7 @@ git rebase origin/main ## 验收清单 -- [ ] 理解 GitHub Flow 的六步流程 -- [ ] 能独立完成从创建分支到合并的完整流程 -- [ ] 了解 GitHub Flow 与 Git Flow 的区别 -- [ ] 掌握分支同步和 PR 最佳实践 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.3-branch-protection.md b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.3-branch-protection.md index 79ba2a2..ec14032 100644 --- a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.3-branch-protection.md +++ b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.3-branch-protection.md @@ -192,7 +192,7 @@ flowchart TD ## 验收清单 -- [ ] 理解分支保护的必要性 -- [ ] 能在 GitHub 上配置基本的分支保护规则 -- [ ] 了解 CI 状态检查的集成方式 -- [ ] 知道如何配置 CODEOWNERS +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.4-code-review.md b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.4-code-review.md index 562f87f..60ff4ec 100644 --- a/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.4-code-review.md +++ b/docs/Advanced-old/08-workflow/8.2-branch-strategy/8.2.4-code-review.md @@ -60,37 +60,37 @@ Closes # ### 功能正确性 -- [ ] 代码逻辑是否正确实现了需求 -- [ ] 边界条件是否处理得当 -- [ ] 错误处理是否完善 -- [ ] 是否考虑了并发/竞态问题 +- +- +- +- ### 代码质量 -- [ ] 代码是否清晰易读 -- [ ] 命名是否准确描述了意图 -- [ ] 函数/组件是否职责单一 -- [ ] 是否有重复代码可以抽取 +- +- +- +- ### 安全性 -- [ ] 是否有 SQL 注入风险 -- [ ] 用户输入是否经过验证 -- [ ] 敏感数据是否正确处理 -- [ ] 是否有硬编码的密钥 +- +- +- +- ### 性能 -- [ ] 是否有明显的性能问题 -- [ ] 数据库查询是否高效 -- [ ] 是否有 N+1 查询问题 -- [ ] 前端是否避免了不必要的渲染 +- +- +- +- ### 测试 -- [ ] 是否有足够的测试覆盖 -- [ ] 测试用例是否覆盖边界情况 -- [ ] 测试是否易于维护 +- +- +- ## 审查评论规范 @@ -187,7 +187,7 @@ flowchart TD ## 验收清单 -- [ ] 了解代码审查的价值 -- [ ] 能配置 PR 模板 -- [ ] 掌握审查评论的规范 -- [ ] 理解作者和审查者各自的职责 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.2-branch-strategy/index.md b/docs/Advanced-old/08-workflow/8.2-branch-strategy/index.md index f37191e..d8f194e 100644 --- a/docs/Advanced-old/08-workflow/8.2-branch-strategy/index.md +++ b/docs/Advanced-old/08-workflow/8.2-branch-strategy/index.md @@ -67,7 +67,7 @@ flowchart LR ## 验收清单 -- [ ] 理解分支策略的必要性 -- [ ] 能根据项目特点选择合适的分支模型 -- [ ] 知道如何配置分支保护规则 -- [ ] 掌握 PR 和代码审查的基本流程 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.1-format.md b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.1-format.md index 4d2e2be..6eedc2a 100644 --- a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.1-format.md +++ b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.1-format.md @@ -157,7 +157,7 @@ git commit -m "chore: 更新依赖版本" ## 验收清单 -- [ ] 理解 Header、Body、Footer 的作用 -- [ ] 能正确使用 scope 标注影响范围 -- [ ] 知道如何标记破坏性变更 -- [ ] 能编写清晰的 Body 说明 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.2-types.md b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.2-types.md index ba161db..10f953d 100644 --- a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.2-types.md +++ b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.2-types.md @@ -191,7 +191,7 @@ flowchart TD ## 验收清单 -- [ ] 能准确区分 feat 和 fix -- [ ] 理解 refactor 与 fix 的区别 -- [ ] 知道 style 和 refactor 的界限 -- [ ] 能根据变更内容选择正确的类型 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.3-linting.md b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.3-linting.md index c89257e..2a98fac 100644 --- a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.3-linting.md +++ b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.3-linting.md @@ -236,7 +236,7 @@ git commit -m "feat: xxx" --no-verify ## 验收清单 -- [ ] 成功安装 husky 和 commitlint -- [ ] 配置了 commit-msg hook -- [ ] 不规范的提交会被拒绝 -- [ ] 可选：配置了 lint-staged +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.4-changelog-gen.md b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.4-changelog-gen.md index 15483d2..2e95466 100644 --- a/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.4-changelog-gen.md +++ b/docs/Advanced-old/08-workflow/8.3-commit-config/8.3.4-changelog-gen.md @@ -196,7 +196,7 @@ pnpm add -D semantic-release @semantic-release/changelog @semantic-release/git ## 验收清单 -- [ ] 安装并配置 standard-version -- [ ] 能执行 release 命令生成 CHANGELOG -- [ ] 理解版本号自动变更规则 -- [ ] 可选：配置 CI 自动发布 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.3-commit-config/index.md b/docs/Advanced-old/08-workflow/8.3-commit-config/index.md index 0ee4c51..c15fa39 100644 --- a/docs/Advanced-old/08-workflow/8.3-commit-config/index.md +++ b/docs/Advanced-old/08-workflow/8.3-commit-config/index.md @@ -83,7 +83,7 @@ Closes #456" ## 验收清单 -- [ ] 理解 Conventional Commits 规范 -- [ ] 能正确使用 type 和 scope -- [ ] 会配置 commitlint 自动检查 -- [ ] 能使用工具自动生成 CHANGELOG +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.1-artifacts.md b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.1-artifacts.md index 942d676..73144ab 100644 --- a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.1-artifacts.md +++ b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.1-artifacts.md @@ -188,7 +188,7 @@ git push --force-with-lease ## 验收清单 -- [ ] 理解 node_modules 不该提交的原因 -- [ ] 能配置构建产物的忽略规则 -- [ ] 知道如何处理意外提交的文件 -- [ ] 理解日志和测试产物的忽略 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.2-secrets.md b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.2-secrets.md index 6a81f24..81595ac 100644 --- a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.2-secrets.md +++ b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.2-secrets.md @@ -177,7 +177,7 @@ GitHub 会自动扫描常见的密钥格式并发出警告： ## 验收清单 -- [ ] 配置了 .env* 的忽略规则 -- [ ] 创建了 .env.example 模板 -- [ ] 理解私钥证书的忽略方式 -- [ ] 知道意外提交后的处理流程 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.3-system-files.md b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.3-system-files.md index 03a651a..e5162f6 100644 --- a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.3-system-files.md +++ b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.3-system-files.md @@ -217,7 +217,7 @@ trim_trailing_whitespace = false ## 验收清单 -- [ ] 配置了操作系统文件的忽略规则 -- [ ] 设置了全局 gitignore -- [ ] 理解哪些 IDE 配置应该共享 -- [ ] 可选：配置了 EditorConfig +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.4-pre-commit.md b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.4-pre-commit.md index 92ddc6f..c63edb7 100644 --- a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.4-pre-commit.md +++ b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/8.4.4-pre-commit.md @@ -217,7 +217,7 @@ echo "✅ All pre-commit checks passed!" ## 验收清单 -- [ ] 配置了敏感文件的 pre-commit 检查 -- [ ] 可选：配置了 gitleaks 密钥扫描 -- [ ] 可选：配置了大文件检查 -- [ ] 配置了 CI 层面的安全扫描 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/index.md b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/index.md index c621555..ce930bf 100644 --- a/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/index.md +++ b/docs/Advanced-old/08-workflow/8.4-gitignore-advanced/index.md @@ -87,7 +87,7 @@ coverage/ ## 验收清单 -- [ ] 了解哪些文件应该被忽略 -- [ ] 能编写基本的 .gitignore 规则 -- [ ] 理解敏感文件的处理方式 -- [ ] 知道如何配置全局 gitignore +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.1-alignment.md b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.1-alignment.md index 7459fff..a9f3e7c 100644 --- a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.1-alignment.md +++ b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.1-alignment.md @@ -84,23 +84,23 @@ flowchart TD ### 产品角度 -- [ ] 需求背景和目标是否清晰？ -- [ ] 用户场景是否完整？ -- [ ] 优先级是否合理？ -- [ ] 有没有遗漏的边界情况？ +- +- +- +- ### 开发角度 -- [ ] 技术上是否可行？ -- [ ] 是否有外部依赖？ -- [ ] 工作量评估是否合理？ -- [ ] 是否影响现有功能？ +- +- +- +- ### 测试角度 -- [ ] 验收标准是否明确？ -- [ ] 测试用例能否覆盖？ -- [ ] 性能要求是否明确？ +- +- +- ## 简化版需求记录 @@ -155,7 +155,7 @@ flowchart TD ## 验收清单 -- [ ] 理解 PRD 的关键要素 -- [ ] 能编写简化版的 Feature List -- [ ] 知道需求评审的检查点 -- [ ] 理解如何处理需求变更 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.2-tech-review.md b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.2-tech-review.md index f8d9b87..3b9922b 100644 --- a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.2-tech-review.md +++ b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.2-tech-review.md @@ -143,28 +143,28 @@ flowchart TD ### 可行性 -- [ ] 技术方案是否完整？ -- [ ] 是否有技术风险？ -- [ ] 依赖的服务是否可用？ -- [ ] 有没有更简单的方案？ +- +- +- +- ### 性能 -- [ ] 预估的 QPS 是多少？ -- [ ] 数据量增长后能否支撑？ -- [ ] 有没有潜在的性能瓶颈？ +- +- +- ### 安全 -- [ ] 敏感数据如何存储？ -- [ ] 接口是否需要鉴权？ -- [ ] 有没有注入风险？ +- +- +- ### 可维护性 -- [ ] 方案是否易于理解？ -- [ ] 后续扩展是否方便？ -- [ ] 是否有过度设计？ +- +- +- ## AI 辅助技术评审 @@ -176,7 +176,7 @@ flowchart TD ## 验收清单 -- [ ] 能编写基本的技术方案文档 -- [ ] 理解 ADR 的结构和用途 -- [ ] 知道技术评审的关键检查点 -- [ ] 能识别方案中的潜在风险 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.3-acceptance.md b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.3-acceptance.md index 533f68a..eae8a33 100644 --- a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.3-acceptance.md +++ b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.3-acceptance.md @@ -200,7 +200,7 @@ test('用户登录流程', async ({ page }) => { ## 验收清单 -- [ ] 能编写明确的验收标准 -- [ ] 理解功能、性能、安全验收的区别 -- [ ] 能用自动化测试替代部分验收 -- [ ] 知道如何记录验收结果 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.4-deployment-process.md b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.4-deployment-process.md index d169b67..f33b653 100644 --- a/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.4-deployment-process.md +++ b/docs/Advanced-old/08-workflow/8.5-workflow-process/8.5.4-deployment-process.md @@ -149,24 +149,24 @@ jobs: ### 部署前 -- [ ] 代码已合并到 main 分支 -- [ ] 所有测试通过 -- [ ] 环境变量配置正确 -- [ ] 数据库迁移准备就绪 -- [ ] 通知相关人员 +- +- +- +- +- ### 部署中 -- [ ] 监控部署进度 -- [ ] 检查日志输出 -- [ ] 验证服务启动 +- +- +- ### 部署后 -- [ ] 访问关键页面验证 -- [ ] 检查监控指标 -- [ ] 确认日志正常 -- [ ] 保留回滚能力 +- +- +- +- ## 回滚策略 @@ -244,7 +244,7 @@ export async function GET() { ## 验收清单 -- [ ] 能编写 Next.js 的 Dockerfile -- [ ] 理解 CI/CD 自动部署流程 -- [ ] 知道部署前后的检查要点 -- [ ] 掌握回滚策略和监控基础 +- +- +- +- diff --git a/docs/Advanced-old/08-workflow/8.5-workflow-process/index.md b/docs/Advanced-old/08-workflow/8.5-workflow-process/index.md index d717fe5..3cf4fc8 100644 --- a/docs/Advanced-old/08-workflow/8.5-workflow-process/index.md +++ b/docs/Advanced-old/08-workflow/8.5-workflow-process/index.md @@ -62,7 +62,7 @@ AI 可以辅助流程中的多个环节： ## 验收清单 -- [ ] 理解开发流程各阶段的作用 -- [ ] 能根据项目规模选择合适的流程 -- [ ] 掌握需求对齐和技术评审的基本方法 -- [ ] 了解验收标准和部署规范 +- +- +- +- diff --git a/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.2-config.md b/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.2-config.md index c1612d7..1cde753 100644 --- a/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.2-config.md +++ b/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.2-config.md @@ -194,8 +194,8 @@ services: 部署前检查： -- [ ] 镜像版本是否正确 -- [ ] 端口是否冲突 -- [ ] 数据目录是否挂载 -- [ ] 敏感信息是否使用环境变量 -- [ ] 重启策略是否设置为 always +- +- +- +- +- diff --git a/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.5-troubleshooting.md b/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.5-troubleshooting.md index e6860e2..668d555 100644 --- a/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.5-troubleshooting.md +++ b/docs/Advanced-old/10-deploy/10.2-1panel-deployment/10.2.5-troubleshooting.md @@ -206,14 +206,14 @@ docker exec -it 容器名 sh 遇到问题时，按顺序检查： -- [ ] 容器是否启动成功 (`docker ps`) -- [ ] 容器日志有无错误 (`docker logs`) -- [ ] 端口是否正确映射 (`docker port`) -- [ ] 环境变量是否正确 (`docker exec ... env`) -- [ ] 网络是否连通 (`docker network inspect`) -- [ ] 磁盘空间是否充足 (`df -h`) -- [ ] 内存是否充足 (`free -m`) -- [ ] 安全组是否开放端口 +- +- +- +- +- +- +- +- ## AI 协作指南 diff --git a/docs/Advanced-old/10-deploy/10.5-monitoring/10.5.4-profiling.md b/docs/Advanced-old/10-deploy/10.5-monitoring/10.5.4-profiling.md index fe916a9..5da402e 100644 --- a/docs/Advanced-old/10-deploy/10.5-monitoring/10.5.4-profiling.md +++ b/docs/Advanced-old/10-deploy/10.5-monitoring/10.5.4-profiling.md @@ -214,24 +214,24 @@ const data = await fs.promises.readFile('large-file.txt'); ### 数据库层 -- [ ] 添加必要的索引 -- [ ] 使用 `include` 代替多次查询 -- [ ] 分页查询大数据集 -- [ ] 使用 Redis 缓存热点数据 +- +- +- +- ### 应用层 -- [ ] 启用 Gzip 压缩 -- [ ] 使用连接池 -- [ ] 避免同步操作 -- [ ] 优化大循环 +- +- +- +- ### 网络层 -- [ ] 使用 CDN -- [ ] 启用 HTTP/2 -- [ ] 合理设置缓存头 -- [ ] 图片压缩/WebP +- +- +- +- ## 压力测试 diff --git a/docs/Advanced-old/11-review/11.3-knowledge-base/11.3.3-curriculum.md b/docs/Advanced-old/11-review/11.3-knowledge-base/11.3.3-curriculum.md index cd4b169..7c6b227 100644 --- a/docs/Advanced-old/11-review/11.3-knowledge-base/11.3.3-curriculum.md +++ b/docs/Advanced-old/11-review/11.3-knowledge-base/11.3.3-curriculum.md @@ -98,21 +98,21 @@ typora-root-url: ../../public 实现一个简单的登录表单，包含用户名和密码字段 要求： -- [ ] 表单验证 -- [ ] 错误提示 -- [ ] 提交按钮 +- +- +- ## Level 2：进阶功能 在 Level 1 基础上添加： -- [ ] 记住我功能 -- [ ] 密码显示/隐藏 -- [ ] 登录状态持久化 +- +- +- ## Level 3：生产级别 在 Level 2 基础上添加： -- [ ] CSRF 防护 -- [ ] 登录频率限制 -- [ ] OAuth 第三方登录 +- +- +- ## 参考答案
diff --git a/docs/Advanced/01-environment-setup/07-creating-project.md b/docs/Advanced/01-environment-setup/07-creating-project.md index d3470c3..6f0c638 100644 --- a/docs/Advanced/01-environment-setup/07-creating-project.md +++ b/docs/Advanced/01-environment-setup/07-creating-project.md @@ -464,10 +464,10 @@ graph TB 4. **命名规范优先**：创建项目时就使用正确的命名 **创建项目检查清单**： -- [ ] 项目名不含中文和空格 -- [ ] 使用官方脚手架或 AI 推荐的模板 -- [ ] 理解各文件夹的职责 -- [ ] 项目能正常启动（`pnpm dev`） +- +- +- +- ## 相关内容 diff --git a/docs/Advanced/02-ai-tuning-guide/02-vibecoding-workflow.md b/docs/Advanced/02-ai-tuning-guide/02-vibecoding-workflow.md index 870780b..6cd254d 100644 --- a/docs/Advanced/02-ai-tuning-guide/02-vibecoding-workflow.md +++ b/docs/Advanced/02-ai-tuning-guide/02-vibecoding-workflow.md @@ -1391,13 +1391,13 @@ graph TB ## 提示词自检清单 发送提示词前检查： -- [ ] 任务描述清晰具体 -- [ ] 提供了必要的上下文 -- [ ] 明确了输出格式 -- [ ] 给了 AI"不确定"的出口 -- [ ] 包含了必要的约束条件 -- [ ] 避免了冗长的角色设定 -- [ ] 没有包含敏感信息（API Key、密码等） +- +- +- +- +- +- +- ## 常见问题 diff --git a/docs/Basic/01-awakening/1.5-hello-world/1.5.1-goals.md b/docs/Basic/01-awakening/1.5-hello-world/1.5.1-goals.md index 2fa7d4f..2514ebb 100644 --- a/docs/Basic/01-awakening/1.5-hello-world/1.5.1-goals.md +++ b/docs/Basic/01-awakening/1.5-hello-world/1.5.1-goals.md @@ -42,9 +42,9 @@ title: "1.5.1 目标与准备" 开始之前，确认你有： -- [ ] 一台能上网的电脑（手机也行，但电脑体验更好） -- [ ] 一个现代浏览器（Chrome、Edge、Safari 都可以） -- [ ] 3 分钟的时间 +- +- +- 没了。 diff --git a/docs/Basic/01-awakening/1.5-hello-world/1.5.2-step-by-step.md b/docs/Basic/01-awakening/1.5-hello-world/1.5.2-step-by-step.md index 2a847bc..d2bdf30 100644 --- a/docs/Basic/01-awakening/1.5-hello-world/1.5.2-step-by-step.md +++ b/docs/Basic/01-awakening/1.5-hello-world/1.5.2-step-by-step.md @@ -30,8 +30,8 @@ title: "1.5.2 Step by Step 操作" **检查点：** -- [ ] 界面已经加载完成 -- [ ] 你能看到输入框 +- +- ::: warning 如果遇到问题 - **页面加载很慢？** Bolt.new 在国内需要科学上网。建议国内用户使用 [豆包 AI 编程](https://www.doubao.com/chat/coding)，访问更流畅 @@ -72,8 +72,8 @@ AI 开始工作了！ **检查点：** -- [ ] AI 正在生成内容 -- [ ] 你能看到预览画面在变化 +- +- ::: tip 小技巧 不用紧盯着代码看。看不懂很正常——你只需要看最终的预览效果就行。 @@ -95,9 +95,9 @@ AI 开始工作了！ **检查点：** -- [ ] 页面正常显示，没有报错 -- [ ] 能看到名言和作者 -- [ ] 背景颜色是渐变的 +- +- +- ::: info 恭喜！ 如果你看到了上面这些，你已经成功做出了你的第一个 AI 网页！ @@ -136,8 +136,8 @@ AI 会根据你的要求，修改代码，预览窗口也会实时更新。 **检查点：** -- [ ] 修改生效了 -- [ ] 页面按你说的方式变化了 +- +- ## 完整的 Prompt 参考 diff --git a/docs/Basic/02-mindset/2.1-thinking-upgrade/2.1.1-jtbd-intro-theory.md b/docs/Basic/02-mindset/2.1-thinking-upgrade/2.1.1-jtbd-intro-theory.md index 34d1020..40a30e8 100644 --- a/docs/Basic/02-mindset/2.1-thinking-upgrade/2.1.1-jtbd-intro-theory.md +++ b/docs/Basic/02-mindset/2.1-thinking-upgrade/2.1.1-jtbd-intro-theory.md @@ -235,11 +235,11 @@ Jobs to be Done（待完成的任务），简称JTBD，是由哈佛商学院教 在进入下一节之前，确认你已经掌握： -- [ ] 能用一句话解释什么是JTBD框架 -- [ ] 知道"功能视角"和"任务视角"的区别 -- [ ] 能用模板写出一个完整的任务描述 -- [ ] 理解为什么"简单"往往比"复杂"更好 -- [ ] 完成了至少一个场景的JTBD分析练习 +- +- +- +- +- ## 关键概念速查 diff --git a/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.2-pre-mortem-failure-patterns.md b/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.2-pre-mortem-failure-patterns.md index 3aea5f6..189bdf9 100644 --- a/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.2-pre-mortem-failure-patterns.md +++ b/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.2-pre-mortem-failure-patterns.md @@ -333,37 +333,37 @@ AI不是全知的。它会： 在开始项目前，对照以下问题进行检查： **需求层面：** -- [ ] 我的需求描述足够具体吗？ -- [ ] 我知道为谁解决什么问题吗？ -- [ ] 核心功能是否控制在3-5个？ -- [ ] 我有明确的"不做清单"吗？ +- +- +- +- **技术层面：** -- [ ] 我选择的技术适合当前需求吗？ -- [ ] 我对基本的技术风险有了解吗？ -- [ ] 我有代码审查和测试流程吗？ -- [ ] 我知道如何验证AI生成的代码吗？ +- +- +- +- **场景层面：** -- [ ] 我的目标用户群体足够具体吗？ -- [ ] 我做过实际的用户调研吗？ -- [ ] 我了解现有替代方案吗？ -- [ ] 我评估过迁移成本吗？ +- +- +- +- **习惯层面：** -- [ ] 我考虑过用户的持续使用意愿吗？ -- [ ] 我评估过学习成本吗？ -- [ ] 我有推广和留存计划吗？ -- [ ] 我做过小规模验证吗？ +- +- +- +- ### 进行中检查 在项目进行过程中，定期检查： -- [ ] 用户反馈是否与预期一致？ -- [ ] 技术问题是否在可控范围内？ -- [ ] 用户实际使用场景是否符合假设？ -- [ ] 项目进展是否按计划进行？ +- +- +- +- ## 失败模式学习指南 diff --git a/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.3-pre-mortem-practical-guide.md b/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.3-pre-mortem-practical-guide.md index bc39096..457578c 100644 --- a/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.3-pre-mortem-practical-guide.md +++ b/docs/Basic/02-mindset/2.2-inversion-thinking/2.2.3-pre-mortem-practical-guide.md @@ -114,12 +114,12 @@ title: "2.2.3 Pre-mortem实战指南：操作步骤与工具模板" 根据预防措施调整项目需求和优先级。 **调整清单：** -- [ ] 缩小项目范围，专注核心功能 -- [ ] 调整技术方案，选择更合适的技术 -- [ ] 重新定义目标用户群体 -- [ ] 修改项目时间计划 -- [ ] 增加用户研究阶段 -- [ ] 制定推广和留存策略 +- +- +- +- +- +- ## Pre-mortem完整模板 @@ -418,12 +418,12 @@ Pre-mortem应该是一个持续的过程： 在开始你的项目之前，确保你能回答以下问题： -- [ ] 我做过Pre-mortem分析吗？ -- [ ] 我列出了至少10个可能的失败原因吗？ -- [ ] 我识别出了高可能性、高严重性的风险吗？ -- [ ] 我为这些风险制定了具体的预防措施吗？ -- [ ] 我把预防措施落实到项目计划中了吗？ -- [ ] 我设立了风险监控机制吗？ +- +- +- +- +- +- ### 关键概念速查 diff --git a/docs/Basic/02-mindset/2.3-subtraction-thinking/2.3.4-practice-guide.md b/docs/Basic/02-mindset/2.3-subtraction-thinking/2.3.4-practice-guide.md index fe13584..6a5636f 100644 --- a/docs/Basic/02-mindset/2.3-subtraction-thinking/2.3.4-practice-guide.md +++ b/docs/Basic/02-mindset/2.3-subtraction-thinking/2.3.4-practice-guide.md @@ -433,11 +433,11 @@ P2功能： 在开始动手开发之前，确认以下事项： -- [ ] 我有明确的核心假设（一句话能说清楚） -- [ ] 我有可衡量的验证标准（X个用户在Y时间内做了Z） -- [ ] 我的P0功能不超过5个 -- [ ] 我写下了「不做清单」 -- [ ] 我知道这个MVP要验证什么，不验证什么 +- +- +- +- +- ## 承上启下 diff --git a/docs/Basic/02-mindset/2.4-story-thinking/2.4.6-practice.md b/docs/Basic/02-mindset/2.4-story-thinking/2.4.6-practice.md index 9a8efce..fa8d45f 100644 --- a/docs/Basic/02-mindset/2.4-story-thinking/2.4.6-practice.md +++ b/docs/Basic/02-mindset/2.4-story-thinking/2.4.6-practice.md @@ -132,18 +132,18 @@ title: "2.4.6 实战练习：为你的项目应用故事思维" ### 故事完整性检查 -- [ ] 我能清楚说出用户是谁（有名字、有形象） -- [ ] 我能描述用户的日常（典型的一天/一周） -- [ ] 我能说出用户现在用什么方法解决问题 -- [ ] 我知道用户为什么对现有方法不满意 -- [ ] 我理解用户的深层动机（恐惧/渴望/期待） +- +- +- +- +- ### 设计指导性检查 -- [ ] 基于这个故事，我能判断「这个功能该不该做」 -- [ ] 基于这个故事，我能判断「哪个功能更重要」 -- [ ] 这个故事能帮助 AI 理解我的需求 -- [ ] 读这个故事，别人也能「看到」这个用户 +- +- +- +- ### 常见问题排查 diff --git a/docs/Basic/02-mindset/2.5-soul-questions/2.5.4-why-you.md b/docs/Basic/02-mindset/2.5-soul-questions/2.5.4-why-you.md index 28fcd8b..84bd102 100644 --- a/docs/Basic/02-mindset/2.5-soul-questions/2.5.4-why-you.md +++ b/docs/Basic/02-mindset/2.5-soul-questions/2.5.4-why-you.md @@ -115,10 +115,10 @@ title: "2.5.4 问题三：为什么选你？" **调研清单：** -- [ ] 搜索一下：有没有现成的工具/App 能解决这个问题？ -- [ ] 如果有，下载试用：它哪里好？哪里不行？ -- [ ] 问问周围的人：他们现在怎么解决这个问题？ -- [ ] 如果现有方案够用：是否真的需要自己做？ +- +- +- +- 很多时候，调研完你会发现：已经有很好的工具了，直接用就行。 diff --git a/docs/Basic/02-mindset/2.6-scenario-application/2.6.2-data-analysis.md b/docs/Basic/02-mindset/2.6-scenario-application/2.6.2-data-analysis.md index 8721053..85d9fa1 100644 --- a/docs/Basic/02-mindset/2.6-scenario-application/2.6.2-data-analysis.md +++ b/docs/Basic/02-mindset/2.6-scenario-application/2.6.2-data-analysis.md @@ -184,11 +184,11 @@ Q3销售额比Q2下滑了，主要原因是什么？ 在把分析结果发出去之前，检查这几点： -- [ ] 我能用一句话说清楚「这个分析回答了什么问题」吗？ -- [ ] 看这个分析的人，能在 30 秒内抓到重点吗？ -- [ ] 每张图表都有明确的结论，而不只是展示数据吗？ -- [ ] 我有没有做太多图表，导致重点被淹没？ -- [ ] 我的分析能帮对方做出决策吗？还是只是「展示了数据」？ +- +- +- +- +- ## 核心要点 diff --git a/docs/Basic/02-mindset/2.6-scenario-application/2.6.3-automation.md b/docs/Basic/02-mindset/2.6-scenario-application/2.6.3-automation.md index 92c1365..1c10d3e 100644 --- a/docs/Basic/02-mindset/2.6-scenario-application/2.6.3-automation.md +++ b/docs/Basic/02-mindset/2.6-scenario-application/2.6.3-automation.md @@ -223,11 +223,11 @@ Windows 11，Python已安装。 在运行脚本之前，检查这几点： -- [ ] 我测试过脚本在「正常情况」下能正确运行吗？ -- [ ] 我测试过脚本在「异常情况」下（如文件不存在）的表现吗？ -- [ ] 我有没有备份原始文件，以防脚本出错？ -- [ ] 脚本运行后，我会检查结果再进行下一步吗？ -- [ ] 我知道脚本做了什么，而不是「反正能用就行」吗？ +- +- +- +- +- ## 核心要点 diff --git a/docs/Basic/02-mindset/2.6-scenario-application/2.6.4-personal-tools.md b/docs/Basic/02-mindset/2.6-scenario-application/2.6.4-personal-tools.md index 3b7f8e1..b0e75b7 100644 --- a/docs/Basic/02-mindset/2.6-scenario-application/2.6.4-personal-tools.md +++ b/docs/Basic/02-mindset/2.6-scenario-application/2.6.4-personal-tools.md @@ -210,11 +210,11 @@ title: "2.6.4 个人工具场景：警惕过度设计的陷阱" ## 个人工具自检清单 -- [ ] 我能用一句话说清楚「这个工具解决什么问题」吗？ -- [ ] 这个痛点我这周遇到过吗？ -- [ ] 我能描述「今天什么时候会用它」吗？ -- [ ] 第一版的功能列表是否只有1-2个？ -- [ ] 我有没有克制住「既然做了就做全」的冲动？ +- +- +- +- +- ## 核心要点 diff --git a/docs/Basic/02-mindset/2.6-scenario-application/2.6.5-for-family.md b/docs/Basic/02-mindset/2.6-scenario-application/2.6.5-for-family.md index 2073daf..a3246b3 100644 --- a/docs/Basic/02-mindset/2.6-scenario-application/2.6.5-for-family.md +++ b/docs/Basic/02-mindset/2.6-scenario-application/2.6.5-for-family.md @@ -245,13 +245,13 @@ title: "2.6.5 家人工具场景：站在他们的角度设计" 发给家人之前，检查这几点： -- [ ] 我在自己手机上测试过了吗？ -- [ ] 我把字体调大后还能正常显示吗？ -- [ ] 所有按钮都足够大，容易点到吗？ -- [ ] 操作后有明确的反馈吗？ -- [ ] 我妈/爸能理解界面上的每个文字吗？ -- [ ] 网络不好的时候能正常打开吗？ -- [ ] 我写了简单的使用说明发给他们了吗？ +- +- +- +- +- +- +- ## 核心要点 diff --git a/docs/Basic/02-mindset/appendix/C-mistakes.md b/docs/Basic/02-mindset/appendix/C-mistakes.md index 322d2c8..53df7b0 100644 --- a/docs/Basic/02-mindset/appendix/C-mistakes.md +++ b/docs/Basic/02-mindset/appendix/C-mistakes.md @@ -444,13 +444,13 @@ MVP 的原则是：功能要少，但核心功能要做到位。 完成项目前，用这个清单快速自检： -- [ ] 我用的是「任务描述」而非「功能清单」？ -- [ ] 我考虑了功能、情感、社会三层任务？ -- [ ] 每个风险都有对应的预防措施？ -- [ ] MVP 的核心功能做到位了，而不是凑合？ -- [ ] 不做清单是具体的功能名称，而非空泛描述？ -- [ ] 用户画像具体到「能发微信」的程度？ -- [ ] 痛点带有负面情绪，而非只是「想要」？ -- [ ] 「为什么选我」说清楚了和现有方案的差异？ +- +- +- +- +- +- +- +- 如果有任何一项打不了勾，回到对应章节重新思考。 diff --git a/docs/Basic/03-technique/3.1-prompt-basics/3.1.2-context-is-king.md b/docs/Basic/03-technique/3.1-prompt-basics/3.1.2-context-is-king.md index af11853..e83a4b5 100644 --- a/docs/Basic/03-technique/3.1-prompt-basics/3.1.2-context-is-king.md +++ b/docs/Basic/03-technique/3.1-prompt-basics/3.1.2-context-is-king.md @@ -191,21 +191,21 @@ AI 会开始猜测： 在向 AI 提问之前，用这个清单快速检查： ### 项目上下文 ✓ -- [ ] 说明了项目类型和目标 -- [ ] 说明了技术栈（如果涉及代码） -- [ ] 说明了目标用户是谁 -- [ ] 说明了设计原则或风格偏好 +- +- +- +- ### 任务上下文 ✓ -- [ ] 清晰描述了当前要完成的任务 -- [ ] 说明了输入和输出 -- [ ] 列出了约束条件和边界情况 -- [ ] 指定了期望的输出格式 +- +- +- +- ### 个人上下文 ✓ -- [ ] 说明了自己的技术水平 -- [ ] 告诉 AI 你需要什么样的解释 -- [ ] 说明了特殊偏好（如果有） +- +- +- 不需要每次都填满所有项。根据任务复杂度，选择必要的信息提供即可。 diff --git a/docs/Basic/03-technique/3.1-prompt-basics/3.1.3-common-mistakes.md b/docs/Basic/03-technique/3.1-prompt-basics/3.1.3-common-mistakes.md index bf7567a..536f30d 100644 --- a/docs/Basic/03-technique/3.1-prompt-basics/3.1.3-common-mistakes.md +++ b/docs/Basic/03-technique/3.1-prompt-basics/3.1.3-common-mistakes.md @@ -256,11 +256,11 @@ AI 可能给你： 在按下发送键之前，快速过一遍： -- [ ] **范围是否聚焦**：这次只让 AI 做一件事？ -- [ ] **上下文是否充足**：AI 有足够的背景信息吗？ -- [ ] **目标是否明确**：说清楚了「什么算完成」？ -- [ ] **格式是否指定**：告诉 AI 想要什么样的输出格式？ -- [ ] **边界是否清晰**：说明了「不要什么」？ +- +- +- +- +- 不需要每次都完美，但避开这五个常见错误，你的 AI 对话质量会提升一大截。 diff --git a/docs/Basic/03-technique/3.2-structured-frameworks/3.2.5-framework-guide.md b/docs/Basic/03-technique/3.2-structured-frameworks/3.2.5-framework-guide.md index 3aceacb..bcf0315 100644 --- a/docs/Basic/03-technique/3.2-structured-frameworks/3.2.5-framework-guide.md +++ b/docs/Basic/03-technique/3.2-structured-frameworks/3.2.5-framework-guide.md @@ -95,21 +95,21 @@ graph TD ### 基础检查（必须） -- [ ] **任务是否清晰**：AI 能明白你要它做什么吗？ -- [ ] **背景是否充足**：AI 有足够信息做出正确判断吗？ -- [ ] **约束是否明确**：AI 知道什么不该做吗？ +- +- +- ### 进阶检查（推荐） -- [ ] **角色是否指定**：AI 应该以什么身份回答？ -- [ ] **格式是否说明**：你期望什么形式的输出？ -- [ ] **示例是否需要**：给个例子会不会更清楚？ +- +- +- ### 反思检查（可选） -- [ ] **有没有说太多**：是不是一次要求太多了？ -- [ ] **有没有说太少**：是不是遗漏了关键信息？ -- [ ] **边界是否清晰**：AI 会不会"加戏"？ +- +- +- ## 框架切换信号 diff --git a/docs/Basic/03-technique/3.3-advanced-techniques/3.3.6-technique-guide.md b/docs/Basic/03-technique/3.3-advanced-techniques/3.3.6-technique-guide.md index 6f92c52..e740995 100644 --- a/docs/Basic/03-technique/3.3-advanced-techniques/3.3.6-technique-guide.md +++ b/docs/Basic/03-technique/3.3-advanced-techniques/3.3.6-technique-guide.md @@ -225,11 +225,11 @@ title: "3.3.6 技巧选择指南：什么情况用什么技巧" 在进入下一节之前，确认你已经： -- [ ] 理解 Zero-shot：直接问 AI 会做的任务 -- [ ] 理解 Few-shot：用示例教会 AI 格式 -- [ ] 理解 Chain of Thought：复杂推理分步思考 -- [ ] 知道 Tree of Thoughts 的存在：方案对比时使用 -- [ ] 理解 Self-Critique：重要输出让 AI 自查 -- [ ] 能根据任务类型选择合适的技巧 +- +- +- +- +- +- 如果以上都打勾了，恭喜你，准备好进入 3.4 节了！ diff --git a/docs/Basic/03-technique/3.4-first-prd/3.4.2-integrate-chapter2.md b/docs/Basic/03-technique/3.4-first-prd/3.4.2-integrate-chapter2.md index 8fade88..b1ffbda 100644 --- a/docs/Basic/03-technique/3.4-first-prd/3.4.2-integrate-chapter2.md +++ b/docs/Basic/03-technique/3.4-first-prd/3.4.2-integrate-chapter2.md @@ -180,10 +180,10 @@ PRD 里的用户描述只需要保留**与产品相关的特征**。 你可以用这个快速版自检清单： -- [ ] 我能用一句话说清楚"这是给谁用的"吗？ -- [ ] 我能说出用户遇到的具体问题吗？ -- [ ] 我能列出 3 个必须有的核心功能吗？ -- [ ] 我能列出 3 个明确不做的功能吗？ +- +- +- +- 如果这四个问题你都能回答，就可以继续。如果有任何一个答不上来，建议花 10 分钟快速浏览第二章的 2.3（减法思维）和 2.5（灵魂三问）。 diff --git a/docs/Basic/03-technique/3.4-first-prd/3.4.4-priority-development.md b/docs/Basic/03-technique/3.4-first-prd/3.4.4-priority-development.md index 771b62a..9bfc03b 100644 --- a/docs/Basic/03-technique/3.4-first-prd/3.4.4-priority-development.md +++ b/docs/Basic/03-technique/3.4-first-prd/3.4.4-priority-development.md @@ -113,11 +113,11 @@ AI 返回了一大堆代码。小李运行后发现： AI 返回代码后，按这个清单验证： -- [ ] 能添加任务吗？ -- [ ] 任务能显示在列表吗？ -- [ ] 能勾选完成吗？ -- [ ] 刷新后数据还在吗？ -- [ ] 有没有多做了什么功能？ +- +- +- +- +- **全部通过后，才进入第二轮。** @@ -165,10 +165,10 @@ P0 功能已完成并验证通过。现在请添加 P1 功能。 ### 第二轮验证清单 -- [ ] P0 功能还能正常工作吗？ -- [ ] 删除功能正常吗？ -- [ ] 计数显示正确吗？ -- [ ] 删除后计数会更新吗？ +- +- +- +- ## 第三轮：添加 P2 功能（可选） diff --git a/docs/Basic/03-technique/3.4-first-prd/3.4.5-prd-practice.md b/docs/Basic/03-technique/3.4-first-prd/3.4.5-prd-practice.md index c748300..5b8a19c 100644 --- a/docs/Basic/03-technique/3.4-first-prd/3.4.5-prd-practice.md +++ b/docs/Basic/03-technique/3.4-first-prd/3.4.5-prd-practice.md @@ -234,25 +234,25 @@ AI 返回代码后，小李按验证清单测试，确认无误后进入 P1 开 写完 PRD 后，用这个清单检查： ### 内容完整性 -- [ ] 一句话描述清楚了"给谁用"和"做什么" -- [ ] 目标用户描述了与产品相关的特征 -- [ ] 要解决的问题描述了痛点，而不是解决方案 -- [ ] 核心功能（P0）不超过 5 个 -- [ ] "不做清单"明确列出了边界 -- [ ] 用户流程覆盖了关键步骤 -- [ ] 技术约束说明了技术限制 -- [ ] 成功标准是可验证的 +- +- +- +- +- +- +- +- ### AI 可读性 -- [ ] 使用了 Markdown 格式 -- [ ] 用列表而不是段落 -- [ ] 没有模糊表述（如"好看"、"方便"） -- [ ] "不要"的边界足够明确 +- +- +- +- ### 与第二章的衔接 -- [ ] 灵魂三问的答案融入了"用户"和"问题"部分 -- [ ] P0/P1/P2 划分来自减法思维 -- [ ] 用户流程简化自用户旅程地图 +- +- +- ## 本节核心要点 diff --git a/docs/Basic/03-technique/3.5-iterative-dialogue/3.5.2-iteration-pattern.md b/docs/Basic/03-technique/3.5-iterative-dialogue/3.5.2-iteration-pattern.md index e8a392d..3c43c3c 100644 --- a/docs/Basic/03-technique/3.5-iterative-dialogue/3.5.2-iteration-pattern.md +++ b/docs/Basic/03-technique/3.5-iterative-dialogue/3.5.2-iteration-pattern.md @@ -43,9 +43,9 @@ title: "3.5.2 迭代对话的基本模式" - 重点看：AI 的理解对不对？大方向对不对？ **检查点**： -- [ ] AI 做的是你想要的功能吗？ -- [ ] 技术方案和你预期一致吗？ -- [ ] 如果方向错了，现在就要纠正 +- +- +- **常见问题**：方向错误。比如你想要一个弹窗，AI 给你做了一个新页面。 @@ -59,9 +59,9 @@ title: "3.5.2 迭代对话的基本模式" - 可以一次提多个修改，但不要超过 3-5 个 **检查点**： -- [ ] 核心功能都实现了吗？ -- [ ] 交互逻辑正确吗？ -- [ ] 有没有明显的 bug？ +- +- +- **常见问题**：功能缺失或逻辑错误。比如缺少输入验证，或者按钮点击没反应。 @@ -75,9 +75,9 @@ title: "3.5.2 迭代对话的基本模式" - 优化命名、注释、结构 **检查点**： -- [ ] 代码结构清晰吗？ -- [ ] 边界情况处理了吗？ -- [ ] 代码可以直接用于生产吗？ +- +- +- **常见问题**：代码能用但不够好。比如逻辑全写在一个函数里，或者没有错误处理。 diff --git a/docs/Basic/03-technique/3.6-debugging-ai/3.6.2-diagnose-problems.md b/docs/Basic/03-technique/3.6-debugging-ai/3.6.2-diagnose-problems.md index a2dc7cb..20c2eb6 100644 --- a/docs/Basic/03-technique/3.6-debugging-ai/3.6.2-diagnose-problems.md +++ b/docs/Basic/03-technique/3.6-debugging-ai/3.6.2-diagnose-problems.md @@ -44,9 +44,9 @@ npx tsc --noEmit # 检查类型错误（如果用 TypeScript） 对照代码中的 import 语句，检查： -- [ ] 引入的包是否存在？（用 3.6.1 中的验证方法） -- [ ] 调用的方法是否真的存在于该包中？ -- [ ] 版本是否匹配？ +- +- +- **能发现的问题**： - 包幻觉 diff --git a/docs/Basic/03-technique/3.6-debugging-ai/3.6.4-fallback-strategies.md b/docs/Basic/03-technique/3.6-debugging-ai/3.6.4-fallback-strategies.md index 0302abe..37ccf92 100644 --- a/docs/Basic/03-technique/3.6-debugging-ai/3.6.4-fallback-strategies.md +++ b/docs/Basic/03-technique/3.6-debugging-ai/3.6.4-fallback-strategies.md @@ -152,11 +152,11 @@ TypeError map undefined react site:stackoverflow.com 4. 对于复杂问题，你自己改 **审查要点清单**： -- [ ] 代码逻辑是否正确？ -- [ ] 边界情况是否处理？ -- [ ] 引用的库和 API 是否存在？ -- [ ] 是否有安全隐患？ -- [ ] 是否符合项目规范？ +- +- +- +- +- ### 模式三：分工协作 diff --git a/docs/Basic/03-technique/3.6-debugging-ai/3.6.5-prevention.md b/docs/Basic/03-technique/3.6-debugging-ai/3.6.5-prevention.md index b68b56e..85bc3a2 100644 --- a/docs/Basic/03-technique/3.6-debugging-ai/3.6.5-prevention.md +++ b/docs/Basic/03-technique/3.6-debugging-ai/3.6.5-prevention.md @@ -19,11 +19,11 @@ title: "3.6.5 预防胜于治疗：减少\"不听话\"的概率" ### 5 条快速自检 -- [ ] **任务是否聚焦？** 这次只让 AI 做一件事？ -- [ ] **上下文是否充足？** AI 有足够的背景信息理解任务？ -- [ ] **目标是否明确？** 说清楚了「什么算完成」？ -- [ ] **约束是否清晰？** 说明了「不要什么」？ -- [ ] **格式是否指定？** 告诉 AI 期望的输出格式？ +- +- +- +- +- 这和 3.1.3 中学的「五大错误」相对应。养成习惯后，这个检查只需要几秒钟。 @@ -157,21 +157,21 @@ title: "3.6.5 预防胜于治疗：减少\"不听话\"的概率" ### 开始前 -- [ ] 我清楚知道这次要让 AI 做什么（一件事） -- [ ] 我准备好了必要的上下文信息 -- [ ] 我知道什么算「完成」 +- +- +- ### 发送后 -- [ ] AI 的复述和我的意图一致吗？ -- [ ] AI 的技术方案合理吗？ -- [ ] AI 用的库和 API 我认识吗？ +- +- +- ### 收到代码后 -- [ ] 代码能跑吗？ -- [ ] 结果符合预期吗？ -- [ ] 边界情况处理了吗？ +- +- +- ## 本节要点 diff --git a/docs/Basic/03-technique/appendix/index.md b/docs/Basic/03-technique/appendix/index.md index c4f91b5..e94c6b6 100644 --- a/docs/Basic/03-technique/appendix/index.md +++ b/docs/Basic/03-technique/appendix/index.md @@ -35,11 +35,11 @@ title: "附录：常用 Prompt 模板库" 在发送 Prompt 之前，快速检查： -- [ ] **背景信息完整吗？** 项目类型、技术栈、当前进度 -- [ ] **任务描述清晰吗？** 具体要做什么，输入输出是什么 -- [ ] **约束条件写了吗？** 必须遵守的限制，不能做什么 -- [ ] **占位符都替换了吗？** 没有遗留 `[方括号]` 内容 -- [ ] **期望格式说明了吗？** 要完整代码还是解释 +- +- +- +- +- ## 本附录结构 diff --git a/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.3-environment-check.md b/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.3-environment-check.md index b7c8281..111a3b1 100644 --- a/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.3-environment-check.md +++ b/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.3-environment-check.md @@ -15,31 +15,31 @@ order: 4 ### ✅ 检查 1：工具能打开 -- [ ] AI IDE 已安装并能正常启动 -- [ ] 能正常登录（如需要） -- [ ] 界面加载完成，没有报错 +- +- +- ### ✅ 检查 2：网络正常 -- [ ] AI IDE 能连接到服务器 -- [ ] 对话区输入后能收到 AI 回复 +- +- ### ✅ 检查 3：额度充足 -- [ ] 确认还有免费额度可用 -- [ ] 或已准备好付费方案 +- +- ### ✅ 检查 4：时间充足 -- [ ] 有至少 30 分钟的连续时间（完成第一轮） -- [ ] 最好有 1-2 小时（完成整个第四章） -- [ ] 期间不会被频繁打断 +- +- +- ### ✅ 检查 5：心态就位 -- [ ] 准备好接受"第一次不完美" -- [ ] 准备好看到报错信息 -- [ ] 相信"报错可以用 AI 帮忙修" +- +- +- ## 常见问题速查 diff --git a/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.4-checklist.md b/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.4-checklist.md index 213e076..1fd060b 100644 --- a/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.4-checklist.md +++ b/docs/Basic/04-practice-0-to-1/4.1-before-start/4.1.4-checklist.md @@ -13,21 +13,21 @@ order: 5 ### 我知道要做什么 -- [ ] 我要做一个**待办清单**（或其他已想好的项目） -- [ ] 我知道第一版的核心功能：添加、显示、完成、删除、保存 -- [ ] 我知道什么**不做**：账号系统、云同步、提醒通知 +- +- +- ### 我的工具已就绪 -- [ ] AI IDE 已打开，能正常使用 -- [ ] 测试 Prompt 通过（"Hello, Vibe Coding!" 能显示） -- [ ] 我知道项目保存在哪里 +- +- +- ### 我的心态已就位 -- [ ] 我准备好看到**报错信息**（这很正常） -- [ ] 我准备好**第一次不完美**（先跑通再优化） -- [ ] 我相信 AI 可以帮我**修复问题** +- +- +- ## 判断标准 diff --git a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.1-first-prompt.md b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.1-first-prompt.md index 23884e8..0b95668 100644 --- a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.1-first-prompt.md +++ b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.1-first-prompt.md @@ -148,12 +148,12 @@ order: 2 在发送之前，用这个清单检查一下： -- [ ] 说明了项目背景（做什么、给谁用）？ -- [ ] 列出了要包含的页面元素？ -- [ ] 指定了技术约束（HTML + CSS，不用框架）？ -- [ ] 说明了设计风格和配色偏好？ -- [ ] 提到了响应式需求？ -- [ ] 告诉 AI 你是初学者，需要注释？ +- +- +- +- +- +- ## 选择哪个版本？ @@ -169,7 +169,7 @@ order: 2 ## 本步检查点 -- [ ] 选择了适合自己的 Prompt 版本 -- [ ] 复制好了 Prompt，准备发送给 AI +- +- → [4.2.2 生成静态页面](./4.2.2-generate-static.md) diff --git a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.2-generate-static.md b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.2-generate-static.md index 3e79b13..54963e9 100644 --- a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.2-generate-static.md +++ b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.2-generate-static.md @@ -51,12 +51,12 @@ AI 生成完成后，你应该能看到一个待办清单页面，包含以下 具体检查这些元素是否存在： -- [ ] 页面有标题"我的待办清单" -- [ ] 有一个输入框 -- [ ] 有一个"添加"按钮 -- [ ] 有任务列表，显示几条假数据 -- [ ] 每个任务有"完成"和"删除"按钮 -- [ ] 整体布局居中，看起来比较整齐 +- +- +- +- +- +- ## 五种可能的情况及处理 @@ -192,9 +192,9 @@ AI 生成完成后，你应该能看到一个待办清单页面，包含以下 继续之前，确认： -- [ ] AI 已经生成了代码 -- [ ] 能在浏览器中看到页面 -- [ ] 页面包含标题、输入框、按钮、任务列表 +- +- +- 如果样式不满意，进入下一步调整。如果已经满意，可以直接跳到 [4.2.4 阶段性成果检查](./4.2.4-checkpoint.md)。 diff --git a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.3-adjust-style.md b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.3-adjust-style.md index f4e8eb4..8f3ed33 100644 --- a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.3-adjust-style.md +++ b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.3-adjust-style.md @@ -192,23 +192,23 @@ order: 4 ### 必须满足 -- [ ] 所有元素都在正确的位置 -- [ ] 可以清楚地看到标题、输入框、按钮、任务列表 -- [ ] 页面在手机宽度（375px）下不会变形 -- [ ] 没有明显的视觉问题（文字溢出、元素重叠） +- +- +- +- ### 加分项（有更好，没有也行） -- [ ] 配色符合你的审美 -- [ ] 鼠标悬停有交互反馈 -- [ ] 整体风格统一 -- [ ] 间距看起来舒适 +- +- +- +- ### 不需要追求的 -- [ ] 完美的像素级对齐 -- [ ] 动画效果 -- [ ] 复杂的视觉效果 +- +- +- ::: warning 重要 80 分就够了，先跑通再优化。如果你已经调整了 3-4 轮，差不多就可以停了。 @@ -227,9 +227,9 @@ order: 4 调整完成后，确认： -- [ ] 整体布局正确（标题、输入区、列表区都在） -- [ ] 配色基本满意 -- [ ] 间距和尺寸看起来舒适 -- [ ] 手机宽度下也能正常显示 +- +- +- +- → [4.2.4 阶段性成果检查](./4.2.4-checkpoint.md) diff --git a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.4-checkpoint.md b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.4-checkpoint.md index a755d28..30bc031 100644 --- a/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.4-checkpoint.md +++ b/docs/Basic/04-practice-0-to-1/4.2-build-page/4.2.4-checkpoint.md @@ -15,18 +15,18 @@ order: 5 ### 必须项 -- [ ] **页面能正常显示**：在浏览器中打开，没有空白或报错 -- [ ] **标题存在**：能看到"我的待办清单"（或你自定义的标题） -- [ ] **输入框存在**：有一个可以输入文字的输入框 -- [ ] **添加按钮存在**：有一个"添加"按钮 -- [ ] **任务列表存在**：能看到任务列表区域（即使是假数据） -- [ ] **操作按钮存在**：每个任务有"完成"和"删除"按钮 +- +- +- +- +- +- ### 加分项 -- [ ] 整体样式你基本满意 -- [ ] 鼠标悬停在按钮上有视觉反馈 -- [ ] 在手机尺寸下也能正常显示 +- +- +- ## 如何测试响应式效果 @@ -39,10 +39,10 @@ order: 5 检查这些情况： -- [ ] 页面内容没有超出屏幕 -- [ ] 文字大小在手机上也能看清 -- [ ] 按钮在手机上也容易点击 -- [ ] 输入框宽度适合手机屏幕 +- +- +- +- ::: tip 小技巧 如果手机上显示有问题，回到 4.2.3 节，使用"响应式适配类"的调整 Prompt。 diff --git a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.1-add-task.md b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.1-add-task.md index c7d66a5..12f5f0d 100644 --- a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.1-add-task.md +++ b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.1-add-task.md @@ -70,11 +70,11 @@ order: 2 在继续之前，确认以下几点： -- [ ] 输入内容后点击添加，任务出现在列表中 -- [ ] 添加后输入框会清空 -- [ ] 空输入不会添加空任务 -- [ ] 可以连续添加多个任务 -- [ ] 页面没有报错（按 F12 打开控制台检查） +- +- +- +- +- ## ⚠️ 常见问题排查 diff --git a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.2-delete-task.md b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.2-delete-task.md index c0d3f9b..f02be88 100644 --- a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.2-delete-task.md +++ b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.2-delete-task.md @@ -64,10 +64,10 @@ order: 3 ## 🔍 检查点 -- [ ] 点击删除按钮，对应任务消失 -- [ ] 删除一个任务不影响其他任务 -- [ ] 可以连续删除多个任务 -- [ ] 删除全部任务后，列表为空（正常显示） +- +- +- +- ## ⚠️ 常见问题排查 diff --git a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.3-complete-task.md b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.3-complete-task.md index 9349084..9d9638e 100644 --- a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.3-complete-task.md +++ b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.3-complete-task.md @@ -65,12 +65,12 @@ order: 4 ## 🔍 检查点 -- [ ] 点击完成按钮，任务文字有删除线 -- [ ] 点击完成按钮，文字颜色变灰 -- [ ] 点击完成按钮，按钮文字变成"取消" -- [ ] 再次点击，所有效果恢复原状 -- [ ] 标记完成不影响其他任务 -- [ ] 已完成的任务仍然可以删除 +- +- +- +- +- +- ## ⚠️ 常见问题排查 diff --git a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.4-iterate.md b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.4-iterate.md index 90baed5..2651b93 100644 --- a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.4-iterate.md +++ b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.4-iterate.md @@ -184,9 +184,9 @@ order: 5 趁热打铁，尝试用本节学到的技巧，对你的待办清单做一些优化： -- [ ] 调整一个你不满意的样式 -- [ ] 添加一个你想要的小功能 -- [ ] 如果有 Bug，尝试用"描述问题"的句式让 AI 修复 +- +- +- 做完后，进入下一节确认所有功能正常。 diff --git a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.5-checkpoint.md b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.5-checkpoint.md index 8e3b4c5..f6c0905 100644 --- a/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.5-checkpoint.md +++ b/docs/Basic/04-practice-0-to-1/4.3-core-features/4.3.5-checkpoint.md @@ -15,28 +15,28 @@ order: 6 ### 添加任务 -- [ ] 输入内容后点击添加，任务出现在列表中 -- [ ] 添加后输入框自动清空 -- [ ] 空输入不会添加空任务 -- [ ] 可以连续添加多个任务 +- +- +- +- ### 删除任务 -- [ ] 点击删除按钮，对应任务消失 -- [ ] 删除一个任务不影响其他任务 -- [ ] 新添加的任务也能正常删除 +- +- +- ### 标记完成 -- [ ] 点击完成按钮，任务有视觉变化（删除线、变灰） -- [ ] 再次点击可以取消完成状态 -- [ ] 完成/取消操作可以反复进行 -- [ ] 已完成的任务仍然可以删除 +- +- +- +- ### 整体检查 -- [ ] 按 F12 打开控制台，没有红色报错信息 -- [ ] 三个功能可以配合使用，互不影响 +- +- ## 🎉 第二轮完成！ diff --git a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.1-why-storage.md b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.1-why-storage.md index 4ec836c..245532f 100644 --- a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.1-why-storage.md +++ b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.1-why-storage.md @@ -68,9 +68,9 @@ order: 2 在继续之前，确认你理解了： -- [ ] 目前待办清单的数据为什么会在刷新后消失 -- [ ] localStorage 是什么（浏览器提供的本地存储空间） -- [ ] 为什么我们选择 localStorage 作为第一步 +- +- +- 理解了这些概念，接下来就可以动手实现了。 diff --git a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.2-localstorage.md b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.2-localstorage.md index 62efceb..72d534f 100644 --- a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.2-localstorage.md +++ b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.2-localstorage.md @@ -96,11 +96,11 @@ localStorage 只能存储文本（字符串）。如果要存储任务列表这 在继续之前，确认以下几点： -- [ ] 代码更新后，页面能正常显示 -- [ ] 添加一个任务，开发者工具中能看到 `todoList` 数据 -- [ ] 再添加一个任务，`todoList` 的值会更新 -- [ ] 标记一个任务为完成，`todoList` 的值会更新 -- [ ] 删除一个任务，`todoList` 的值会更新 +- +- +- +- +- ### 常见问题排查 @@ -185,9 +185,9 @@ Local Storage 中的 todoList 值显示为 [object Object] 或 undefined。 ### 检查点 -- [ ] 刷新页面后，之前添加的任务还在 -- [ ] 刷新页面后，任务的完成状态也保留了 -- [ ] 关闭浏览器标签页，重新打开文件，任务还在 +- +- +- ## 技术小贴士：JSON 是什么？ diff --git a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.3-test-persistence.md b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.3-test-persistence.md index 73cb893..4d0bfe6 100644 --- a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.3-test-persistence.md +++ b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.3-test-persistence.md @@ -81,12 +81,12 @@ order: 4 完成所有测试后，确认以下项目都通过： -- [ ] 添加任务后，刷新页面任务还在 -- [ ] 删除任务后，刷新页面任务不会回来 -- [ ] 标记完成后，刷新页面完成状态保留 -- [ ] 取消完成后，刷新页面状态正确更新 -- [ ] 关闭标签页再打开，数据完整保留 -- [ ] 在开发者工具中能看到 `todoList` 数据 +- +- +- +- +- +- ## 常见问题排查 @@ -148,9 +148,9 @@ order: 4 在继续之前，确认： -- [ ] 完成了五步验证法的所有测试 -- [ ] 所有测试场景都通过 -- [ ] 没有控制台报错 +- +- +- 全部通过后，进入最后的完整功能验证。 diff --git a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.4-final-verification.md b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.4-final-verification.md index 6e69bcd..c455330 100644 --- a/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.4-final-verification.md +++ b/docs/Basic/04-practice-0-to-1/4.4-data-storage/4.4.4-final-verification.md @@ -32,12 +32,12 @@ order: 5 刷新/重新打开后，确认以下状态： -- [ ] 任务数量：2 个 -- [ ] "买牛奶"：显示已完成状态（有删除线或变灰） -- [ ] "学习 Vibe Coding"：显示未完成状态 -- [ ] "写周报"：已被删除，不应该出现 -- [ ] 控制台无报错 -- [ ] 添加、删除、完成功能仍然正常工作 +- +- +- +- +- +- ## 第三轮完成 diff --git a/docs/Basic/04-practice-0-to-1/4.5-debug/4.5.4-debug-mindset.md b/docs/Basic/04-practice-0-to-1/4.5-debug/4.5.4-debug-mindset.md index 6f7207a..1609551 100644 --- a/docs/Basic/04-practice-0-to-1/4.5-debug/4.5.4-debug-mindset.md +++ b/docs/Basic/04-practice-0-to-1/4.5-debug/4.5.4-debug-mindset.md @@ -123,30 +123,30 @@ todo-v4.html ← 完成 localStorage ### 初步检查 -- [ ] 打开控制台，查看是否有红色报错 -- [ ] 阅读报错信息，识别错误类型 -- [ ] 根据行号定位到具体代码位置 +- +- +- ### 信息收集 -- [ ] 记录错误现象（发生了什么） -- [ ] 记录期望行为（应该发生什么） -- [ ] 复制完整的报错信息 -- [ ] 定位相关代码（报错行附近 10-20 行） +- +- +- +- ### 问题解决 -- [ ] 先诊断原因，再请求修复 -- [ ] 一次只解决一个问题 -- [ ] 替换代码前做好备份 -- [ ] 修改后立即验证效果 +- +- +- +- ### 验证确认 -- [ ] 控制台没有新的报错 -- [ ] 功能按预期工作 -- [ ] 没有影响其他功能 -- [ ] 刷新页面后仍然正常 +- +- +- +- ## 快速参考卡片 diff --git a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.1-project-showcase.md b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.1-project-showcase.md index 71b482a..af5f985 100644 --- a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.1-project-showcase.md +++ b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.1-project-showcase.md @@ -122,10 +122,10 @@ order: 2 ## 本步检查点 -- [ ] 8项功能测试全部通过 -- [ ] 理解项目包含的三个层次（HTML/CSS/JS） -- [ ] 明白自己的成果与专业应用的差异和联系 -- [ ] 已截图或备份项目文件 +- +- +- +- 恭喜你拥有了一个真正能用的作品。接下来，让我们回顾完成这个项目的完整历程。 diff --git a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.2-journey-review.md b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.2-journey-review.md index 2421961..8189881 100644 --- a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.2-journey-review.md +++ b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.2-journey-review.md @@ -149,10 +149,10 @@ order: 3 ## 本步检查点 -- [ ] 理解第二章思维→第三章技法→第四章实战的串联关系 -- [ ] 知道每轮迭代分别用到了哪些思维工具和技法 -- [ ] 明白"静态→交互→存储"的三轮迭代模式 -- [ ] 掌握可复用的 Vibe Coding 工作流 +- +- +- +- 接下来，让我们具体盘点一下你在这个过程中获得了哪些技能。 diff --git a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.3-what-learned.md b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.3-what-learned.md index 8540797..dfc6ece 100644 --- a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.3-what-learned.md +++ b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.3-what-learned.md @@ -120,10 +120,10 @@ order: 4 ## 本步检查点 -- [ ] 完成了技能自评表的填写 -- [ ] 理解自己获得的三个层次的收获 -- [ ] 看到了从 Hello World 到待办清单的成长 -- [ ] 知道接下来可以尝试做什么类型的项目 +- +- +- +- 你已经具备了独立完成简单项目的能力。接下来，让我们看看下一步可以走向哪里。 diff --git a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.4-next-steps.md b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.4-next-steps.md index 4c48dbb..0d95045 100644 --- a/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.4-next-steps.md +++ b/docs/Basic/04-practice-0-to-1/4.6-summary/4.6.4-next-steps.md @@ -154,32 +154,32 @@ order: 5 ### 思维层面 -- [ ] 理解 Vibe Coding 是什么，与传统编程的区别 -- [ ] 能用灵魂三问梳理项目方向 -- [ ] 理解 MVP 思维，知道如何定义第一版范围 -- [ ] 知道"先想失败"的逆向思维为什么重要 +- +- +- +- ### 表达层面 -- [ ] 能用 S.C.A.F.F. 框架组织 Prompt -- [ ] 知道上下文（背景、任务、约束）对 AI 输出的影响 -- [ ] 会用迭代对话逐步逼近目标 -- [ ] 遇到问题时，知道如何向 AI 提供有效的信息 +- +- +- +- ### 实践层面 -- [ ] 能让 AI 生成静态页面 -- [ ] 能让 AI 实现交互功能 -- [ ] 能让 AI 添加 localStorage 存储 -- [ ] 遇到报错时，能用 AI 诊断和修复 -- [ ] 完成过至少一个功能完整的项目 +- +- +- +- +- ### 心态层面 -- [ ] 相信自己能用 AI 做出东西 -- [ ] 对报错不再恐惧 -- [ ] 理解"先跑通再优化"的原则 -- [ ] 有动力继续学习和尝试 +- +- +- +- **如果以上大部分都能打勾**，恭喜你——你已经完成了 Vibe Coding 基础版的学习。 diff --git a/docs/Basic/05-advanced/5.1-version-control/5.1.2-ide-history.md b/docs/Basic/05-advanced/5.1-version-control/5.1.2-ide-history.md index ddc711b..dc4af4b 100644 --- a/docs/Basic/05-advanced/5.1-version-control/5.1.2-ide-history.md +++ b/docs/Basic/05-advanced/5.1-version-control/5.1.2-ide-history.md @@ -213,10 +213,10 @@ Replit 的历史功能非常完善（2025 年 5 月更新）。 ### 成功验证 -- [ ] 找到了历史功能入口 -- [ ] 能看到之前的版本列表 -- [ ] 成功恢复到了之前的版本 -- [ ] 代码确实回到了改动之前的状态 +- +- +- +- 如果以上都完成了，恭喜你——你已经学会了最基本的"存档读档"。 diff --git a/docs/Basic/05-advanced/5.1-version-control/5.1.5-practice.md b/docs/Basic/05-advanced/5.1-version-control/5.1.5-practice.md index 5bdb676..e812323 100644 --- a/docs/Basic/05-advanced/5.1-version-control/5.1.5-practice.md +++ b/docs/Basic/05-advanced/5.1-version-control/5.1.5-practice.md @@ -168,14 +168,14 @@ GitHub 在国内访问可能较慢。如果下载速度很慢，可以尝试： 完成以下所有步骤，说明你已经掌握了 GitHub Desktop 的基本操作： -- [ ] 成功安装 GitHub Desktop -- [ ] 登录了 GitHub 账号 -- [ ] 把待办清单项目变成了仓库 -- [ ] 创建了第一个 Commit -- [ ] 在 History 中看到了 Commit 记录 -- [ ] 成功测试了回退功能 -- [ ] 把代码推送到了 GitHub 云端 -- [ ] 在 github.com 上能看到自己的项目 +- +- +- +- +- +- +- +- 如果全部完成，恭喜你——你已经学会了专业开发者日常使用的版本管理工具！ diff --git a/docs/Basic/05-advanced/5.1-version-control/5.1.6-best-practices.md b/docs/Basic/05-advanced/5.1-version-control/5.1.6-best-practices.md index 02ab03c..8f87874 100644 --- a/docs/Basic/05-advanced/5.1-version-control/5.1.6-best-practices.md +++ b/docs/Basic/05-advanced/5.1-version-control/5.1.6-best-practices.md @@ -137,13 +137,13 @@ GitHub Desktop 会自动忽略这些文件，不会把它们纳入版本管理 完成本节学习后，确认你掌握了以下内容： -- [ ] 知道在哪里找到 AI IDE 的历史功能 -- [ ] 能够使用历史功能回退到之前的版本 -- [ ] 会用手动复制文件夹的方式备份项目 -- [ ] 知道什么时候应该保存一个版本 -- [ ] （可选）安装了 GitHub Desktop -- [ ] （可选）成功把项目上传到了 GitHub -- [ ] （可选）知道 Commit 信息怎么写 +- +- +- +- +- +- +- ## 恭喜你 diff --git a/docs/Basic/05-advanced/5.2-deployment/5.2.3-zeabur.md b/docs/Basic/05-advanced/5.2-deployment/5.2.3-zeabur.md index 49f69ff..f3314ef 100644 --- a/docs/Basic/05-advanced/5.2-deployment/5.2.3-zeabur.md +++ b/docs/Basic/05-advanced/5.2-deployment/5.2.3-zeabur.md @@ -29,9 +29,9 @@ Zeabur 是一个由国人团队开发的部署平台，它的免费域名在国 在开始之前，确认你已经完成： -- [ ] 第四章的待办清单项目已完成 -- [ ] 按照 5.1 的步骤，项目已上传到 GitHub -- [ ] 有一个 GitHub 账号 +- +- +- 如果还没上传到 GitHub，请先回到 [5.1 版本管理](../5.1-version-control/) 完成这一步。 @@ -139,11 +139,11 @@ Zeabur 是一个由国人团队开发的部署平台，它的免费域名在国 完成部署后，逐项验证： -- [ ] 服务状态显示绿色的"Running" -- [ ] 点击域名链接能打开页面 -- [ ] 页面显示正常，样式没有丢失 -- [ ] 可以正常添加、删除、完成任务 -- [ ] **用手机浏览器打开链接，也能正常访问** +- +- +- +- +- 最后一项尤其重要——这证明了你的网站真的可以从任何设备访问。 diff --git a/docs/Basic/05-advanced/5.2-deployment/5.2.4-vercel.md b/docs/Basic/05-advanced/5.2-deployment/5.2.4-vercel.md index 0482cf7..62f2159 100644 --- a/docs/Basic/05-advanced/5.2-deployment/5.2.4-vercel.md +++ b/docs/Basic/05-advanced/5.2-deployment/5.2.4-vercel.md @@ -33,9 +33,9 @@ Vercel 的免费域名 `*.vercel.app` 在中国大陆无法正常访问。如果 ## 准备工作 -- [ ] 项目已上传到 GitHub -- [ ] 有 GitHub 账号 -- [ ] （可选）有自己的域名 +- +- +- ## Step by Step 操作 @@ -118,10 +118,10 @@ https://your-project-name.vercel.app ## 成功验证清单 -- [ ] 部署状态显示"Ready" -- [ ] 点击链接能打开页面（海外访问） -- [ ] 页面功能正常 -- [ ] 在 Vercel Dashboard 中能看到项目 +- +- +- +- ## Vercel 的特色功能 diff --git a/docs/Basic/05-advanced/5.2-deployment/5.2.9-checklist.md b/docs/Basic/05-advanced/5.2-deployment/5.2.9-checklist.md index dcf1ff5..2f84087 100644 --- a/docs/Basic/05-advanced/5.2-deployment/5.2.9-checklist.md +++ b/docs/Basic/05-advanced/5.2-deployment/5.2.9-checklist.md @@ -11,23 +11,23 @@ order: 10 ## 知识检查 -- [ ] 理解了"部署"的含义：把代码放到服务器上，让所有人都能访问 -- [ ] 知道 Zeabur 和 Vercel 的区别，以及为什么大陆用户建议用 Zeabur -- [ ] 了解了代码更新后自动部署的工作原理 +- +- +- ## 操作检查 -- [ ] 注册了部署平台账号（Zeabur 或 Vercel） -- [ ] 成功部署了第四章的待办清单项目 -- [ ] 获得了一个可公开访问的网址 -- [ ] 在浏览器中验证了网站功能正常 -- [ ] **在手机上验证了可以正常访问**（这一条很重要） +- +- +- +- +- ## 进阶检查（可选） -- [ ] 尝试修改代码，提交更新，验证自动部署生效 -- [ ] 把网址分享给朋友或家人，让他们试用 -- [ ] 了解了部署失败时如何排查问题 +- +- +- ## 本节核心要点 diff --git a/docs/Basic/05-advanced/5.3-security/5.3.3-code-risks.md b/docs/Basic/05-advanced/5.3-security/5.3.3-code-risks.md index 614856e..5b66d3f 100644 --- a/docs/Basic/05-advanced/5.3-security/5.3.3-code-risks.md +++ b/docs/Basic/05-advanced/5.3-security/5.3.3-code-risks.md @@ -189,10 +189,10 @@ build/ 回顾你在第四章做的待办清单，检查以下几点： -- [ ] 代码中没有硬编码的密钥或密码 -- [ ] 如果有 API 调用，密钥是从环境变量读取的 -- [ ] `.env` 文件（如果有）已经加入 `.gitignore` -- [ ] 没有在 console.log 中输出敏感信息 +- +- +- +- 如果只是一个纯前端的待办清单（使用 localStorage），通常不会有这些问题。但养成检查习惯很重要，因为你以后的项目会越来越复杂。 diff --git a/docs/Basic/05-advanced/5.3-security/5.3.4-checklist.md b/docs/Basic/05-advanced/5.3-security/5.3.4-checklist.md index d13c2dd..9c4689a 100644 --- a/docs/Basic/05-advanced/5.3-security/5.3.4-checklist.md +++ b/docs/Basic/05-advanced/5.3-security/5.3.4-checklist.md @@ -16,27 +16,27 @@ order: 6 每次准备将代码上传到 GitHub 或其他平台之前，请检查： -- [ ] **没有硬编码密钥**：代码里没有任何真实的密码、API 密钥或 Token -- [ ] **.env 已被忽略**：`.env` 文件已加入 `.gitignore` -- [ ] **没有敏感日志**：`console.log` 或调试语句中没有输出敏感信息 -- [ ] **没有测试数据泄露**：测试代码中没有使用真实的用户数据或密钥 +- +- +- +- ## 部署前检查清单 在将项目部署到互联网之前，额外检查： -- [ ] **环境变量已配置**：部署平台上已正确设置所有需要的环境变量 -- [ ] **调试模式已关闭**：生产环境没有开启 debug 模式 -- [ ] **错误信息已简化**：错误页面不会暴露详细的技术信息 -- [ ] **HTTPS 已启用**：网站使用 HTTPS 而非 HTTP +- +- +- +- ## 定期检查清单 每隔一段时间（比如每月），回顾一下： -- [ ] **密钥是否需要轮换**：长期使用的密钥是否应该更换 -- [ ] **依赖是否需要更新**：项目使用的库是否有安全更新 -- [ ] **权限是否合理**：API 密钥的权限是否只包含必要的范围 +- +- +- ## 快速检查技巧 diff --git a/docs/Basic/05-advanced/5.3-security/5.3.6-always-review.md b/docs/Basic/05-advanced/5.3-security/5.3.6-always-review.md index 84afb6f..ac22599 100644 --- a/docs/Basic/05-advanced/5.3-security/5.3.6-always-review.md +++ b/docs/Basic/05-advanced/5.3-security/5.3.6-always-review.md @@ -110,17 +110,17 @@ fs.readFile("./data.json") // 正常，读取项目内的数据 代码审查不需要花很多时间。建立以下习惯： **每次 AI 生成代码后**： -- [ ] 快速扫一眼，有没有看起来像密钥的字符串 -- [ ] 如果有网络请求，确认目标地址是你知道的 -- [ ] 如果看不懂某段代码在做什么，问 AI 解释 +- +- +- **每次准备提交/部署前**： -- [ ] 运行安全检查清单（5.3.4 节） -- [ ] 确认 .env 文件没有被包含 +- +- **定期回顾**： -- [ ] 检查项目依赖是否需要更新 -- [ ] 确认没有新的安全警告 +- +- ## 记住这个原则 diff --git a/docs/Basic/05-advanced/5.4-iteration/5.4.2-feedback.md b/docs/Basic/05-advanced/5.4-iteration/5.4.2-feedback.md index eb3bf63..1dd2e18 100644 --- a/docs/Basic/05-advanced/5.4-iteration/5.4.2-feedback.md +++ b/docs/Basic/05-advanced/5.4-iteration/5.4.2-feedback.md @@ -145,11 +145,11 @@ AI 会帮你梳理出一个清晰的行动计划。 ## 本节检查清单 -- [ ] 找到了 3-5 个人试用你的待办清单 -- [ ] 观察了他们的使用过程 -- [ ] 问了三个关键问题 -- [ ] 用表格记录了收集到的反馈 -- [ ] 给反馈标注了优先级 +- +- +- +- +- ::: tip 反馈是礼物 每一条反馈，不管是批评还是建议，都是帮你改进的线索。 diff --git a/docs/Basic/05-advanced/5.4-iteration/5.4.3-new-features.md b/docs/Basic/05-advanced/5.4-iteration/5.4.3-new-features.md index 026d324..685d67d 100644 --- a/docs/Basic/05-advanced/5.4-iteration/5.4.3-new-features.md +++ b/docs/Basic/05-advanced/5.4-iteration/5.4.3-new-features.md @@ -206,11 +206,11 @@ order: 4 每次添加新功能后，用这个清单验证： -- [ ] 新功能按预期工作 -- [ ] 原有功能（添加、删除、完成任务）仍然正常 -- [ ] 刷新页面后数据没有丢失 -- [ ] 在手机浏览器上也能正常显示 -- [ ] 没有明显的报错（打开浏览器控制台检查） +- +- +- +- +- 全部通过后，记得用 GitHub Desktop 提交一次，记录这个里程碑。 diff --git a/docs/Basic/05-advanced/5.4-iteration/5.4.4-optimize.md b/docs/Basic/05-advanced/5.4-iteration/5.4.4-optimize.md index d2d4704..8e0e69a 100644 --- a/docs/Basic/05-advanced/5.4-iteration/5.4.4-optimize.md +++ b/docs/Basic/05-advanced/5.4-iteration/5.4.4-optimize.md @@ -155,11 +155,11 @@ order: 5 ## 本节检查清单 -- [ ] 核心功能稳定后再考虑优化 -- [ ] 让 AI 检查了代码重复问题 -- [ ] 让 AI 改进了变量命名 -- [ ] 给关键代码添加了中文注释 -- [ ] 对 AI 生成的代码有了基本的审查意识 +- +- +- +- +- ::: tip 代码是给人读的 写代码不只是让程序能运行。 diff --git a/docs/Basic/05-advanced/5.4-iteration/5.4.5-portfolio.md b/docs/Basic/05-advanced/5.4-iteration/5.4.5-portfolio.md index 79ea0ee..06840e9 100644 --- a/docs/Basic/05-advanced/5.4-iteration/5.4.5-portfolio.md +++ b/docs/Basic/05-advanced/5.4-iteration/5.4.5-portfolio.md @@ -171,10 +171,10 @@ README 是放在项目根目录的一个文件，用来介绍这个项目是什 ## 本节检查清单 -- [ ] 为项目写了 README 文件 -- [ ] 准备了项目截图 -- [ ] 记录了学习心得 -- [ ] 想好了下一个要做的项目 +- +- +- +- ## 本章总结 diff --git a/docs/Basic/05-advanced/5.5-boundaries/5.5.3-upgrade-signals.md b/docs/Basic/05-advanced/5.5-boundaries/5.5.3-upgrade-signals.md index beece2b..4d98e0f 100644 --- a/docs/Basic/05-advanced/5.5-boundaries/5.5.3-upgrade-signals.md +++ b/docs/Basic/05-advanced/5.5-boundaries/5.5.3-upgrade-signals.md @@ -100,22 +100,22 @@ order: 4 诚实地回答以下问题，勾选符合你情况的选项： **基础阶段**（如果大部分是这些情况，继续用基础版即可）： -- [ ] 我的项目只有 1-3 个文件 -- [ ] 我做的是个人使用的小工具 -- [ ] 大部分 bug 让 AI 帮忙就能解决 -- [ ] 我对现在的项目规模感到满意 +- +- +- +- **成长阶段**（如果开始出现这些情况，可以考虑进阶）： -- [ ] 我开始想要添加更多功能 -- [ ] 有些 bug 反复出现，AI 修不彻底 -- [ ] 我想让别人也能用我的工具 -- [ ] 我对代码"为什么能工作"产生了好奇 +- +- +- +- **进阶阶段**（如果这些情况明显，建议进入进阶版学习）： -- [ ] 我需要用户登录功能 -- [ ] 我需要数据存储在云端 -- [ ] 项目文件超过 10 个，开始感到混乱 -- [ ] AI 的回答经常不靠谱 +- +- +- +- ## 这些信号不是坏事 diff --git a/docs/Basic/05-advanced/5.5-boundaries/5.5.5-advanced-preview.md b/docs/Basic/05-advanced/5.5-boundaries/5.5.5-advanced-preview.md index 9d88890..5e83df3 100644 --- a/docs/Basic/05-advanced/5.5-boundaries/5.5.5-advanced-preview.md +++ b/docs/Basic/05-advanced/5.5-boundaries/5.5.5-advanced-preview.md @@ -136,20 +136,20 @@ order: 6 **如果以下大部分回答是"是"，你可以考虑进入进阶版：** -- [ ] 我想做的东西需要用户登录功能 -- [ ] 我希望数据能在不同设备同步 -- [ ] 我想让多个人一起使用同一个应用 -- [ ] 我对"代码是怎么工作的"产生了好奇 -- [ ] 我想参与团队开发或者开源项目 -- [ ] 我有明确的目标，需要更复杂的功能 +- +- +- +- +- +- **如果以下大部分回答是"是"，继续用基础版就够了：** -- [ ] 我做的东西主要是自己用 -- [ ] 本地存储已经能满足我的需求 -- [ ] 我对"为什么能工作"不太关心，能用就行 -- [ ] 我没有明确需要用户系统的需求 -- [ ] 我享受现在的创造过程，不想增加复杂度 +- +- +- +- +- **两种选择都是对的。** 基础版已经能让你做出很多有用的东西。进阶是一个选择，不是必须。 diff --git a/docs/Basic/05-advanced/5.6-summary/5.6.4-prepare-advanced.md b/docs/Basic/05-advanced/5.6-summary/5.6.4-prepare-advanced.md index fcc00b2..6433b9e 100644 --- a/docs/Basic/05-advanced/5.6-summary/5.6.4-prepare-advanced.md +++ b/docs/Basic/05-advanced/5.6-summary/5.6.4-prepare-advanced.md @@ -19,19 +19,19 @@ order: 5 ### 核心能力（必备项） -- [ ] 我完成了至少一个完整的 Vibe Coding 项目 -- [ ] 我能用 S.C.A.F.F. 框架写出清晰的 Prompt -- [ ] 我理解版本管理的基本概念（Commit、Push） -- [ ] 我成功部署过项目到互联网 -- [ ] 我知道三大安全禁令 +- +- +- +- +- ### 思维能力（加分项） -- [ ] 我能用灵魂三问定义一个项目的需求 -- [ ] 我能区分"必须有"和"可以有"的功能 -- [ ] 当 AI 给出错误答案时，我知道如何调整 Prompt -- [ ] 我养成了提交前检查敏感信息的习惯 -- [ ] 我清楚 Vibe Coding 的能力边界 +- +- +- +- +- ### 评分标准 diff --git a/docs/Basic/99-appendix/b-4-content.md b/docs/Basic/99-appendix/b-4-content.md index 04a90a2..938019a 100644 --- a/docs/Basic/99-appendix/b-4-content.md +++ b/docs/Basic/99-appendix/b-4-content.md @@ -78,11 +78,11 @@ title: "B.4 工具问题" | API 不工作 | 环境变量没配置 | 在部署平台配置环境变量 | **部署前检查清单**： -- [ ] 所有文件都已保存 -- [ ] 本地测试运行正常 -- [ ] 文件名没有使用中文和特殊字符 -- [ ] 路径使用相对路径（`./` 或 `../`） -- [ ] 入口文件是 `index.html` +- +- +- +- +- ## AI 反复给同样的错误答案