feat: sync and reference Very Good Engineering content
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
调研方向
First confirm that Very Good Engineering has published versioned, downloadable FFCA bundles. Then inspect hooks/hooks.json, scripts/sync_reference.dart, the skills, ffca-layer-auditor, and validate_layers.dart. Done means the hook syncs minor updates, holds major ones, fails open, and consumers fall back to references/ffca_architecture.md.
由索引模型根据 Issue 内容生成。
描述
What
Pull the latest published FFCA standard from Very Good Engineering at session start, and have skills and the auditor read that cache instead of the bundled copy in references/ffca_architecture.md.
Why
references/ffca_architecture.md is a hand-maintained mirror of the FFCA page, and scripts/sync_reference.dart is still a stub. Every change to the standard needs a manual edit plus a plugin release, and plugins are not updated reliably on local machines. The mirror drifts as soon as the source changes. Same approach as VeryGoodOpenSource/vgv-ai-flutter-plugin#158.
How
- A
SessionStarthook runs a sync script before any work begins. - The script compares the locally cached VGE version against the published one.
- Minor difference: download and overwrite the cache.
- Major difference: keep the cached copy and wait for a plugin release, since renamed or new sections may need skills rewired. Skills cite sections by name, such as Dependency Graph Rules and Naming Conventions (Enforced).
- The cache lives outside the plugin directory so it survives reinstalls.
- The bundled
references/ffca_architecture.mdstays as the fallback when no cache exists.
Sync must fail open. A network failure, a slow response, or an offline machine cannot block the session or the hook's time budget.
Sections
FFCA architecture. Layered Architecture too, since the skills defer to it for non-FFCA repos.
Tasks
- Add the sync script and wire it to
SessionStartinhooks/hooks.json - Pin the VGE version this plugin was built against
- Hold on a major difference, sync on a minor one
- Fail open on any network or parse error
- Point skills and
ffca-layer-auditorat the cache, falling back to the bundled reference - Replace or remove the
scripts/sync_reference.dartstub - Check whether
validate_layers.dartrules need to follow the synced standard
Blocked
Waiting on Very Good Engineering to publish FFCA and to ship versioned, downloadable bundles. Nothing here is implementable until that lands.
- 主要语言
- Dart
- 星标
- 7
- 派生
- 2
- 平均合并
- 2 天 8 小时
- 30 天内合并 PR
- 9
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
VeryGoodOpenSource/vgv-ffca-plugin 的其他 Issue
-
feature
难度 4/5 3-5 天 新手友好度 54/100
VeryGoodOpenSource/vgv-ffca-plugin#39 ·
维护者通常 1 天内回复
-
feature
难度 4/5 3-5 天 新手友好度 22/100
VeryGoodOpenSource/vgv-ffca-plugin#28 ·
维护者通常 1 天内回复
-
feature
难度 4/5 3-5 天 新手友好度 38/100
VeryGoodOpenSource/vgv-ffca-plugin#26 ·
维护者通常 1 天内回复
-
test
难度 3/5 1-2 天 新手友好度 48/100
VeryGoodOpenSource/vgv-ffca-plugin#23 ·
维护者通常 1 天内回复
查看 VeryGoodOpenSource/vgv-ffca-plugin 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
Vinillian/book_tracker#208 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 64/100
-
难度 1/5 1-3 小时 新手友好度 76/100
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
fdittgen-png/deskilo#3753 ·
维护者通常 1 天内回复
-
enhancement good first issue help wanted
难度 2/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复