Skip to content

relocate skill files, add desktop docs and CI/CD builds - #1

Merged
FlashingChen merged 8 commits into
mainfrom
agent/relocate-skill-files
Aug 5, 2026
Merged

FlashingChen merged 8 commits into
mainfrom
agent/relocate-skill-files

Conversation

@FlashingChen

@FlashingChen FlashingChen commented Aug 5, 2026

Copy link
Copy Markdown
Owner

背景

完成 agent/relocate-skill-files 分支的收尾:skill 目录迁移到 skill/ 后同步文档,补充桌面端项目文档,并接入三端自动构建。

变更

  • relocate: SKILL.md、references、scripts、assets 迁入权威目录 skill/;README 路径修正为迁移后布局
  • docs: 新增 AGENTS.md(项目规则)、PRD.mdPLAN.mdBLOCKED.md(桌面端开发沉淀);README 补充桌面端说明;删除已被桌面端取代的 one-click-installer 计划/设计文档(仓库内已无引用)
  • ci: 新增 .github/workflows/build.yml —— test+lint 通过后并行构建 macOS(dmg+zip, x64+arm64)、Windows(NSIS x64)、Linux(AppImage x64),产物上传 artifacts;v* tag 发布 GitHub Release
  • build: app/package.json 增加 Linux 打包配置(图标/AppImage/分类);app/README.md 补充 CI 说明

验证

  • 本地 npm test 26 项通过,npm run lint 通过
  • workflow YAML 语法校验通过
  • 三端构建由本 PR 的 CI 运行实际验证(见 checks)

说明

  • CI 产物 unsigned(无签名证书)
  • 审计遗留的 AGENT-REALITY-AUDIT.md/AUDIT-*.md 引用已不存在的 apps/desktop/ 路径,属于过期会话残留,未提交

The one-click-installer plan/design (2026-07-26) was superseded by the
desktop app work; the docs are unreferenced anywhere in the repo.
README paths now match the relocated skill/ layout and document the
Electron desktop app.
Add a workflow that runs tests/lint then packages macOS (dmg+zip,
x64+arm64), Windows (NSIS x64) and Linux (AppImage x64) in parallel.
Artifacts are uploaded on every run; v* tags publish a GitHub Release.
Adds linux icon/target config to electron-builder and records the CI
contract in AGENTS.md. Also adds the desktop PRD, execution plan and
blocker log from the app development work.
@FlashingChen FlashingChen changed the title relocate skill files under skill directory relocate skill files, add desktop docs and CI/CD builds Aug 5, 2026
softprops/action-gh-release needs contents: write, which default
read-only GITHUB_TOKEN denies. actions/cache does not expand
%LOCALAPPDATA% in paths; use the tilde form of the same directory.
@FlashingChen

Copy link
Copy Markdown
Owner Author

自审记录(2026-08-05)

  • 本地验证:app 测试 26/26 通过,lint 通过;electron-builder 26 CLI 标志(--mac/--win/--linux 目标列表、--x64/--arm64)与工作流一致。
  • 独立 reviewer 复核 workflow,发现并已修复 3 处(commit c823d46):
    1. release job 缺少 permissions: contents: write(默认只读 token 会导致 tag 发布 403)
    2. actions/cache 不展开 %LOCALAPPDATA%(Windows 缓存路径改为 ~\AppData\Local\electron-builder\Cache
    3. app/README.md "every push" 措辞与实际触发(main + tags + PR)不符
  • CI 实测两轮全绿:Test & lint、Package mac/win/linux 均 success;产物已上传(mac 561MB dmg+zip x64+arm64 / win 114MB NSIS / linux 146MB AppImage);无 tag 时 release job 正确跳过。
  • 未提交的 AGENT-REALITY-AUDIT.md/AUDIT-*.md 为引用已删除 apps/desktop/ 路径的过期会话残留,刻意排除。

@FlashingChen
FlashingChen marked this pull request as ready for review August 5, 2026 09:11
@FlashingChen
FlashingChen merged commit 07e65f5 into main Aug 5, 2026
5 checks passed
@FlashingChen
FlashingChen deleted the agent/relocate-skill-files branch August 5, 2026 09:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant