DeepAI · 你的第一个项目 › 用脚手架开正式项目

用脚手架开正式项目

从模板建私有仓库、拉取、开干

前面那个小项目是用来找感觉的。等你要做一个正式、要长期维护、能复用的项目时,别再从一个空文件夹开始—— 用团队准备好的「项目脚手架」起步。

脚手架是一份标准项目骨架:自带 spec 工作流、一套方法论文档、 以及可以在 Claude Code 里直接调用的命令(/vibe:kickoff/spec-init:specify 等)。 复制它就是你新项目的起点,不用每次从零搭。

它放在哪脚手架在内部 Git(Forgejo)上:http://47.111.18.242:8081/IASO/deepAI-scaffold。 它是一个「模板仓库」——你不用手动复制,点几下就能生成一份属于你自己的私有副本。 没有内部 Git 账号的,找负责人开通。

先搞清楚:组织模板 → 你的私有仓库 → 本地

第一次用脚手架前,先花一分钟看懂下面这三者的关系,后面操作就不会乱。

先打个比方组织那份模板像一间「样板间」——大家照着它的格局装修,但谁都不住进样板间本身。 你照着样板间装出自己的家(你的私有仓库),平时就住在自己家里 (你电脑上的本地副本)改东西、添家具。
仓库关系 · 样板间 → 你的家 → 你干活的地方
组织模板仓库IASO / deepAI-scaffold样板间 · 大家共用,不直接改你的个人私有仓库san.zhang / my-ai-project家 · 只有你自己能看你的电脑(本地)~/my-ai-project写代码、跑 Claude Code 的地方1点「使用此模板」复制成你自己的 · 只做一次2日常来回git clone / pull · 拉下来git push · 传回去日常就在私有仓库和本地之间来回:改完 push 回去,别人看不到你的代码
  • 组织模板仓库:大家共用的「原版」,你不直接改它,只借它的目录结构开新项目。
  • 你的私有仓库:点「使用此模板」一键复制出来的你自己的副本,放在服务器上, 提交和版本历史都存在这里,别人看不到。
  • 本地git clone / pull 拉到电脑上写代码、跑 Claude Code, 改完 git push 传回你的私有仓库——日常就在这两头来回。
可见性组织模板仓库是私有的,你能基于它生成副本;你生成的那一份也是私有的,只有你自己能看,别人看不到你的代码。

脚手架里都有什么:一张图看懂

第一次打开脚手架,会看到一堆文件夹,别慌——你真正要碰的只有很少几个。 按「你放进去 → AI 拿着这些干活 → 你拿出来」三步看,就全明白了。

脚手架一张图 · 你放进去 → AI 处理 → 你拿出来
1 · 你放进去只有这三样需要你动手准备
reference/
你的原始资料——PDF、Excel、文档都往这丢,再在 INDEX.md 里记一行「这是什么」。
.spec-initialization/
你的需求写在这:project.md 说清项目是干嘛的,每个改动在 changes/ 里写成 proposal / design / tasks 三张纸。
~/.config/deepai/*.env
API key 放这——注意它在仓库外面(你电脑的配置目录),永远不会被传到 Git 上。
2 · AI 拿着这些干活这些是 AI 的装备,看看就行,不用改
.claude/
AI 的工具箱:10 个命令(/vibe:kickoff 那些)+ 9 个按场景自动触发的 skills。
docs/
方法论 + 入门教材(methodology/curriculum/),AI 按这套规矩干活。
orchestrator/ontology/
受控词表——统一叫法,AI 和你说的「同一个词」才是同一个意思。
sandboxes/ · scripts/ · tests/
试验场(先试再上正式代码)、selfcheck.sh 自检、评测用例。
soul/ · memory/ · prompts/
AI 自己用的——它的记忆和人格,自动加载、自动沉淀,你不用打开也不用整理。
3 · 你拿出来干完活,这三样就是成果
项目代码本身
这个仓库就是你的产品——AI 写的代码、页面、脚本都长在这里。
.spec-initialization/archive/
每个做完的改动归档在这,哪天问「这功能当初为什么这么做」都能查到。
docs/know-how/
踩过的坑、总结的经验沉淀在这,下个项目、下个人直接受益。
配套的命令节奏(后面两步会实际用到)
/vibe:kickoff起项目,只跑一次每个改动循环:/spec-init:specify/spec-init:apply/vibe:review/spec-init:archive
另外两个贯穿始终:/sync 把最新的拉下来,/save 把干完的存回去——开工先拉、收工必存。
一句话总结你只管三件事:资料丢进 reference/、需求写成 spec、API key 配好。 其余文件夹都是 AI 的装备和产出,跟着命令节奏走就行。

第一步:用模板创建你自己的私有仓库

先用你的内部 Git 账号登录,打开上面的脚手架仓库。

你的内部 Git 账号
  • 用户名 = 名字拼音 . 姓氏拼音(名在前、姓在后,中间一个点)。 比如叫「张三」,用户名就是 san.zhang
  • 初始密码:123456@xl
  • 首次登录会要求你修改密码,改成你自己的,之后用新密码登录。

登录后,从 DeepAI 页面开始按下面六步走:

从 DeepAI 进入内部 Git

在 DeepAI 页面右上角点击 「内部 Git ↗」,进入团队的 Forgejo:

在 DeepAI 页面右上角点击「内部 Git ↗」
在 DeepAI 页面右上角点击「内部 Git ↗」

在仓库列表找到组织模板

进入 Forgejo 后,在首页右侧找到 「仓库列表」,切到「所有」,再点击 IASO/deepAI-scaffold

在仓库列表的「所有」页签中打开 IASO/deepAI-scaffold
在仓库列表的「所有」页签中打开 IASO/deepAI-scaffold

打开模板仓库,点「使用此模板」

登录后进入 IASO/deepAI-scaffold,它标着「私有 / 模板」。 在文件列表上方的工具栏里(和 main 分支选择、「查找文件」「添加文件」同一排), 点橙色的 「使用此模板」 按钮:

模板仓库页面,在文件列表上方工具栏点橙色「使用此模板」按钮
模板仓库页面,在文件列表上方工具栏点橙色「使用此模板」按钮

填表:选你自己、设为私有、勾上 Git 数据

  • 拥有者:选你自己的账号。
  • 仓库名称:起个好认的名字,比如 my-ai-project
  • 勾上「将仓库设为私有」。
  • 模板选项里勾上「Git 数据(默认分支)」——不勾这个,脚手架文件不会被复制过来

填完点 「创建仓库」

创建仓库表单:拥有者、仓库名、勾「设为私有」、勾「Git 数据(默认分支)」
创建仓库表单:拥有者、仓库名、勾「设为私有」、勾「Git 数据(默认分支)」

创建成功,文件都复制过来了

进入你的新仓库,它标着「私有」「生成自 IASO/deepAI-scaffold」, 脚手架的所有文件(.claude / docs / CLAUDE.md /QUICKSTART.md …)都已经在里面了:

你的私有仓库已创建,脚手架文件全部就位
你的私有仓库已创建,脚手架文件全部就位

复制克隆地址

在仓库首页点 HTTP,复制那串 .git 地址,下一步要用:

仓库首页的克隆地址(HTTP)
仓库首页的克隆地址(HTTP)

第二步:拉取到本地、开干

把你刚建的那个私有仓库拉到电脑上,下面两种方式任选其一

方式一:直接跟 AI 说。用 VS Code 打开你平时放代码的文件夹, 点击左侧边栏的 Claude Code 图标打开插件面板,把上一步复制的克隆地址贴给它, 一句话交代清楚就行,例如:

帮我把 http://47.111.18.242:8081/<你的用户名>/<你的仓库名>.git 克隆到当前目录

方式二:自己在终端敲命令。在 VS Code 终端里(Windows 用 Git Bash)分两步。 第一条把远端仓库完整下载到本地,会在当前目录生成一个和仓库同名的文件夹 (私有仓库首次克隆会要求输入内部 Git 的用户名和密码):

git clone http://47.111.18.242:8081/<你的用户名>/<你的仓库名>.git

第二条进入刚下载的文件夹——之后所有命令都要在仓库目录里跑:

cd <你的仓库名>

然后用 VS Code 打开这个文件夹,点击左侧边栏的 Claude Code 图标,打开插件面板就能直接用——不用再单独配 API Key。前面「CC Switch 配置」那步选好的 DeepSeek 渠道会直接生效, 这时候你用的就是 Claude Code + DeepSeek。 可以先跑一条命令让它带你起项目(非必要:它只是新手引导, 帮你把 project.md 填好、定领域、建第一个 change;已经清楚要做什么的可以跳过,直接进入下面的 spec 工作流):

/vibe:kickoff # 非必要,新手引导:填 project.md、定领域、建第一个 change

之后按 spec 工作流推进:

/spec-init:specify # 写 proposal / design / tasks /spec-init:apply # 执行改动 + 跑测试 /spec-init:archive # 完成后归档
提示没出现 AI 能用的情况,多半是 CC Switch 没切到 DeepSeek 渠道,或者没重启 VS Code—— 回「CC Switch 配置」检查一遍即可。 命令里的 <你的用户名><你的仓库名> 换成你自己的; 更细的命令顺序见仓库里的 QUICKSTART.md