技能 agile-design-doc
📦

agile-design-doc

安全

Agile Designdokumente erstellen

Entwicklungsteams benötigen prägnante Designdokumente, die mit MVP-Prinzipien vereinbar sind und Over-Engineering vermeiden. Dieses Skill erstellt fokussierte, technische Designdokumente mit Mermaid-Diagrammen, Implementierungsdetails und klaren Erfolgskriterien.

支持: Claude Codex Code(CC)
⚠️ 67 差
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“agile-design-doc”。 Erstellen Sie ein Designdokument für ein Benutzerauthentifizierungs-Feature in einer Python-Flask-Anwendung

预期结果:

  • Designdokument: Benutzerauthentifizierung
  • Ziel: Flask-basierte REST-API
  • Hauptfunktionen: Login, Registrierung, Token-Refresh
  • Mermaid-Sequenzdiagramm, das den Auth-Flow zeigt
  • Codebeispiele für Auth-Endpunkte

正在使用“agile-design-doc”。 Erstellen Sie ein Designdokument für die Integration eines Zahlungsabwicklungsmoduls

预期结果:

  • Design der Zahlungsmodul-Integration
  • Datenmodelle: Bestellung, Zahlung, Transaktion
  • API-Endpunkte mit Anfrage/Antwort-Schemata
  • Sequenzdiagramm: Bestellung -> Zahlungs-Gateway -> Callback
  • Fehlerbehandlung und Wiederholungsstrategien

安全审计

安全
v1 • 3/10/2026

Security audit completed. All 39 static findings are false positives. The skill contains only markdown documentation templates with example code blocks (Python, JSON, Mermaid diagrams). No actual code execution, cryptographic algorithms, or malicious patterns exist. This is a legitimate documentation generation skill for agile development teams.

2
已扫描文件
315
分析行数
4
发现项
1
审计总数

高风险问题 (2)

SKILL.md:2-3
False Positive: Weak Cryptographic Algorithm Detection
Static analyzer incorrectly flagged YAML frontmatter fields as cryptographic code. Lines 2-3 contain name: and description: fields, not cryptographic algorithms.
SKILL.md:1
False Positive: High File Entropy Detection
Static analyzer flagged YAML frontmatter delimiter as potential encrypted content. Line 1 contains standard --- markdown separator.
中风险问题 (1)
SKILL.md:39-211references/template.md:17-92
False Positive: Ruby/Shell Backtick Execution
Static analyzer detected backticks and flagged as shell execution. These are markdown code fences used for syntax highlighting in documentation. No actual code execution occurs.
低风险问题 (1)
SKILL.md:98-111references/template.md:17-30
False Positive: System Reconnaissance
Static analyzer flagged mermaid diagram definitions as system reconnaissance. These are standard sequence diagrams showing component interactions, not network scanning.
审计者: claude

质量评分

41
架构
100
可维护性
85
内容
32
社区
78
安全
83
规范符合性

你能构建什么

Schneller Design-Sprint

Erstellen Sie schnell ein Designdokument für ein neues Feature während des Sprint-Planning

Abteilungsübergreifende Ausrichtung

Erstellen Sie standardisierte Designdokumente, die Backend-, Frontend- und QA-Teams helfen, Anforderungen zu verstehen

Technische Dokumentation

Erstellen Sie Referenzdokumentation für vorhandene Systemmodule

试试这些提示

Neues Feature-Design 
Erstellen Sie ein Designdokument für ein neues [Feature-Name]-Feature. Das Feature sollte [kurze Beschreibung]. Ziehen Sie die Verwendung von [Tech-Stack] in Betracht.
API-Designdokument 
Erstellen Sie ein Designdokument für eine REST-API, die [Ressource] verarbeitet. Include Datenmodelle, Endpunkte und Sequenzdiagramme.
Modulintegration 
Erstellen Sie ein Designdokument, das zeigt, wie [neues Modul] in das vorhandene [vorhandenes System] integriert wird. Zeigen Sie den Interaktionsfluss.
Datenmodell-Design 
Entwerfen Sie die Datenmodelle und -beziehungen für [Domänenbereich]. Include wichtige Entitäten, Attribute und wie sie interagieren.

最佳实践

  • Beginnen Sie mit der Analyse des vorhandenen Tech-Stacks aus Projektkonfigurationsdateien
  • Konzentrieren Sie sich auf den MVP-Umfang - dokumentieren Sie zuerst die Kernfunktionalität
  • Verwenden Sie Mermaid-Diagramme, um Komponenteninteraktionen zu visualisieren
  • Include Codebeispiele für kritische Implementierungspfade

避免

  • Hinzufügen unnötiger Funktionen, die auf spätere Iterationen verschoben werden könnten
  • Lange Hintergrunderklärungen schreiben statt sich auf die Implementierung zu konzentrieren
  • Vorhandene Komponenten ignorieren und Funktionalität duplizieren
  • Jeden möglichen Randfall einbeziehen statt sich auf Happy Paths zu konzentrieren

常见问题

Welche Informationen sollte ich für die besten Ergebnisse bereitstellen?
Geben Sie den Feature-Namen, seinen Zweck, den Projekt-Tech-Stack und alle vorhandenen Komponenten an, die wiederverwendet werden sollten.
Kann dieses Skill Code für jede Programmiersprache erstellen?
Das Skill stellt Beispiele in Python, Java, JavaScript und Go basierend auf Ihrer Projektkonfiguration bereit.
Wie detailliert sind die erstellten Diagramme?
Mermaid-Sequenzdiagramme zeigen die Hauptkomponenteninteraktionen. Sie können bei Bedarf detailliertere Diagramme anfordern.
Verbindet sich dieses Skill mit externen Systemen?
Nein, dieses Skill erstellt nur Dokumentationstext. Es stellt keine Netzwerkanfragen oder führt Code aus.
Kann ich dies für die Dokumentation von Legacy-Systemen verwenden?
Ja, geben Sie die Details des vorhandenen Systems an, und das Skill hilft dabei, die aktuelle Architektur zu dokumentieren.
Wie kann ich das erstellte Dokument verfeinern?
Überprüfen Sie die Ausgabe und geben Sie Feedback. Das Skill kann bei Bedarf bestimmte Abschnitte iterieren.

开发者详情

作者

AriesYB

许可证

MIT

仓库

https://github.com/AriesYB/agile-design-doc-skill/tree/main/skill

引用

main

文件结构

📁 references/

📄 template.md

📄 SKILL.md