devflow-hub-management
/devflow-hub-management
Edytuje konfigurację centrum devflow, szablony etapów i mapowania podprojektów oraz pilnuje zgodności z regułami jednego źródła prawdy.
- Autor
- renhao-wan ↗
- Repozytorium
- devflow ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 11.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Edytuje konfigurację centrum devflow, szablony etapów i mapowania podprojektów oraz pilnuje zgodności z regułami jednego źródła prawdy.
Oryginalny opis (EN)
Use when editing devflow hub config, stage templates, subproject mappings, generated projections, or when doctor reports drift. Explains the single-source-of-truth rules.
Jak działa
- 目录职责
- 改规则的正确流程
- hub.yaml 要点
- 多根工作区
- 漂移处理
- 回灌
- 版本升级
Podgląd SKILL.md
--- name: devflow-hub-management description: Use when editing devflow hub config, stage templates, subproject mappings, generated projections, or when doctor reports drift. Explains the single-source-of-truth rules. --- # Hub 管理 ## 目录职责 | 路径 | 作用 | 是否手改 | | --- | --- | --- | | `.claude/hub/hub.yaml` | 阶段、子项目、测试命令、回灌规则 | 可以 | | `.claude/hub/stages/<stage>/SKILL.md` | 阶段规则的单一真源 | 可以 | | `.claude/hub/stages/<stage>/references/` | 阶段细则,按需读取 | 可以 | | `.claude/hub/stages/<stage>/templates/` | 产出骨架 | 可以 | | `.claude/hub/_shared/` | 所有阶段共用的规则,投影只记录路径、执行时读取正文 | 可以 | | `.claude/hub/overrides/<sub>/<stage>.md` | 子项目级覆盖 | 可以 | | `.claude/hub/stacks/<stack>/` | 技术栈规范:`_shared.md` 与 `<stage>.md` | 可以 | | `.claude/skills/devflow-<stage>/SKILL.md` | 生成的投影 | 不要 | | `.claude/.hub-manifest.json` | 生成账本(哈希) | 不要 | | `.claude/.hub-sources.json` | 阶段源文件账本,供 sync 判断手改 | 不要 | | `.devflow.json` | 插件位置、版本与回灌源码根 | 不要 | ## 改规则的正确流程 不确定一条规则该放 `_shared/`、阶段、技术栈还是子项目覆盖时,先用 `devflow-rule-placement` 判断落位,再回来执行下面的步骤。 1. 编辑 `.claude/hub/stages/<stage>/SKILL.md`,需要补充细则或产出骨架时,在阶段目录下增删 `references/`、`templates/`;语言/框架规范改 `.claude/hub/stacks/<stack>/`,并在 `hub.yaml` 用 `stack` 映射到子项目。 2. **新增/删除规则文件**或修改 `hub.yaml`(阶段、子项目、`stack` 映射)后,运行 `node scripts/devflow-gen.mjs`;只改已有 `_shared/`、`stages/`、`stacks/`、`overrides/` 文件的正文不需要 gen,投影只记录路径,执行时会直接读取。 3. 运行 `node scripts/devflow-doctor.mjs` 确认无漂移、资源未缺失、没有遗留草稿标记。 ## hub.yaml 要点 - `requiresPlugin`:语义化版本范围,插件不满足时生成器会拒绝。 - `stages`:声明哪些阶段启用;顺序即流程顺序。省略或留空时扫描 `.claude/hub/stages/`,写 `[]` 表示不启用任何阶段。 - `subprojects`:多根工作区映射;每个可声明 `path`、`stages`、`testCommand`、`stack`。 - `stack`:工作区默认技术栈;子项目未写 `stack` 时继承,没有子项目时直接用于“工作区根”。 - `defaults.testCommand`:没有子项目级命令时使用。 - `upstream.blocklist`:回灌时识别项目专属内容的关键词。 ## 多根工作区 - 只从项目根启动;子项目不单独初始化 hub。 - 共享规则放在根 hub;子项目差异放进 `overrides/`;同一技术栈的规范放进 `stacks/<stack>/`,并在 `hub.yaml` 用 `stack` 建立映射。 - 测试命令按子项目声明,避免在根目录跑错命令。 ## 漂移处理 `/devflow:doctor` 报告「投影被手改或过期」时: - 如果改动是有意的 → 改源文件,而不是改投影。 - 如果改动是误操作 → 重新生成覆盖。 不要直接编辑 `.claude/skills/devflow-*`。 ## 回灌 `/devflow:upstream --stage <stage>` 默认只预览;技术栈用 `--stack <stack>`,`--all` 包含所有阶段与技术栈。`--apply` 才会写入目标库,回灌只写模板与回灌日志,不改版本文件。阶段目录下的 `references/`、`templates/` 会递归处理并保留相对路径。项目专属内容(绝对路径、内网地址、子项目名、blocklist 命中)不会回灌。 回灌目标由 `--to` 选择:`personal` 个人库(默认 `~/.claude/devflow`)、`team` 团队库(`hub.yaml` 配置的本机 clone,默认只写工作区,`--pr` 才提交推送)、`upstream` 插件源码仓库(默认目标)。上游库路径由 `--plugin-root` > `.devflow.json` 的 `pluginSourceRoot` > 运行时插件根决定。从 marketplace 安装时运行时根在缓存里,写入会被拒绝;用 `--plugin-root` 或先运行 `/devflow:init --source-root <插件源码仓库>` 记录一次。 ## 版本升级 `hub.yaml` 的 `requiresPlugin` 决定兼容范围。升级插件后先运行 `/devflow:sync --dry-run` 查看模板差异,再运行 doctor;`sync` 只更新未手改的阶段文件,手改文件默认保留。不满足版本范围时要么升级 hub 配置,要么回退插件版本。
Wersje
W bazie nie ma innych skilli o nazwie devflow-hub-management.
Migawka bazy z 13.11.2026 · wersja paczki 77fcb4b160d8 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100devflow
Prowadzi pracę w projekcie DevFlow z katalogiem .devflow/ i krokowymi przepływami z bramkami. - 100devflow-engineering-flow
Wskazuje, który etap uruchomić w projekcie devflow, i wyjaśnia sześcioetapowy przepływ z jego bramkami. - 86devflow-update
Aktualizuje system agentów DevFlow do najnowszej wersji z repozytorium źródłowego i instaluje go ponownie. - 90maui-devflow-session-review
Przegląda zapisane sesje MAUI DevFlow, klasyfikuje problemy narzędzi i błędy aplikacji oraz przygotowuje raporty i szkice zgłoszeń. - 90devflow-rule-placement
Wskazuje, gdzie w przestrzeni roboczej devflow zapisać regułę projektu: we wspólnym pliku, w etapach, w zestawach technologii czy w nadpisaniach. - 100maui-devflow-onboard
Dodaje DevFlow do aplikacji MAUI: odwołania do pakietów, rejestracja w MauiProgram, warianty Blazor WebView i GTK oraz weryfikacja po uruchomieniu maui devflow init.