Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

agent-workflow-generator

/agent-workflow-generator

Tworzy dla projektu zestaw współpracy agentów: specyfikację, zasady kodowania, niezależne recenzje, katalog zadań i samokontrolę oraz sprawdza ścieżki czytania symulowanym zadaniem.

Licencja
MIT
Ostatnia zmiana repozytorium
06.11.2026

Ocena i bezpieczeństwo

85/ 100Klasa: dobry
Format20 / 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
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.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

Tworzy dla projektu zestaw współpracy agentów: specyfikację, zasady kodowania, niezależne recenzje, katalog zadań i samokontrolę oraz sprawdza ścieżki czytania symulowanym zadaniem.

Wyzwalacze z opisu

为项目建立 agent 协作规范 / 审查流程 / AGENTS.md 工作流
Oryginalny opis (EN)

为目标项目生成一套 agent 协作工作流:多级索引结构的规范入口与编码规范、按档位分派的独立审查 skill、任务记录目录和自检脚本,并在交付前用模拟任务检查阅读路径。用户要求“为项目建立 agent 协作规范 / 审查流程 / AGENTS.md 工作流”,或要把现有协作模式迁移到新项目时使用。不用于直接审查代码或实现业务功能。

Jak działa

  1. 执行步骤
  2. 生成后的使用约定
Sekcje z nagłówków SKILL.md, w oryginale · 90 linii, 186 słów
Podgląd SKILL.md
---
name: agent-workflow-generator
description: 为目标项目生成一套 agent 协作工作流:多级索引结构的规范入口与编码规范、按档位分派的独立审查 skill、任务记录目录和自检脚本,并在交付前用模拟任务检查阅读路径。用户要求“为项目建立 agent 协作规范 / 审查流程 / AGENTS.md 工作流”,或要把现有协作模式迁移到新项目时使用。不用于直接审查代码或实现业务功能。
---

# Agent 协作工作流生成器

本 skill 读取目标项目,与用户确认关键选择后,生成该项目自己的协作规范。交付的规范是多级索引结构,结构要求见 [index-structure.md](index-structure.md);目的是让后续模型按任务只读必要内容,不浪费上下文。生成结果是普通 Markdown 和脚本,不依赖特定 agent 工具。

生成器只负责建立规范,不修改目标项目的业务代码,不提交、不推送。写入任何文件前,必须先向用户展示文件清单并获得确认。

## 执行步骤

按顺序执行。每一步的产出都在对话中展示给用户;需要用户决定的事项集中提问,不逐条打断。

### 1. 扫描项目

只读取足以判断以下事项的文件,不通读全仓库:

- **语言与模块**:按源码文件数量和构建文件(如 `go.mod`、`pyproject.toml`、`package.json`、`Cargo.toml`、`pom.xml`)判断主语言及其所在目录。一个仓库可以有多种语言,各自记录目录范围。
- **构建、测试与 lint 命令**:优先取 CI 配置、`Makefile`、脚本目录中实际使用的命令;查不到时标为“待确认”,不自行编造。
- **已有协作文件**:`AGENTS.md`、`CLAUDE.md`、`.cursor/rules`、`CONTRIBUTING.md`、已有 skill 目录。
- **业务契约文档**:如 `docs/`、API 文档、架构文档、实现契约。
- **项目性质**:是否在做语言迁移或系统重写,例如同时存在旧实现与新实现,或有迁移规划文档。

输出一份扫描摘要:语言及目录、命令、已有协作文件、契约文档、是否迁移项目。无法确认的项单独列出。

### 2. 与用户确认项目条件

一次性询问以下事项,扫描已能确定的给出默认值,由用户确认或修改:

1. **档位**:轻量、标准或严格,定义见 [tiers.md](tiers.md)。
2. **高风险区域**:改动后需逐条核对不变量(轻量档还需升档)的模块或主题,例如计费、权限、多租户隔离、数据迁移、付费外部调用。只记录用户确认的内容,生成器不替项目编造业务风险。
3. **领域审查要点**:项目特有、通用审查规则覆盖不到的检查点,例如某类请求的幂等要求、某个状态的确认条件。已有协作文件中的项目专属审查条目逐条提取为候选,供用户确认;没有时可以为空。
4. **审查职能**:按档位给出默认组合,用户可增减。迁移项目默认启用行为验证职能。
5. **推进门禁**:拆分任务时,每个小任务、每批任务还是整体完成后交用户 review。
6. **已有协作文件的处理**:保留并在新入口中引用、合并进新入口,或由新规范替换。默认保留,不覆盖。选择替换时,搜索仓库中指向被替换文件或沿用其流程名称的文档(如规划、基线说明),列入生成清单,由用户决定是否同步修改。

### 3. 确定代码风格

对每种主语言按 [style-sourcing.md](style-sourcing.md) 确定风格规范来源,产出风格规则草案,由用户确认后再进入生成。

### 4. 写渲染配置并展示生成清单

把第 1–3 步确认的结果写成渲染配置(JSON,字段见 [templates/README.md](templates/README.md) 的“渲染配置”一节),放在目标项目之外的临时位置;各语言的风格规则草案存为单独的 Markdown 文件,由配置引用。

运行 `python3 scripts/render.py 配置.json 目标目录 --plan`,把输出的清单(处理方式、层级、路径)展示给用户。清单中标为“冲突”的已有文件,按第 2 步对已有协作文件的决定写入配置的 `replace` 或 `skip`;需要把新内容合并进已有文件时,选 `skip`,生成后用 `--print 路径` 取出新内容手工合并。用户确认清单后才写入。

### 5. 生成文件

运行 `python3 scripts/render.py 配置.json 目标目录`。脚本处理条件块和占位符,按每个文件的位置换算链接,复制 `snapshot.sh` 与 `check_docs.py`,建立层级映射,保存配置副本 `.agents/scripts/workflow-config.json`(供模板更新后重新生成),最后运行 `check_docs.py` 并输出结果。配置有误、引用的文件不存在或有未声明的冲突时,脚本不写入任何文件。

生成结果满足 [index-structure.md](index-structure.md) 的层级、链接分类、读取规则和格式约定。此外:

- **只写项目事实**:命令、目录、契约路径、高风险区域和领域审查要点均来自第 1、2 步的确认结果;未确认的写成“待确认”,在交付时列出。
- **规则只约束新改动**:生成的规范须写明不要求顺手重写历史代码。

### 6. 静态自检

第 5 步的脚本已运行 `check_docs.py`,要求没有错误;警告逐条判断后在交付说明中写明处理结果。之后再修改生成的文件时,在目标项目根目录重新运行 `python3 .agents/scripts/check_docs.py`。脚本检查:

- 所有相对链接指向存在的文件;模板占位符和条件标记没有残留。
- 路由链接构成的阅读图无环、没有指回上游,每个规范文件都能从 L0 到达;路由表没有被空行断开。
- SKILL.md 有 `name` 和 `description`;专题文件不含路由表。

以下由生成器人工核对:
- 每个审查职能都有对应 skill,每个 skill 写明向谁报告、能否修改代码。
- 档位、严重度阈值和门禁设置与第 2 步确认结果一致。

### 7. 模拟任务检查

按 [simulation-check.md](simulation-check.md) 设计模拟任务,按生成的规范逐步执行并临时记录每一步读取的信息,检查循环索引、回读、重复读取、缺失路由、递归审查和交接缺项等问题。发现问题时修改规范,并对受影响场景复跑。

### 8. 交付

交付说明包括:

- 生成的文件清单及索引层级;
- 各项选择及其来源;
- 静态自检与模拟检查的结果、因此修改的文件;
- 仍为“待确认”或“待核实”的事项;
- 未执行的检查及模拟的局限。

## 生成后的使用约定

以下约定写入生成的 L0 根入口,供目标项目长期使用:

- 审查结论只有三种:**通过**、**有阻断问题**、**证据不足**。证据不足不能写成通过。
- 严重度与阻断阈值见 [tiers.md](tiers.md) 中的严重度表;生成时写入目标项目,后续以项目内副本为准。
- 审查者只读,不代替实现者修改代码;问题使用稳定编号,由原责任职能复核关闭。
- 审查结论与代码快照绑定;代码变化后,受影响的结论需要复核。
- 任务过程产物统一保存在任务记录目录 `agentRecord/`,按任务一个文件,文件名使用 `YYYY-MM-DD-任务主题.md`。必须保留的产物包括:任务拆分与规划、用户授权、阶段进度、交接内容、审查问题台账与结论、用户验收状态。生成器同时创建 `agentRecord/README.md` 作为记录索引。
- 授权记录注明来源、日期、适用范围和有效状态,一次授权不扩展到其他任务。规范、skill 和规划正文只保留通用规则和必要链接,不写入具体任务的进度或授权。
Pliki w paczce (7)
  • LICENSE 1 KB
  • README.md 1 KB
  • SKILL.md 8 KB
  • index-structure.md 3 KB
  • simulation-check.md 4 KB
  • style-sourcing.md 3 KB
  • tiers.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie agent-workflow-generator.

Migawka bazy z 13.11.2026 · wersja paczki c2d1306a6680 (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

  • 100workflow-skill-creator
    Pomaga tworzyć skille wieloetapowe z plikiem postępu, rozdziałem kroków i etapami wykonania, od wymagań po samokontrolę.
  • 100init
    Tworzy nową sesję współpracy AgentHub z zadaniem, liczbą agentów i kryteriami oceny, do rywalizacji wielu agentów nad jednym zadaniem.
  • 100agent-team
    Tworzy zespoły agentów do równoległej współpracy: delegowanie zadań, praca w roju i dzielenie złożonego zadania między wielu agentów.
  • 100agent-init
    Inicjalizuje szkielet współpracy projektu dla Claude Code: tworzy lub uzupełnia CLAUDE.md i .claude oraz startowe szablony reguł, pamięci, agentów i hooków.
  • 100hub-init
    Tworzy nową sesję współpracy AgentHub z zadaniem, liczbą agentów i kryteriami oceny, przy rozpoczynaniu rywalizacji wielu agentów nad zadaniem.
  • 95agent-home
    Konfiguruje wspólny katalog agentów ~/.agents, sprawdza jego podłączenie do narzędzi i aktualizuje zasady po zmianach.

Uwagi i zgłoszenia

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