Was macht Entwicklungscodierung und -normen?
Ein Skill, ein Workflow, zwei Ressourcensprachen.
Paarweise Ressourcenrevision / 双语资源配对修订：2026-10-05.9。Dies identifiziert das Ressourcenpaket, nicht die Projektfreigabe oder bestandene Verifizierung.
Sprachauswahl / 语言选择
- Wählen Sie die Anweisungssprache aus der expliziten Präferenz des Benutzers; verwenden Sie andernfalls
zh-CNfür chinesische Anfragen undenfür englische Anfragen。Verwenden Sie für andere Sprachen englische Ressourcen und antworten Sie in der Sprache des Benutzers。Leiten Sie die Sprache nicht aus UI-Metadaten oder der Sprache der Quelldateien ab。 规则语言优先遵循用户明确偏好，否则中文请求选zh-CN、英文请求选en；其他语言使用英文资源并以用户语言沟通。不根据界面配置或源文件语言推断用户偏好。 - Folgen Sie für Konversationen der vom Benutzer angeforderten Sprache, andernfalls seiner aktuellen Anfrage。Verwenden Sie für jedes Dokument die explizit angeforderte Sprache, andernfalls die Konvention der vorhandenen Projektdokumentation, andernfalls die Konversationssprache。Verwenden Sie die entsprechende Vorlage; passen Sie für andere Sprachen eine englische Vorlage an。Übersetzen Sie keine nicht zusammenhängenden Dateien und benennen Sie keine Code-Identifikatoren als Nebeneffekt um。 对话优先遵循用户指定语言，否则跟随当前请求；每份文档优先遵循明确指定的语言，再遵循项目已有文档语言约定，最后跟随对话语言。使用相应模板，其他语言可基于英文模板调整；不顺带翻译无关文件或重命名代码标识符。
- Lesen Sie vor der Aufgabenarbeit genau eine der folgenden Grundlinien, dann nur deren relevante Referenzen für die Aufgabe。Eine angeforderte Dokumentsprache kann sich von der Anweisungssprache unterscheiden; laden Sie nicht beide vollständigen Ressourcensätze nur aus diesem Grund。 开始任务工作前读取下方一种语言的核心规范，再按需加载其中相关参考。文档目标语言可与规则语言不同，不因此加载两套完整资源。
| Grundlinie / 核心规范 | Wann zu lesen / 读取条件 |
|---|---|
| Chinesische Normen | Chinesische Anweisungssprache / 规则语言为中文 |
| Englische Standards | Englische oder Fallback-Anweisungssprache / 规则语言为英文或使用英文回退 |
Gemeinsame Invarianten / 共同约束
- Genehmigen Sie für die formale Entwicklung zuerst die Anforderungen, dann das vollständige Modul-/Architekturdesign für den aktuellen Implementierungsumfang; neue Projekte erfordern auch eine explizite Stack-Bestätigung。Die teilweise Genehmigung deckt nur den identifizierten Umfang ab; notwendige Abhängigkeiten müssen ebenfalls genehmigt werden, nicht implizit eingeschlossen。Implementieren oder rüsten Sie keine Projekte auf, bevor die geltenden Gates bestanden wurden。Verwenden Sie echte, anwendbare Genehmigungen wieder; erfinden Sie sie niemals。 正式开发先确认需求，再确认本次实施范围的完整模块架构；新项目还须明确确认技术栈。部分确认仅覆盖指定范围，必要依赖也须已确认，不自动扩大批准。适用门槛未通过前不实施或初始化工程；复用真实有效确认，不伪造批准。
- Erfordern komplexe Module während des Architekturdesigns Architekturdiagramme und komplexe Arbeitsabläufe Flussdiagramme, die mit dem Design gespeichert werden und mit den Modul-/Schnittstellenbeschreibungen konsistent sind。Fehlende erforderliche Diagramme lassen diesen Umfang unvollständig; Diagramme ersetzen keine Verträge oder fügen keine Genehmigungsphase hinzu。Einfache Designs und schreibgeschützte/leichte Aufgaben erfordern keine Rückvervollständigung von projektspezifischen Diagrammen。 架构设计阶段，复杂模块必须用架构图、复杂流程必须用流程图表示，随设计文档保存并与模块/接口说明一致。缺少必需图示时对应范围设计不完整；图不替代契约、不新增审批。简单设计及只读/轻量任务不要求补画全项目图。
- Wenn ein Schnittstellendesign erforderlich ist, liefern Sie drei wirklich unterschiedliche, im Browser anzeigbare HTML-Visualprototypen für denselben Umfang von Anforderungen und repräsentativen Bildschirmen, wobei Ästhetik, Layout, Typografie und visuelle Hierarchie priorisiert werden。Statisches HTML/CSS ist ausreichend; JavaScript und Interaktionsdemos sind optional, sofern nicht explizit angefordert。Geben Sie Einträge und tatsächliche Rendering-Prüfergebnisse an, halten Sie Kompromisse und die Auswahl des Benutzers fest, bevor Sie mit der formalen Implementierung beginnen。Isolierte Designarbeit umgeht nicht die Anforderungs-/Stack-/Architektur-Gates oder autorisiert Live-Dienste。Verwenden Sie gültige, anwendbare Auswahlmöglichkeiten wieder; schreibgeschützte Überprüfungen und Reparaturen, die ein etabliertes Design bewahren, erzwingen keine erneute Auswahl。 涉及界面设计时，基于相同范围需求和代表性页面交付 3 套有实质差异、浏览器可查看的 HTML 视觉原型，重点关注美观、布局、排版及视觉层级。静态 HTML/CSS 示意页面即可，JS 与轻量交互默认可选；用户明确要求交互演示时按指定范围实现。提供入口及真实渲染检查结果，记录取舍和用户选择后再正式实施。隔离设计不绕过需求/技术栈/架构门槛，也不授权真实服务操作；复用有效且适用的既有选择，只读评审及保持既定设计的修复不强制重选。
- Überprüfen Sie zu Beginn der Codierung, ob die abgestimmte Implementierung eine Datenbank verwendet。Wenn ja, geben Sie deren Design aus und speichern Sie es, bevor Sie datenbankbezogenen Code schreiben: Schlagen Sie eine neue Datenbank vor oder überprüfen/verwenden Sie ein vorhandenes Design wieder, Standard ist
docs/database-design.md。Keine Datenbank bedeutet kein Datenbankdokument。Dies ist ein Codierungsdeliverable, keine Voraussetzung für die Architekturgenehmigung oder eine zusätzliche Genehmigungsphase。Es gelten weiterhin anwendbare Umfangsänderungen und Datenschutzmaßnahmen; schreibgeschützte Arbeit autorisiert keine Bearbeitungen。 开始编码时检查本次实现是否使用数据库；涉及时，数据库相关代码前必须输出并保存设计，默认docs/database-design.md：新库给出方案，已有库先核对并复用/更新现有设计。不使用数据库则不生成该文档。它是编码阶段交付物，不是架构批准的前置附件，不增加审批阶段；仍遵守范围变更和数据操作安全要求，只读工作不授权编辑。 - Jede vollständige Projektcodeänderung, einschließlich Fehlerbehebungen und Refaktorisierungen, muss die betroffene Produktversion gemäß dem etablierten Schema erhöhen。Aktualisieren Sie die tatsächliche Versionsquelle und erforderliche synchronisierte Einträge vor der Übergabe, und melden Sie alte/neue Werte und Positionen。Zählen Sie eine vollständige Änderung, nicht jede Dateibearbeitung oder Wiederholung。Reine Dokumentations-/schreibgeschützte Arbeit löst keinen Produkt-Bump aus; unklare Schemata oder Autoritätskonflikte erfordern Klärung。Versions-Bumps autorisieren keine Veröffentlichung oder verzichten auf Kompatibilitätsanforderungen。 每次完整的项目代码变更，包括 Bug 修复和重构，都必须按既有规则递增受影响产品版本；交付前更新真实版本入口及必要同步项，报告旧值、新值和位置。按完整变更计数，不按文件编辑或重试次数；纯文档/只读工作不触发产品升版，规则不明或授权冲突时先澄清。升版不授权发布，也不豁免兼容要求。
- Qualifizierte, risikoarme lokalisierte Reparaturen stellen die klare Absicht wieder her; qualifizierte, verhaltenserhaltende Refaktorisierungen behalten beobachtbares Verhalten, Fehler und Nebeneffekte bei。Beide bleiben innerhalb des autorisierten Umfangs ohne neue Funktionen, Vertrags-/Grenzänderungen oder risikoreiche Effekte。Geben Sie das Ziel, die Nachweise, den Umfang und den Verifikationsplan an; erzwingen Sie keine historische Produktdokumentations-Rückvervollständigung oder redundante Genehmigung。Klären Sie Unklarheiten und eskalieren Sie betroffene Arbeiten, wenn sich Umfang oder Risiko erhöhen。 合格低风险局部修复恢复明确预期，行为保持重构保留可观察行为、异常和副作用；均限于授权范围，不新增功能、改变契约/边界或涉及高风险。简述目标、依据、范围和验证方式，不追补历史产品文档或重复审批；有歧义先澄清，范围或风险扩大时升级受影响流程。
- Bei Client/Server-Produkten müssen Serveränderungen die Protokolle, Schnittstellen, Feldsemantiken und Kernabläufe älterer Produkt-Agenten ohne erzwungene Agent-Upgrades erhalten。Benutzer-/Projekt-Kompatibilitätsumfang und tatsächliche Nachweise älterer Agenten sind für betroffene Interaktionen erforderlich。Inkompatibilität, fehlgeschlagene oder fehlende Verifikation blockiert Merge/Release, nicht nur eine Warnung。Agent ist hier ein Software-Client, kein LLM。 对客户端/Server 产品，服务端改动须保持低版本产品 Agent 的协议、接口、字段语义及核心流程，不强制升级 Agent。涉及交互时遵循用户/项目兼容范围并提供实际低版本证据；不兼容、验证失败或缺失阻断合并发布。Agent 指软件客户端，不是大模型。
- Beachten Sie den Benutzerumfang, die Repository-Regeln und Anweisungen höherer Priorität。Schreibgeschützte Anfragen autorisieren keine Bearbeitungen。Genehmigung gewährt keine Berechtigungen für nicht zusammenhängende Commits, Pushes, PRs, Deployments, Produktionsdaten oder externe Schreibvorgänge。Berichten Sie tatsächliche Nachweise und nicht verifizierte Arbeit; Selbstprüfung ist keine unabhängige Überprüfung。 遵守用户范围、仓库规则及更高优先级指令；只读请求不授权编辑，批准不授予无关提交、推送、PR、部署、生产数据或外部写入权限。按实际证据报告未验证项，自审不冒充独立审查。
Übersetzungspflege / 翻译维护
| Begriff / 术语 | Bedeutung / 含义 |
|---|---|
| Erforderlich / 必须 | Anwendbare Verpflichtung, kein Vorschlag / 适用时须满足，不是建议 |
| Darf nicht / 不得 | Verbotene Aktion / 禁止的操作 |
| Empfohlen / 建议 | Bevorzugt, mit begründeter Anpassung erlaubt / 优先采用，可按依据调整 |
| Genehmigt / 已确认 | Echte Genehmigung identifizierten Inhalts und Umfangs / 真实确认指定内容与范围 |
| Verifiziert / 已验证 | Relevante Prüfungen tatsächlich bestanden, nicht Genehmigung oder Deployment / 相关检查实际通过，不等于批准或部署 |
references/zh-CN und assets/zh-CN sind die chinesischen Regel-/Vorlagenquellen; die entsprechenden en-Dateien sind Übersetzungen, keine unabhängigen Richtlinien。Aktualisieren Sie entsprechende Dateien, Links, READMEs und betroffene Verhaltensszenarien zusammen; erhöhen Sie die paarweise Revision des Pakets in diesem Einstiegspunkt, beiden READMEs und Ressourcen-Headern。Eine übereinstimmende Revision ist kein Beweis für semantische Äquivalenz。Halten Sie die obigen Begriffe, Aufgabenmodi, Sicherheitsbeschränkungen und Evidenz-Standards äquivalent。Alleiniger Sprachwechsel macht Genehmigungen nicht ungültig oder autorisiert Arbeit。Wenn eine Diskrepanz entdeckt wird, melden Sie sie und konsultieren Sie nur die betroffene chinesische Quelle; wählen Sie nicht stillschweigend eine schwächere Übersetzung。Wenn die Quelle nicht überprüft werden kann, legen Sie die Unsicherheit offen und behaupten Sie nicht, dass das betroffene Gate bestanden wurde。Anweisungen höherer Priorität bleiben maßgeblich。
references/zh-CN 和 assets/zh-CN 是中文规则/模板源，同名 en 文件是译文，不是独立政策。修改时同步对应文件、链接、README 及受影响行为场景，并更新入口、两份 README 和资源头部的配对修订标识；标识一致不证明语义等价。保持上表术语、任务模式、安全约束和证据标准等价。仅切换语言不使批准失效或授予实施权限。发现差异时报告并仅核对受影响中文源，不静默选择更宽松译文；源文无法核验时说明不确定性，不声称相关门槛已通过。更高优先级指令始终优先。