SuperAPI AI 工具集

starter

前端与建站

查看项目

更新于 10-16 01:58

技能介绍

Starter(初学者)技能是 bkit-claude-code 中面向编程入门者的静态网站开发技能,主要覆盖 HTML/CSS/JS 与 Next.js App Router 两类技术栈。

用途 该技能面向第一次学习编程的人、想创建简单网站的人,以及需要作品集站点的人。它帮助初学者在 AI 辅助下完成静态网站的开发流程,并给出适合入门难度的引导。

主要能力 技能提供三个动作:

  • init:项目初始化(/init-starter 功能),示例命令为 /starter init my-portfolio。它会创建项目目录结构(HTML/CSS/JS 或 Next.js)、在选用 Next.js 时生成 package.json、创建 CLAUDE.md(指定 Level: Starter)、创建 docs/ 文件夹结构(用于 PDCA 文档),并初始化 pipeline 存储——通过 lib/pdca/status.js 中的 writeBkitMemory() 写入 .bkit/state/memory.json(即 .bkit-memory.json 迁移后的路径)。该文件保存项目级别和 9 阶段 pipelineStatus,供 pipeline Stop 钩子在阶段 5、6、9 读取;PDCA 阶段本身并不存放在这里,而是存放在 .bkit/state/pdca-status.json。
  • guide:显示开发指南,分析当前项目状态,建议适合 Starter 级别的下一步操作,并提供聚焦阶段 1-3 的 Pipeline 指南。
  • help:初学者帮助,解释 HTML/CSS/JS 基础概念,回答常见问题,提供示例代码。

技术栈 选项 A:纯 HTML/CSS/JS(面向完全初学者)——HTML5 负责网页结构,CSS3 负责样式,JavaScript 负责动态功能(可选)。 选项 B:Next.js(使用框架)——Next.js 14+ 为基于 React 的框架,Tailwind CSS 为工具类 CSS,TypeScript 提供类型安全(可选)。

语言层级指引(v1.3.0) 推荐仅使用 Tier 1 语言(Python、TypeScript、JavaScript)。Starter 级别聚焦 AI 原生开发,以获得最大的 AI 工具支持。Tier 1 允许使用,理由是完整 AI 支持、针对 Vibe Coding 优化;Tier 2 有限使用,建议考虑 Dynamic 级别;Tier 3-4 不允许,需升级到 Dynamic/Enterprise。

项目结构 选项 A(HTML/CSS/JS):包含 index.html(主页面)、about.html(关于页面)、css/style.css(样式)、js/main.js(JavaScript)、images/(图片文件)、docs/(PDCA 文档,含 01-plan/ 与 02-design/)以及 README.md。 选项 B(Next.js):包含 src/app/layout.tsx(公共布局)、src/app/page.tsx(主页面)、src/app/about/page.tsx(关于页面)、src/components/(可复用组件)、public/(静态文件)、docs/(PDCA 文档)、package.json、tailwind.config.js 与 README.md。

核心概念说明 资料给出了 HTML 基本结构、CSS 基础样式与响应式写法、Next.js App Router 页面创建方式,以及 Tailwind CSS 常用类(如 container、mx-auto、p-4、text-center、text-xl、font-bold、bg-blue-500、text-white、rounded-lg、hover:bg-blue-600)的示例代码。

部署方式

  • GitHub Pages(免费):创建 GitHub 仓库、推送代码、在 Settings → Pages → Source 选择 main 分支,然后通过 https://username.github.io/repo-name 访问。
  • Vercel(Next.js 推荐):在 vercel.com 注册(集成 GitHub)、新建项目并选择仓库、点击 Deploy,URL 自动生成。

限制 该级别不支持登录/注册(需要服务器)、数据存储(需要数据库)、管理页面(需要后端)、支付功能(需要后端)。当需要登录功能、存储数据、管理页面或用户间通信时,应升级到 Dynamic 级别。

Starter 级别的 bkit 特性(v1.5.1)

  • 输出样式:推荐 bkit-learning,可通过 /output-style bkit-learning 激活,提供任务后的学习要点说明、鼓励动手实践的 TODO(learner) 标记,以及按初学者难度调整的概念解释。
  • 智能体记忆(自动激活):bkit 智能体自动跨会话记住学习进度,无需设置;starter-guide 智能体使用用户范围记忆,学习上下文可跨不同项目保留。
  • 智能体团队:Starter 级别项目不可用;升级到 Dynamic 级别后可解锁 2 名队友并行 PDCA 模式。

常见错误与解决 图片不显示:检查路径(./images/photo.jpg);CSS 未生效:检查 link 标签路径;页面导航不工作:检查 href 路径(./about.html);移动端显示异常:检查 <meta name="viewport"> 标签。