@bovinphang/frontend-craft 2.9.0 → 3.0.0

package/localized/zh-CN/skills/cc-cpp-project-standard/references/common/engineering-practices.sources.json

@@ -0,0 +1,377 @@
+{
+  "schemaVersion": 1,
+  "sources": [
+    {
+      "id": "google-review",
+      "publisher": "Google",
+      "title": "Code review standard",
+      "url": "https://google.github.io/eng-practices/review/reviewer/standard.html",
+      "section": "Engineering principles and code health",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living public guidance; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Use evidence and project standards; personal preference alone is not a blocker."
+    },
+    {
+      "id": "ms-playbook",
+      "publisher": "Microsoft ISE",
+      "title": "Test planning",
+      "url": "https://microsoft.github.io/code-with-engineering-playbook/automated-testing/test-planning/",
+      "section": "Risk, test scope and responsibilities",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living ISE playbook; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Team practice, not a company-wide mandate; retain existing tools."
+    },
+    {
+      "id": "ms-faults",
+      "publisher": "Microsoft ISE",
+      "title": "Fault injection testing",
+      "url": "https://microsoft.github.io/code-with-engineering-playbook/automated-testing/fault-injection-testing/",
+      "section": "Controlled failure and observations",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living ISE playbook; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Run scoped, controlled failures; do not infer production reliability from a small example."
+    },
+    {
+      "id": "google-ts",
+      "publisher": "Google",
+      "title": "TS/JS style guide",
+      "url": "https://google.github.io/styleguide/tsguide.html",
+      "section": "Environment caveat; types and exceptions",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Public guide; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Google explicitly notes internal constraints differ; no blanket ban overriding a justified project convention."
+    },
+    {
+      "id": "typescript-publishing",
+      "publisher": "TypeScript",
+      "title": "Publishing declaration files",
+      "url": "https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html",
+      "section": "Types and declaration dependencies",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living handbook; check installed compiler/module resolution",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Validate the actual packed consumer; do not upgrade compiler or module mode on this basis."
+    },
+    {
+      "id": "rust-api",
+      "publisher": "Rust library team",
+      "title": "Rust API Guidelines",
+      "url": "https://rust-lang.github.io/api-guidelines/",
+      "section": "Type safety, dependability and future proofing",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living recommendations; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Guidance rather than language law; preserve edition and MSRV."
+    },
+    {
+      "id": "tokio-join",
+      "publisher": "Tokio project",
+      "title": "JoinHandle",
+      "url": "https://docs.rs/tokio/latest/tokio/task/struct.JoinHandle.html",
+      "section": "Drop, abort and completion",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Page observed 1.54.1; project runtime/version determines applicability",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Tokio-specific mechanics only when Tokio is already used; no new runtime dependency."
+    },
+    {
+      "id": "uber-go",
+      "publisher": "Uber",
+      "title": "Go Style Guide",
+      "url": "https://github.com/uber-go/guide/blob/master/style.md",
+      "section": "Errors, interfaces and goroutine lifetime",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living master; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Do not import Uber dependencies or turn buffer-size style into a correctness theorem."
+    },
+    {
+      "id": "go-context",
+      "publisher": "Go project",
+      "title": "context package",
+      "url": "https://pkg.go.dev/context",
+      "section": "Cancellation propagation and ownership",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Standard library; check owning go.mod/toolchain",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "A cancellation signal alone does not confirm worker exit."
+    },
+    {
+      "id": "google-java",
+      "publisher": "Google",
+      "title": "Java Style Guide",
+      "url": "https://google.github.io/styleguide/javaguide.html",
+      "section": "Source structure and exception handling",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living public style; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Naming/layout follows local standard; style is distinct from runtime correctness."
+    },
+    {
+      "id": "oracle-resources",
+      "publisher": "Oracle",
+      "title": "Try-with-resources",
+      "url": "https://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html",
+      "section": "Closing resources and suppressed exceptions",
+      "checkedAt": "2026-11-08",
+      "versionScope": "JDK8 tutorial; not a source for newer runtime features",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Preserve primary cause and borrowed-resource ownership; check actual API contract."
+    },
+    {
+      "id": "java-executor",
+      "publisher": "Oracle",
+      "title": "ExecutorService",
+      "url": "https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/concurrent/ExecutorService.html",
+      "section": "Shutdown, termination and awaitTermination",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Java SE17 documentation",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Check target JDK; no automatic virtual-thread or JDK migration."
+    },
+    {
+      "id": "google-python",
+      "publisher": "Google",
+      "title": "Python Style Guide",
+      "url": "https://google.github.io/styleguide/pyguide.html",
+      "section": "Imports, exceptions and mutable state",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living public guide; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Keep current formatter/type checker and library responsibilities."
+    },
+    {
+      "id": "python-asyncio",
+      "publisher": "Python project",
+      "title": "Coroutines and tasks",
+      "url": "https://docs.python.org/3/library/asyncio-task.html",
+      "section": "Cancellation and task ownership",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Page observed 3.15.2; feature availability follows project Python",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Newer TaskGroup/timeout features require a supported project version; no upgrade implied."
+    },
+    {
+      "id": "cert-c",
+      "publisher": "CMU SEI",
+      "title": "MEM00-C allocation and release",
+      "url": "https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/recommendations/memory-management-mem/mem00-c/",
+      "section": "MEM00-C memory responsibility",
+      "checkedAt": "2026-11-08",
+      "versionScope": "2016-edition standard family; MEM00-C is a recommendation",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Do not label recommendations as mandatory CERT rules or apply C++ ownership machinery to pure C."
+    },
+    {
+      "id": "cpp-core",
+      "publisher": "C++ Core Guidelines editors",
+      "title": "C++ Core Guidelines",
+      "url": "https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines",
+      "section": "Resource and lifetime interfaces",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Page dated 2026-06-14, living release0.8",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Adapt to existing exception policy and compiler; borrowing does not imply ownership."
+    },
+    {
+      "id": "google-cpp",
+      "publisher": "Google",
+      "title": "C++ Style Guide",
+      "url": "https://google.github.io/styleguide/cppguide.html",
+      "section": "Exceptions and project consistency",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living public guide; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Its exception/standard policy is not universal; preserve the owning project policy and C ABI."
+    },
+    {
+      "id": "ms-sal",
+      "publisher": "Microsoft",
+      "title": "Understanding SAL",
+      "url": "https://learn.microsoft.com/en-us/cpp/code-quality/understanding-sal?view=msvc-170",
+      "section": "Parameter preconditions and output guarantees",
+      "checkedAt": "2026-11-08",
+      "versionScope": "MSVC170 documentation view",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "SAL is an optional toolchain-specific expression, not a portable mandatory annotation."
+    },
+    {
+      "id": "aws-retry",
+      "publisher": "AWS",
+      "title": "Timeouts, retries and backoff with jitter",
+      "url": "https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/",
+      "section": "Timeouts, bounded retries and retry amplification",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Article dated 2019-12-05; official Builder Center redirect",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Retry only semantically safe operations within a total budget; failure classes alone do not grant write replay."
+    },
+    {
+      "id": "aws-idempotency",
+      "publisher": "AWS",
+      "title": "Making retries safe with idempotent APIs",
+      "url": "https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/",
+      "section": "Caller intent, duplicate requests and atomic recording",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Builders Library; revision unknown",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "A process-local example does not establish database/multi-process exactly-once."
+    },
+    {
+      "id": "react-effects",
+      "publisher": "React project",
+      "title": "useEffect",
+      "url": "https://react.dev/reference/react/useEffect",
+      "section": "Cleanup and fetching race conditions",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Page observed React19.3; use installed project API",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "Abort and stale-result checks complement each other; no React upgrade implied."
+    },
+    {
+      "id": "react-act",
+      "publisher": "React project",
+      "title": "act",
+      "url": "https://react.dev/reference/react/act",
+      "section": "Applying updates before assertions",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Page observed React19.3; verify sample versions",
+      "licenseStatus": "unknown",
+      "adoption": "adopt",
+      "limits": "DOM simulation is not browser E2E or native desktop execution."
+    },
+    {
+      "id": "vue-watchers",
+      "publisher": "Vue project",
+      "title": "Watchers",
+      "url": "https://vuejs.org/guide/essentials/watchers.html",
+      "section": "Side-effect cleanup",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Vue3; onWatcherCleanup requires3.5+ and synchronous registration",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Use supported callback cleanup on older Vue3; no framework migration."
+    },
+    {
+      "id": "tauri-permissions",
+      "publisher": "Tauri project",
+      "title": "Permissions",
+      "url": "https://v2.tauri.app/security/permissions/",
+      "section": "Command allow/deny and capability scope",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Tauri2 docs; check installed version/configuration",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Rust command-unit tests do not activate webview permissions or prove packaged GUI security."
+    },
+    {
+      "id": "electron-security",
+      "publisher": "Electron project",
+      "title": "Security",
+      "url": "https://www.electronjs.org/docs/latest/tutorial/security",
+      "section": "IPC sender checks and renderer trust",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living docs; match installed Electron",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Handler tests do not prove sandbox/context isolation is active in a packaged app."
+    },
+    {
+      "id": "spring-tests",
+      "publisher": "Spring project",
+      "title": "Testing Spring Boot applications",
+      "url": "https://docs.spring.io/spring-boot/3.5/reference/testing/spring-boot-applications.html",
+      "section": "Test slices and application tests",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Boot3.5 docs observed3.5.16; preserve sample/project versions",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Test scope matters; MVC tests do not establish live DB/transaction or deployment behavior."
+    },
+    {
+      "id": "fastapi-lifespan",
+      "publisher": "FastAPI project",
+      "title": "Lifespan events",
+      "url": "https://fastapi.tiangolo.com/advanced/events/",
+      "section": "Acquire and release application resources",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living FastAPI documentation; match pinned dependencies",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Use actual lifespan execution in tests; import does not own a live connection."
+    },
+    {
+      "id": "gin-binding",
+      "publisher": "Gin project",
+      "title": "Binding",
+      "url": "https://gin-gonic.com/en/docs/binding/",
+      "section": "Binding errors and validation",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living Gin documentation; match pinned module",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Writing/aborting a response does not replace explicit control-flow return in the current handler."
+    },
+    {
+      "id": "axum-extractors",
+      "publisher": "Axum project",
+      "title": "Extractors",
+      "url": "https://docs.rs/axum/latest/axum/extract/",
+      "section": "Extractor order and rejections",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Latest route observed0.8.9; fixed0.8.9 route unavailable via browser tool",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Pinned existing example is authoritative for compilation; do not assume source signatures across releases."
+    },
+    {
+      "id": "drogon-filters",
+      "publisher": "Drogon project",
+      "title": "Middleware and Filter",
+      "url": "https://github.com/drogonframework/drogon/wiki/ENG-05-Middleware-and-Filter",
+      "section": "Filter callbacks and continuation",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Living wiki; match compiled example version",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Synthetic role headers are not authentication; callback lifetime must follow actual ownership."
+    },
+    {
+      "id": "node-typescript",
+      "publisher": "Node.js project",
+      "title": "Modules: TypeScript",
+      "url": "https://nodejs.org/api/typescript.html",
+      "section": "Type-stripping history, enabling, and separate type checking",
+      "checkedAt": "2026-11-08",
+      "versionScope": "Page observed26.13.0; sample>=22.18, actual24.14.1 tested; product Node>=22 unchanged",
+      "licenseStatus": "unknown",
+      "adoption": "conditional",
+      "limits": "Native stripping is not type checking and ignores tsconfig. Missing sample capability is MISSING, not a product runtime upgrade."
+    }
+  ]
+}

package/localized/zh-CN/skills/cc-cpp-project-standard/references/engineering-practices.md

@@ -0,0 +1,106 @@
+---
+practiceCards:
+  - id: "cc-cpp-project-standard:raii-borrowing"
+    level: "required"
+    sourceIds: ["cpp-core"]
+    caseIds: ["EP-CPP-01"]
+    evidence: "case"
+  - id: "cc-cpp-project-standard:exception-abi"
+    level: "conditional"
+    sourceIds: ["cpp-core","google-cpp","cert-c"]
+    caseIds: ["EP-CPP-01","EP-C-01"]
+    evidence: "review-only"
+  - id: "cc-cpp-project-standard:teardown-lifetime"
+    level: "conditional"
+    sourceIds: ["cpp-core","cert-c"]
+    caseIds: ["EP-CPP-01","EP-IPC-01"]
+    evidence: "review-only"
+---
+
+# 本入口工程决策
+
+先定位项目角色、工具链及已有约定，再按需读取[公共原则](common/engineering-practices.md)。下列条件仅约束当前语言/场景；结构检查不证明全部语义或实际运行。
+
+<a id="cc-cpp-project-standard:raii-borrowing"></a>
+## RAII拥有已获取资源，不接管全部指针
+
+级别: required
+
+### 风险
+用默认拥有删除器包装借用指针，可能释放别人的对象。
+
+### 适用
+适用于C++所有权API、构造及错误路径，先区分拥有、借用及共享寿命。
+
+### 决策
+本单元取得资源用RAII，借用值保留非拥有表示；unique_ptr表达独占拥有，shared_ptr需要真实共享寿命契约。
+
+### 例外
+自定义拥有者须配对分配器/删除器；智能指针不使悬挂借用安全，也不消除外部寿命前提。
+
+### 正反示意
+正例：本地unique_ptr拥有新lease，输入仍借用。反例：把所有raw输入转为shared_ptr。
+
+### 验证
+运行借用/部分构造断言；缺陷测试使用调用方堆对象并避免第二次delete，不靠不稳定UB崩溃。
+
+### 来源
+cpp-core — [来源与适用限制](common/engineering-practices.sources.json).
+
+证据标识: EP-CPP-01; case. [本入口可运行案例](../examples/engineering/README.md)。 执行状态及覆盖范围见实际记录；关联ID不证明该卡全部语义。
+
+<a id="cc-cpp-project-standard:exception-abi"></a>
+## 遵循所属项目异常与ABI政策
+
+级别: conditional
+
+### 风险
+全局启用异常或跨外部ABI展开可能破坏已有有效契约。
+
+### 适用
+实际存在异常/FFI边界时适用，Google等项目有意采用不同政策。
+
+### 决策
+先读编译标志和边界契约，启异常时保证部分构造安全；禁异常时沿用显式失败路径；保持C ABI错误/输出契约。
+
+### 例外
+noexcept不会把抛异常分配转成错误码；本地启异常样例只是独立目标，不授权改变用户标志或标准。
+
+### 正反示意
+正例：保留项目错误政策及分配器清理。反例：因指南偏好而启异常或把C迁为C++。
+
+### 验证
+按实际项目政策编译，检查失败转换/清理；样例只证明自己的C++边界，未验证跨ABI展开。
+
+### 来源
+cpp-core, google-cpp, cert-c — [来源与适用限制](common/engineering-practices.sources.json).
+
+证据标识: EP-CPP-01, EP-C-01; review-only.  执行状态及覆盖范围见实际记录；关联ID不证明该卡全部语义。
+
+<a id="cc-cpp-project-standard:teardown-lifetime"></a>
+## 先停止使用方，再释放共享依赖
+
+级别: conditional
+
+### 风险
+即使一个拥有者重置句柄，回调仍可能超出原生对象或插件代码寿命。
+
+### 适用
+适用于并发回调、原生插件和桌面关闭，顺序局部RAII无需引入调度器。
+
+### 决策
+先停新调用，取消/排空并确认所属任务结束，再释放缓冲、回调目标或卸载代码；明确每个join和最终释放方。
+
+### 例外
+引用计数只保护正确建模的所有权，不能防止所有悬挂别名或证明回调静止；强制关闭须明确未完成政策。
+
+### 正反示意
+正例：确认回调结束再卸载插件。反例：重置一个shared_ptr就认为所有借用指针安全失效。
+
+### 验证
+以受控销毁交错及实际原生工具检查，本地部分构造不证明race自由、GUI退出或代码卸载安全。
+
+### 来源
+cpp-core, cert-c — [来源与适用限制](common/engineering-practices.sources.json).
+
+证据标识: EP-CPP-01, EP-IPC-01; review-only.  执行状态及覆盖范围见实际记录；关联ID不证明该卡全部语义。

package/localized/zh-CN/skills/cc-cpp-project-standard/references/practice.md

@@ -0,0 +1,37 @@
+# C++ 工程规范
+
+## 关键检查
+
+1. 选择特性前读取实际 C++ 标准、标准库、编译器矩阵、构建 preset 和导出 ABI。
+
+2. 使用合适 RAII owner 表达所有权，借用指针保持明确借用；不要把外部拥有的裸指针擅自包成共享拥有。
+
+3. 说明异常保证并处理部分构造的资源释放；在明确边界捕获并准确转换失败，保持析构安全。
+
+4. 跨 DLL/FFI 时分配与释放配对，避免异常和不稳定实现类型穿越不支持的 ABI 契约。
+
+5. 审查析构顺序、回调生命周期及卸载同步，测试竞争销毁和错误路径，而不只测成功构造。
+
+6. 在声明平台验证现有构建和可用诊断，缺工具明确报告；编译成功不能证明竞态或生命周期安全。
+
+<a id="scope"></a>
+## 边界与案例
+
+适用场景：
+- 审查 C++ RAII 和异常安全
+- 保持插件 ABI 并明确所有权
+- 整理头文件与模板依赖边界
+- 测试 C++ 析构及部分构造
+
+应用角色按实际证据区分；本语言模块可用于库、CLI、桌面或服务，框架问题另选专项。
+
+## 交付要求
+
+- 已读取的工程/契约证据及变更作用域。
+- 选用方案、关键不变量、资源/错误或失败边界。
+- 实际运行的命令与结果，未运行项及不能证明的结论。
+- 兼容、恢复/回滚或后续处理限制；评审结论须给可核实位置。
+
+## 权威资料
+
+[相关官方/项目资料](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines)（核验日期：2026-11-06）。实际使用时再匹配项目声明版本，不把参考页的最新版本当作升级授权。

package/localized/zh-CN/skills/cc-debug-methodology/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: cc-debug-methodology
+description: 用于诊断工程故障、构建报错、服务异常、数据不一致或跨层问题，需要在选择修复前确认根因时。
+---
+
+# 证据驱动诊断
+
+读取并遵循[公共方法](references/method.md)，依据实际项目选择工具和专业检查，本流程不要求前端技术栈。

package/localized/zh-CN/skills/cc-debug-methodology/references/method.md

@@ -0,0 +1,13 @@
+# 证据驱动诊断
+
+通过五步流程确认根因后再修复。
+
+1. **分类：** 描述可观察故障、影响、版本、环境和最小复现，以项目证据确定相关子系统；跨层问题从表面症状逐层追踪。
+2. **收集：** 使用最小失败命令或操作复现，收集必要日志、trace、状态、配置和近期变更；隐藏凭证和敏感载荷。领域适配层提供技术栈专属诊断入口。
+3. **假设：** 最多保留三个按证据排序的假设，每个说明“X 导致 Y，可由 Z 证实或证伪”；不把症状或猜测性修复当作根因。
+4. **验证：** 一次改变一个变量，从最强假设开始，记录已证实/已证伪/待确认。全部失败则重新收集证据；同一假设连续三次失败时报告阻塞，不反复重试。
+5. **修复与校验：** 实施已确认根因的最小修复，保留回归复现，先运行受影响校验再扩大。已有失败单独记录，不关闭测试或削弱校验来宣称成功。
+
+依赖或环境故障先对比精确工具链、依赖版本、锁文件和本地/CI 差异，再决定是否升级。迁移与普通缺陷修复分开；没有证据时不先加重试、调超时或吞掉异常。
+
+交付 `reports/debug-YYYY-MM-DD-HHmmss.md`，包含症状与复现、证据、假设/结果表、根因、修改文件和行为、实际验证、剩余风险及下一步。没有观察到结果时不宣称修复或测试全绿。

package/localized/zh-CN/skills/cc-doc-sync-core/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: cc-doc-sync-core
+description: 用于项目文档、多语言 README、安装说明、CLI 用法或公共能力描述与实现、配置、测试和发布元数据发生漂移时。
+---
+
+# 文档事实同步
+
+读取并遵循[公共方法](references/method.md)，依据实际项目选择工具和专业检查，本流程不要求前端技术栈。

package/localized/zh-CN/skills/cc-doc-sync-core/references/method.md

@@ -0,0 +1,12 @@
+# 文档事实同步
+
+从实现事实同步公共文档，不把期望设计写成既有能力。
+
+1. 明确技术栈、文档入口和本次范围，覆盖根 README、嵌套包/应用/Runtime README 和部署指南；排除依赖、构建产物和第三方目录。
+2. 收集权威事实：清单和锁文件、配置、环境变量示例、命令、schema、公共 API、测试、CI、构建与部署文件。使用实际技术栈的来源，不强制某一种语言的项目清单。
+3. 对照命令、环境变量名、路径、版本、API 行为、能力、安装和部署说明。只写稳定公共事实，不将提案和实验设计描述为已支持行为。
+4. 检查全部已有语言入口。公共标识、命令、版本范围、支持矩阵、报告路径和示例必须一致；文案遵循现有翻译约定，明确需要人工复核的内容。
+5. 同步相关 README/docs/ADR/changelog 和用户可见元数据。ADR 记录背景、决定、备选、影响、验证和回退线索，不写成完整评审报告。
+6. 执行项目已有一致性、相关类型/测试/构建/打包检查和旧引用搜索。记录每份已查文档、事实源、已同步语言、不需修改的入口和未决问题。
+
+不虚构命令或环境变量，不越界修改用户私有文档，不用内部实现细节淹没 README。文案编辑成功不等于事实一致性已经验证。

package/localized/zh-CN/skills/{fec-drawio-studio → cc-drawio-studio}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: fec-drawio-studio
+name: cc-drawio-studio
 description: 用于创建带 draw.io / diagrams.net 源文件的可编辑技术图，包括架构图、ERD、UML、序列图、流程图、ML 模型图、官方形状检索、品牌符号、Graphviz 自动布局、代码结构图、.drawio 校验或 draw.io CLI 导出兜底。不要用于普通位图生成、手绘草图、交互式 Canvas/Three.js 场景或装饰性 SVG 动画；中文触发词包括 draw.io、diagrams.net、可编辑架构图、.drawio、ER 图、UML、序列图、自动布局、形状检索、代码结构图。
 ---
 
@@ -36,11 +36,11 @@ description: 用于创建带 draw.io / diagrams.net 源文件的可编辑技术
 4. 校验和预览
    - 每次生成 `.drawio` 后运行：
      ```bash
-     node skills/fec-drawio-studio/scripts/diagram-lint.mjs diagram.drawio --format markdown
+     node skills/cc-drawio-studio/scripts/diagram-lint.mjs diagram.drawio --format markdown
      ```
    - 若本机有 draw.io desktop CLI，导出预览 PNG 时不要嵌入 XML，并控制宽度：
      ```bash
-     node skills/fec-drawio-studio/scripts/drawio-export.mjs diagram.drawio --format png --output diagram.png --width 2000
+     node skills/cc-drawio-studio/scripts/drawio-export.mjs diagram.drawio --format png --output diagram.png --width 2000
      ```
    - 若 CLI 不可用，用 [diagram-url.mjs](scripts/diagram-url.mjs) 生成 diagrams.net viewer/editor URL；严格离线或数据驻留敏感时先读取 [data-residency.md](references/data-residency.md)。
 
@@ -48,8 +48,8 @@ description: 用于创建带 draw.io / diagrams.net 源文件的可编辑技术
    - 保存 `.drawio` 源文件和用户需要的 PNG/SVG/PDF/JPG。
    - 最终 PNG 若使用 draw.io `-e` 嵌入 XML，导出后运行：
      ```bash
-     node skills/fec-drawio-studio/scripts/drawio-export.mjs diagram.drawio --format png --output diagram.drawio.png --scale 2 --embed
-     node skills/fec-drawio-studio/scripts/png-embed-fix.mjs diagram.drawio.png
+     node skills/cc-drawio-studio/scripts/drawio-export.mjs diagram.drawio --format png --output diagram.drawio.png --scale 2 --embed
+     node skills/cc-drawio-studio/scripts/png-embed-fix.mjs diagram.drawio.png
      ```
    - 报告源文件、导出文件、校验结果和无法自动验证的外部依赖。
 

package/localized/zh-CN/skills/{fec-drawio-studio → cc-drawio-studio}/references/flowchart-quality.md

@@ -43,7 +43,7 @@
 交付前运行：
 
 ```bash
-node skills/fec-drawio-studio/scripts/diagram-lint.mjs diagram.drawio --format markdown --strict
+node skills/cc-drawio-studio/scripts/diagram-lint.mjs diagram.drawio --format markdown --strict
 ```
 
 然后手动打开图表，检查主路径连线没有交叉、标签没有截断、阶段没有像折叠态一样不可读，并且 diagrams.net 默认缩放下文字仍然清晰。