Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

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.

Repozytorium
devflow ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. 目录职责
  2. 改规则的正确流程
  3. hub.yaml 要点
  4. 多根工作区
  5. 漂移处理
  6. 回灌
  7. 版本升级
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 231 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.