Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

devflow-rule-placement

/devflow-rule-placement

Wskazuje, gdzie w przestrzeni roboczej devflow zapisać regułę projektu: we wspólnym pliku, w etapach, w zestawach technologii czy w nadpisaniach.

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
1
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 sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Wskazuje, gdzie w przestrzeni roboczej devflow zapisać regułę projektu: we wspólnym pliku, w etapach, w zestawach technologii czy w nadpisaniach.

Oryginalny opis (EN)

Use when a project rule, convention, or constraint needs to be written into a devflow workspace and it is unclear whether it belongs in _shared, stages, stacks, or overrides.

Jak działa

  1. 何时使用
  2. 落位决策
  3. 流程
  4. 写法
  5. 去重与冲突
  6. 边界
  7. 输出
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 175 słów
Podgląd SKILL.md
---
name: devflow-rule-placement
description: Use when a project rule, convention, or constraint needs to be written into a devflow workspace and it is unclear whether it belongs in _shared, stages, stacks, or overrides.
---

# 规则落位

## 何时使用

- 用户说“以后都……”“这个项目约定……”“别用……”“我们团队要求……”。
- 规则只存在于对话、issue 或任务文档中,还没有进入 `.claude/hub/`。
- 已有规则需要修改,但不确定应改哪个文件。
- 多个目录都有相似内容,需要判断哪一处才是真源。

不要把所有规则都塞进 `_shared/`:范围越窄的规则,越应该放到阶段、技术栈或子项目层。

## 落位决策

| 规则影响范围 | 落位 |
| --- | --- |
| 所有阶段、所有子项目 | `.claude/hub/_shared/<topic>.md` |
| 只影响某个阶段 | `.claude/hub/stages/<stage>/SKILL.md`;细则放该阶段 `references/` |
| 只影响某语言/框架 | `.claude/hub/stacks/<stack>/_shared.md` 或 `<stage>.md` |
| 只影响某个子项目 | `.claude/hub/overrides/<sub>/<stage>.md` |
| 只影响当前任务 | 留在 `docs/devflow/<slug>/`,不落位 |

规则同时命中多个范围时,先判断“最小充分范围”:只对某个子项目成立,就不要写进 `_shared/`;只对某个阶段成立,就不要写进 `_shared/`。

## 流程

1. 用一句话复述规则,确认适用范围。无法判断时用 `AskUserQuestion` 给出“全局 / 某阶段 / 某技术栈 / 某子项目 / 仅当前任务”五类选项。
2. 用 `Grep` 搜索 `.claude/hub/` 中是否已有同主题规则。已有就改那一处,不新增重复文件。
3. 读取目标文件;不存在时按最小骨架创建。目标必须位于 `.claude/hub/` 内,父目录不能被 junction/符号链接引到项目外。
4. 写入可执行规则:**条件 + 动作 + 例外**。例如“新增 HTTP 接口必须同时补集成测试,除非该接口只做静态转发。”
5. 判断是否需要重新生成:
   - 新增/删除规则文件、修改 `hub.yaml`(阶段、子项目、`stack` 映射)→ 运行 `node scripts/devflow-gen.mjs`。
   - 只修改已有 `_shared/`、`stages/`、`stacks/`、`overrides/` 文件的正文 → 不需要 gen,投影只记录路径,正文会被执行时直接读取。
6. 如果目标文件首行是 `<!-- devflow:draft -->`,说明它还是草稿:提醒用户填写完删除该标记;规则草稿不会被投影、同步或回灌。阶段入口 `stages/<stage>/SKILL.md` 不能标记为草稿。
7. 运行 `node scripts/devflow-doctor.mjs`,确认无越界、无缺失、无过期投影。

## 写法

- 一条规则只写一个可判定条件,不要把多条无关约束塞进一段。
- 写项目真实的约定,不写“注意代码质量”“保持良好风格”这类无法执行的口号。
- 有例外就写出来;没有例外不要补“视情况而定”。
- 引用外部文档时写路径或链接,不整段复制。
- 安全与门禁规则只能收紧,不能放宽。

## 去重与冲突

- 同一规则只保留一处真源;发现重复时合并到范围最小的位置,并删除其他副本。
- 读取优先级:阶段门禁与安全底线 > `overrides` > `stacks/<stack>/<stage>.md` > `stacks/<stack>/_shared.md` > `_shared` > 阶段默认做法。
- `overrides` 与 `stacks` 冲突时以 `overrides` 为准;任何一层都不得放宽阶段门禁与安全底线。

## 边界

- 不直接修改 `.claude/skills/devflow-*`;那是生成投影,改源文件后重新生成。
- 不把规则写到用户 home、插件缓存或项目外目录。
- 不把项目专属内容(绝对路径、内网地址、子项目名、密钥)回灌到个人库/团队库。
- 不创建空的 `overrides/` 目录;没有真实子项目差异就不建。
- 不确定是否可复用时,先留在任务文档,确认后再落位。

## 输出

告知用户:落位文件、为什么选这一层、是否需要运行 gen、是否还有草稿标记未删除。

Wersje

W bazie nie ma innych skilli o nazwie devflow-rule-placement.

Migawka bazy z 13.11.2026 · wersja paczki 4282552fc201 (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.
  • 86devflow-update
    Aktualizuje system agentów DevFlow do najnowszej wersji z repozytorium źródłowego i instaluje go ponownie.
  • 100devflow-engineering-flow
    Wskazuje, który etap uruchomić w projekcie devflow, i wyjaśnia sześcioetapowy przepływ z jego bramkami.
  • 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-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.
  • 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.