docs: close developer onboarding implementation and verification
This commit is contained in:
Antigravity committed
1 parent
ac458ffa7f
commit
f81f4d01ae
6 files changed
+4
-4
No files matched your search
@@ -0,0 +1 @@
|
||||
{"file": ".trellis/spec/backend/quality-guidelines.md", "reason": "定向离线验证与临时目录边界"}
|
||||
@@ -0,0 +1,9 @@
|
||||
# 设计
|
||||
|
||||
- `skills/` 为可独立复制/后续建 Git 的 skill 根目录，包含 SKILL.md、按需语言/安装参考、共享模板资源。名称 dever-language，避免与 shemic-dever Go skill 混淆。
|
||||
- CLI 复用该目录的模板字节，生成器拥有文件系统发布边界；新项目使用 app + cmd API + 零输入测试，不生成 main/package/expose 或无用业务分层。
|
||||
- new 属于非项目命令，机器启动器使用活动核心；模板与发行核心版本一致。
|
||||
- skill 纳入发行签名清单并由版本库管理。安装和更新沿用现有机器权限、锁、暂存、校验和恢复机制；可发现路径必须随活动版本切换，不要求每个项目复制或手动更新技能。
|
||||
- 明确区分独立 skill 安装、机器 Dever 安装、应用依赖准备。官方发行源内置为 GitHub shemic/dever-main Releases，不读取业务配置或环境变量。Git 仓库和公开二进制资产区分，未发布资产时明确报错。
|
||||
- 安装到 AI 的稳定 skill 入口先执行绝对机器启动器的 `skill path`，再加载活动版本的完整 skill。继续保留唯一 active-version journal 提交点，避免核心和 skill 双指针更新撕裂。
|
||||
- 实施前保存涉及源码的自有备份；并行任务按文件归属分工，Cargo 验证由主代理串行执行以控制磁盘。
|
||||
@@ -0,0 +1 @@
|
||||
{"file": ".trellis/spec/backend/toolchain-and-library.md", "reason": "CLI、发行与共享机器契约"}
|
||||
@@ -0,0 +1,34 @@
|
||||
# 实施记录
|
||||
|
||||
状态：实现与定向验证完成。核心工作提交 ac458ff，独立 skill 提交 9fd78fc；本任务按用户授权向两个指定仓库发布源码。
|
||||
|
||||
1. CLI 新建项目与共享模板。
|
||||
2. 独立开发 skill、安装/更新引导和语言参考。
|
||||
3. 发行包携带 skill，机器安装与同步更新集成。
|
||||
4. 定向测试、真实模板 CLI 验证、失败保护和独立 skill 校验。
|
||||
|
||||
当前已确认：机器 update 存在，仅消费本地 downloads/latest；尚无 new 和发布 skill。当前磁盘约 213 MiB 可用，禁止并行 Cargo 或无关构建。
|
||||
|
||||
## 已完成
|
||||
|
||||
- CLI `new <new-directory> [--markdown]`、单一模板资源和两种等价源码格式；新目录原子发布，拒绝已有目录/文件/链接，覆盖并发失败保护。
|
||||
- 独立 dever-language skill，含语言/架构/接口/数据/权限/租户/库/Markdown/安装参考，项目 AI 指引，官方源安装脚本。SKILL 元数据校验通过。
|
||||
- core 主仓库和 skills 独立仓库采用用户指定 SSH remote；主仓库固定 skill submodule。官方更新地址内置 GitHub Releases，已撤销放入配置文件的早期提议。
|
||||
- 发行 maker 将完整 skill 加入签名清单；`skill path [project-root]` 按活动/固定版本只读校验；`skill install` 安装永久薄入口，不单独维护可失配的技能版本指针。
|
||||
- 官方下载先验签，限制源/重定向/大小/归档成员，校验完整包后发布；更新和安装不读取业务配置或环境变量。损坏包保留旧活动版本。
|
||||
- Python 首装助手复用已有 bootstrap，官方资源制作工具发布三个确定性资源，Linux NOREPLACE 防止覆盖并发目标。测试仅在自有目录，首装脚本的最终 bootstrap 为 mock，未触碰宿主安装/服务。
|
||||
|
||||
## 验证
|
||||
|
||||
- Rust new_project：4/4；release_source：7/7（含自有 loopback 下载/坏签名/坏内容）；shared_toolchain 定向：3/3（完整版本切换、坏skill、真实降低UID读取）。
|
||||
- native_release 两项 maker 定向：2/2（缺skill/超限拒绝，确定性完整签名）。共16项Rust定向通过。
|
||||
- Python安装/资产定向：8/8；包含独立临时密钥签名、拒绝缺skill、归档坏尾/重复/链接/unsigned、镜像配置/清理和发布竞态。
|
||||
- 独立按skill执行普通/Markdown项目14项new/check/fmt/test/run/build/独立程序命令全部成功；各1个应用测试通过，4次原生执行JSON为code=0、data=Hello, Dever。主代理再次生成Markdown项目并原生run得到相同结果。
|
||||
- rustfmt已应用；定向clippy对lib、core/launcher、新项目/共享工具链/发行测试通过 -D warnings；skill validator通过。
|
||||
- 未跑全量CI、压测、真实数据库或全局安装；未发布正式二进制资产，不能将源码push当作发行完成。官方GitHub两个仓库初始为空，core仓库已确认public。
|
||||
|
||||
## 本机保留
|
||||
|
||||
- 改前源码备份：target/onboarding-before.Vgoy97/source.tar.gz。
|
||||
- 新官方发行公钥仅公开pub，私钥留在被忽略的本机目录；已验证PKCS#8 v2符合maker并匹配skill公钥，不打印/提交私钥。
|
||||
- 为有限磁盘验证临时移走的6份旧CLI缓存已归档为 target/onboarding-before.Vgoy97/superseded-cli-cache.tar.gz（约21MiB），可恢复；本次自有临时目录已清理，未删除业务数据。
|
||||
@@ -0,0 +1,16 @@
|
||||
# Dever 开发入口
|
||||
|
||||
用户已授权实施：独立 `/data/project/dever/skills`、开发指引、新项目模板、`dever new`、安装引导以及 `dever update` 同步更新语言和 skill。
|
||||
|
||||
## 验收
|
||||
|
||||
- skill 根目录可独立分发，名称 `dever-language`，不依赖本机源码绝对路径，不混入 Go 框架规范；指导 AI 安装、编写、检查、测试和构建 Dever 应用。
|
||||
- `dever new <new-directory> [--markdown]` 生成最小可运行 CMD 项目、配置、项目 AI 指引和定向应用测试；两种源码格式共享语义，无数据库、鉴权或第三方工具前提。
|
||||
- 新项目目录不得覆盖已有内容；机器启动器创建新项目不读取尚不存在的项目配置。
|
||||
- 语言和 skill 共用版本发行、完整性校验及更新失败保护；支持一次安装后持续获取活动版本的 skill。
|
||||
- 应用配置只来自 `config/setting.json`，不用环境变量。用户已指定官方核心仓库 `git@github.com:shemic/dever-main.git` 和独立 skill 仓库 `git@github.com:shemic/dever-main-skills.git`。发行地址是工具内置元数据，禁止写入业务项目配置。
|
||||
- 定向验证模板 check/fmt/test/run/build、安装/更新后 core 与 skill 一致、损坏输入不破坏旧版本。仅使用自有临时目录/安装镜像，不安装全局服务、不替换全局命令。用户已授权两个指定仓库提交并 push；skill 是独立 Git，核心使用 submodule 固定对应提交。
|
||||
|
||||
## 现有缺口与边界
|
||||
|
||||
复用 CLI、共享机器版本库、签名发行作者、既有 bootstrap 安装和项目命令分派。当前没有 new；update 仅选择 downloads/latest 的核心，不交付 skill。普通应用配置、语言语义、Go front、其它平台发行、全量 CI 和压测不在本任务范围内。
|
||||
@@ -0,0 +1,26 @@
|
||||
{
|
||||
"id": "developer-onboarding",
|
||||
"name": "developer-onboarding",
|
||||
"title": "Dever 开发 skill、新项目模板与统一更新",
|
||||
"description": "实现独立 Dever language skill、可验证新项目模板、dever new，以及沿用共享机器安装的 core/skill 成套更新和安装指引。",
|
||||
"status": "completed",
|
||||
"dev_type": null,
|
||||
"scope": null,
|
||||
"package": null,
|
||||
"priority": "P2",
|
||||
"creator": "Antigravity",
|
||||
"assignee": "Antigravity",
|
||||
"createdAt": "2026-10-04",
|
||||
"completedAt": "2026-10-04",
|
||||
"branch": "main",
|
||||
"base_branch": "main",
|
||||
"worktree_path": null,
|
||||
"commit": null,
|
||||
"pr_url": null,
|
||||
"subtasks": [],
|
||||
"children": [],
|
||||
"parent": null,
|
||||
"relatedFiles": [],
|
||||
"notes": "",
|
||||
"meta": {}
|
||||
}
|
||||
Reference in new issue
Block a user