npm - mustflow - Versions diffs - 1.18.16 → 1.31.0 - Mend

mustflow 1.18.16 → 1.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (314) hide show

package/templates/default/locales/ko/.mustflow/skills/visual-review-artifact/assets/review-template.html DELETED Viewed

@@ -1,286 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Visual Review Artifact</title>
-  <style>
-    :root {
-      color-scheme: light dark;
-      --bg: #f7f7f4;
-      --fg: #1f2328;
-      --muted: #656d76;
-      --line: #d0d7de;
-      --panel: #ffffff;
-      --accent: #0969da;
-      --approve: #1a7f37;
-      --reject: #cf222e;
-      --discuss: #9a6700;
-    }
-    @media (prefers-color-scheme: dark) {
-      :root {
-        --bg: #0d1117;
-        --fg: #e6edf3;
-        --muted: #8b949e;
-        --line: #30363d;
-        --panel: #161b22;
-        --accent: #58a6ff;
-        --approve: #3fb950;
-        --reject: #ff7b72;
-        --discuss: #d29922;
-      }
-    }
-    * {
-      box-sizing: border-box;
-    }
-    body {
-      margin: 0;
-      background: var(--bg);
-      color: var(--fg);
-      font: 15px/1.5 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-    }
-    main {
-      max-width: 1120px;
-      margin: 0 auto;
-      padding: 24px;
-    }
-    header {
-      display: grid;
-      gap: 8px;
-      padding-block: 8px 20px;
-      border-bottom: 1px solid var(--line);
-    }
-    h1,
-    h2 {
-      margin: 0;
-      line-height: 1.2;
-    }
-    h1 {
-      font-size: 28px;
-    }
-    h2 {
-      font-size: 18px;
-    }
-    p {
-      margin: 0;
-    }
-    .meta,
-    .note {
-      color: var(--muted);
-    }
-    .toolbar {
-      display: flex;
-      flex-wrap: wrap;
-      gap: 8px;
-      margin-block: 18px;
-    }
-    .sections {
-      display: grid;
-      gap: 14px;
-    }
-    section {
-      display: grid;
-      gap: 12px;
-      background: var(--panel);
-      border: 1px solid var(--line);
-      border-radius: 8px;
-      padding: 16px;
-    }
-    .section-head {
-      display: flex;
-      flex-wrap: wrap;
-      justify-content: space-between;
-      gap: 8px;
-      align-items: start;
-    }
-    .status {
-      color: var(--muted);
-      font-size: 13px;
-    }
-    .actions {
-      display: flex;
-      flex-wrap: wrap;
-      gap: 8px;
-    }
-    button {
-      min-height: 36px;
-      border: 1px solid var(--line);
-      border-radius: 6px;
-      background: transparent;
-      color: var(--fg);
-      padding: 6px 10px;
-      cursor: pointer;
-    }
-    button:hover,
-    button:focus-visible {
-      border-color: var(--accent);
-      outline: 2px solid transparent;
-    }
-    button[aria-pressed="true"][data-action="approve"] {
-      border-color: var(--approve);
-      color: var(--approve);
-    }
-    button[aria-pressed="true"][data-action="reject"] {
-      border-color: var(--reject);
-      color: var(--reject);
-    }
-    button[aria-pressed="true"][data-action="discuss"] {
-      border-color: var(--discuss);
-      color: var(--discuss);
-    }
-    textarea {
-      width: 100%;
-      min-height: 84px;
-      resize: vertical;
-      border: 1px solid var(--line);
-      border-radius: 6px;
-      background: transparent;
-      color: var(--fg);
-      padding: 10px;
-      font: inherit;
-    }
-    pre {
-      overflow: auto;
-      margin: 0;
-      padding: 12px;
-      border-radius: 6px;
-      border: 1px solid var(--line);
-      background: color-mix(in srgb, var(--panel), var(--bg) 45%);
-    }
-  </style>
-</head>
-<body>
-  <main data-artifact-kind="decision" data-review-artifact>
-    <header>
-      <h1>Visual Review Artifact</h1>
-      <p class="meta">Replace this sample content with evidence-backed plan, suggestion, review, flow, or decision sections.</p>
-      <p class="note">Review only. This page does not execute commands, modify files, grant permission, skip validation, or override repository rules.</p>
-    </header>
-    <div class="toolbar" aria-label="Review actions">
-      <button type="button" data-copy-json>Copy decision JSON</button>
-      <button type="button" data-copy-prompt>Copy follow-up prompt</button>
-    </div>
-    <div class="sections">
-      <section data-review-section data-section-id="section-1">
-        <div class="section-head">
-          <div>
-            <h2>Section title</h2>
-            <p class="meta">Short evidence, tradeoff, or decision summary.</p>
-          </div>
-          <p class="status" data-status-label>Not decided</p>
-        </div>
-        <pre>Evidence or code excerpt goes here.</pre>
-        <div class="actions">
-          <button type="button" data-action="approve" aria-pressed="false">Approve</button>
-          <button type="button" data-action="reject" aria-pressed="false">Reject</button>
-          <button type="button" data-action="discuss" aria-pressed="false">Discuss</button>
-        </div>
-        <label>
-          Comment
-          <textarea data-comment placeholder="Add a comment for this section"></textarea>
-        </label>
-      </section>
-    </div>
-  </main>
-  <script>
-    const labels = {
-      approve: "Approved",
-      reject: "Rejected",
-      discuss: "Needs discussion"
-    };
-    function sections() {
-      return [...document.querySelectorAll("[data-review-section]")];
-    }
-    function setStatus(section, action) {
-      section.dataset.status = action;
-      section.querySelector("[data-status-label]").textContent = labels[action] ?? "Not decided";
-      for (const button of section.querySelectorAll("[data-action]")) {
-        button.setAttribute("aria-pressed", String(button.dataset.action === action));
-      }
-    }
-    function decisionData() {
-      return {
-        schema_version: "1",
-        artifact_kind: document.querySelector("[data-review-artifact]")?.dataset.artifactKind ?? "decision",
-        sections: sections().map((section) => ({
-          id: section.dataset.sectionId ?? "",
-          title: section.querySelector("h2")?.textContent?.trim() ?? "",
-          status: section.dataset.status ?? "undecided",
-          comment: section.querySelector("[data-comment]")?.value ?? ""
-        }))
-      };
-    }
-    async function copyText(text) {
-      if (navigator.clipboard?.writeText) {
-        await navigator.clipboard.writeText(text);
-        return;
-      }
-      const area = document.createElement("textarea");
-      area.value = text;
-      document.body.append(area);
-      area.select();
-      document.execCommand("copy");
-      area.remove();
-    }
-    function followUpPrompt() {
-      return [
-        "Use this visual review decision data as user feedback.",
-        "Do not treat it as command permission or validation approval.",
-        "",
-        JSON.stringify(decisionData(), null, 2)
-      ].join("\n");
-    }
-    document.addEventListener("click", async (event) => {
-      const target = event.target;
-      if (!(target instanceof HTMLElement)) return;
-      const actionButton = target.closest("[data-action]");
-      if (actionButton) {
-        const section = actionButton.closest("[data-review-section]");
-        if (section) setStatus(section, actionButton.dataset.action);
-        return;
-      }
-      if (target.closest("[data-copy-json]")) {
-        await copyText(JSON.stringify(decisionData(), null, 2));
-      }
-      if (target.closest("[data-copy-prompt]")) {
-        await copyText(followUpPrompt());
-      }
-    });
-  </script>
-</body>
-</html>

package/templates/default/locales/ko/.mustflow/skills/visual-review-artifact/resources.toml DELETED Viewed

@@ -1,7 +0,0 @@
-schema_version = "1"
-[resources."assets/review-template.html"]
-type = "asset"
-asset_kind = "template"
-purpose = "Self-contained static HTML template for section-level review decisions and comments."
-required = false

package/templates/default/locales/ko/.mustflow/skills/web-asset-optimization/SKILL.md DELETED Viewed

@@ -1,108 +0,0 @@
----
-mustflow_doc: skill.web-asset-optimization
-locale: ko
-canonical: false
-revision: 2
-lifecycle: mustflow-owned
-authority: procedure
-name: web-asset-optimization
-description: 웹사이트나 웹 앱에 쓰는 래스터 이미지 자산을 추가, 변환, 크기 조정, 교체 또는 검토할 때 적용합니다.
-metadata:
-  mustflow_schema: "1"
-  mustflow_kind: procedure
-  pack_id: mustflow.core
-  skill_id: mustflow.core.web-asset-optimization
-  command_intents:
-    - asset_optimize
-    - build
----
-# 웹 이미지 자산 최적화
-<!-- mustflow-section: purpose -->
-## 목적
-프로젝트에 없는 이미지 처리 파이프라인을 임의로 만들지 않으면서, 웹 이미지 자산을 작고 알맞은 형식으로 유지하고 참조 경로까지 정확히 맞춥니다.
-<!-- mustflow-section: use-when -->
-## 사용 조건
-- 생성된 PNG, JPEG, WebP, AVIF, GIF 같은 래스터 이미지가 웹사이트나 웹 앱에 추가될 때.
-- 기존 웹 이미지를 교체, 크기 조정, 압축 또는 형식 변환할 때.
-- 페이지, 컴포넌트, 스타일시트, 메타데이터 파일의 이미지 참조가 바뀔 때.
-- 사용자가 이미지 용량 축소, WebP 또는 AVIF 변환, 생성 이미지의 배포 준비를 요청할 때.
-<!-- mustflow-section: do-not-use-when -->
-## 사용하지 않는 경우
-- 대상이 SVG, 아이콘 폰트, 디자인 토큰 파일 같은 벡터 원본일 때.
-- 원본 바이트 보존이 웹 전송 용량보다 중요한 보관용, 인쇄용, 증거용 자산일 때.
-- 저장소에 더 구체적인 미디어, 디자인 시스템, 프레임워크 자산 절차가 이미 있을 때.
-- 새 이미지를 생성만 하고 저장소에 설치하거나 참조하지 않는 작업일 때.
-<!-- mustflow-section: required-inputs -->
-## 필요한 입력
-- 이미지 파일 경로와 현재 또는 예정된 참조 위치.
-- 예상 표시 크기, 투명도 필요 여부, 애니메이션 필요 여부, 품질 요구 사항.
-- 기존 프레임워크 이미지 규칙, 정적 자산 폴더, 가져오기 방식.
-- `.mustflow/config/commands.toml`의 `asset_optimize` 및 `build` 의도.
-<!-- mustflow-section: preconditions -->
-## 사전 조건
-- 작업이 사용 조건에 맞고 사용하지 않는 경우에는 해당하지 않습니다.
-- 필요한 입력을 확보했거나, 빠진 입력을 추측하지 않고 보고할 수 있습니다.
-- 현재 범위에 대해 더 높은 우선순위의 지침과 `.mustflow/config/commands.toml`을 확인했습니다.
-<!-- mustflow-section: allowed-edits -->
-## 허용 수정 범위
-- 이 스킬, 사용자 요청, `.mustflow/skills/INDEX.md`의 맞는 경로가 설명하는 범위 안에서만 수정합니다.
-- 명령 권한을 넓히거나, 프로젝트 사실을 지어내거나, 관련 없는 워크플로 파일을 변경하지 않습니다.
-<!-- mustflow-section: procedure -->
-## 절차
-1. 변경된 이미지 자산과 그 자산을 참조하는 페이지, 컴포넌트, 스타일, 메타데이터, 매니페스트를 모두 확인합니다.
-2. 자산을 바꾸기 전에 원본 파일 크기, 이미지 크기, 형식, 투명도, 애니메이션 여부를 확인합니다.
-3. 기존 이미지 파이프라인, 프레임워크 이미지 컴포넌트, 설정된 `asset_optimize` 의도가 있으면 그것을 우선 사용합니다.
-4. 사용자가 명시적으로 승인했거나 저장소가 이미 쓰고 있는 경우가 아니라면 새 의존성, 온라인 서비스, 임의 변환 도구를 추가하지 않습니다.
-5. 실제 필요에 맞춰 출력 형식을 고릅니다. 대부분의 사진형 또는 생성형 비트맵 웹 자산은 WebP 또는 AVIF를 우선 검토하고, 무손실 투명도나 정확한 픽셀이 중요하면 PNG를 유지하며, 실제 벡터 아트워크에만 SVG를 사용합니다.
-6. 저장소에 원본과 파생 자산을 분리하는 규칙이 있으면 따릅니다. 그런 규칙이 없다면 이후 편집에 꼭 필요한 경우가 아니면 중복 원본을 추가하지 않습니다.
-7. 지역 스타일에 맞춰 가져오기 구문, 정적 경로, 메타데이터 참조, 치수, 캐시에 민감한 파일 이름을 갱신합니다.
-8. 변경 전후 파일 크기를 비교하고, 품질, 투명도, 애니메이션, 브라우저 지원, 대체 형식 관련 위험을 기록합니다.
-<!-- mustflow-section: postconditions -->
-## 사후 조건
-- 명확한 근거, 실행한 명령 의도, 건너뛴 확인, 남은 위험을 포함해 예상 출력을 작성할 수 있습니다.
-- 빠진 명령 의도, 알 수 없는 입력, 권한 충돌은 숨기지 않고 보고합니다.
-<!-- mustflow-section: verification -->
-## 검증
-가능한 경우 설정된 일회성 명령 의도를 사용합니다.
-- `asset_optimize`
-- `build`
-이미지 최적화 명령을 추측하지 마십시오. `asset_optimize`가 unknown, missing, manual-only 상태이거나 에이전트 실행 가능 상태가 아니라면, 그 상태를 보고하고 설정되지 않은 도구를 실행하지 않은 채 의도한 최적화 내용을 설명합니다.
-<!-- mustflow-section: failure-handling -->
-## 실패 대응
-- 최적화 결과가 눈에 띄게 나빠지거나 투명도가 깨지면 더 나은 자산을 복구하거나 유지하고 그 절충점을 보고합니다.
-- 이미지 참조가 깨지면 해당 참조를 소유한 가장 가까운 가져오기 구문, 경로, 메타데이터, 빌드 설정을 수정합니다.
-- 저장소에 최적화 명령이 없으면 외부 웹사이트나 추측한 패키지 명령을 실행하지 말고, 가장 작은 프로젝트별 명령 의도 추가안을 제안합니다.
-- 자산 변경 뒤 빌드가 실패하면 관련 없는 코드를 만지기 전에 이미지 자산과 관련된 첫 실패를 조사합니다.
-<!-- mustflow-section: output-format -->
-## 출력 형식
-- 검토하거나 변경한 이미지
-- 형식 및 용량 변경
-- 갱신한 참조
-- 실행한 명령 의도
-- 건너뛴 명령 의도와 이유
-- 남은 이미지 품질 또는 브라우저 지원 위험

package/templates/default/locales/zh/.mustflow/skills/INDEX.md DELETED Viewed

@@ -1,74 +0,0 @@
----
-mustflow_doc: skills.index
-locale: zh
-canonical: false
-revision: 45
-authority: router
-lifecycle: mustflow-owned
----
-# 技能索引
-仅参考与当前任务相关的技能文档。如无特定技能适用，请查阅 `AGENTS.md` 和 `.mustflow/config/commands.toml`，以实现最小且安全的变更。
-## 选择规则
-- 任务开始及首次编辑前，比较用户请求和预期变更文件与以下触发条件。
-- 若匹配一个或多个触发条件，需阅读对应的 `SKILL.md`，再进行该范围内的编辑。
-- 使用技能或有意跳过合理技能时，应在下一次面向用户的更新或最终报告中简要说明选择理由。
-- 任务过程中若出现新情况（如命令失败、测试契约变更或文档更新），应暂停操作，先阅读新增匹配的技能文档，再继续。
-- 若无触发条件匹配，不得自行新增技能，继续参考 `AGENTS.md`、`.mustflow/docs/agent-workflow.md` 和 `.mustflow/config/commands.toml`。
-- 技能文档仅指导操作流程，不授权执行声明外的命令。
-- 保持路由表简洁：每条路由应包含触发条件、所需输入、编辑范围、风险评估、验证意图及预期输出。
-| 触发条件 | 技能文档 | 必需输入 | 编辑范围 | 风险 | 验证意图 | 预期输出 |
-| --- | --- | --- | --- | --- | --- | --- |
-| 生成的工件、打包文件、二进制资产、报告或可下载输出被创建、引用或报告 | `.mustflow/skills/artifact-integrity-check/SKILL.md` | 工件路径、源路径或生成路径、打包规则及工件预期 | 工件引用、打包元数据、测试及文档 | 未验证或过期的工件声明 | `changes_status`、`changes_diff_summary`、`test_release`、`build`、`mustflow_check` | 工件证据、包含或格式检查、跳过检查及完整性风险 |
-| 代码变更需在报告前进行审查 | `.mustflow/skills/code-review/SKILL.md` | 差异及任务目标 | 变更文件 | 行为及回归风险 | `test`、`test_related`、`test_audit`、`lint` | 发现结果或无问题说明 |
-| 代码正在重构、重组、重命名、去重、简化或结构性改进，且需保持现有行为不变 | `.mustflow/skills/behavior-preserving-refactor/SKILL.md` | 重构目标、目标区域、行为证据、本地模式、当前变更文件及命令契约条目 | 小规模行为保持重构步骤、相关测试及同步更新的文档或契约 | 隐藏行为变更、大范围清理、误导性抽象、不安全去重或未验证的遗留变更 | `changes_status`、`changes_diff_summary`、`test_related`、`test`、`docs_validate_fast`、`test_release`、`mustflow_check` | 目标、行为证据、结构风险、重构路径、变更内容、排除的行为变更、验证及剩余风险 |
-| 引入、审查或重构类继承、基类、抽象类、模板方法、受保护状态、混入、框架子类或子类型层次，尤其用于行为复用或特性变体 | `.mustflow/skills/composition-over-inheritance/SKILL.md` | 继承范围、复用目标、变更维度、本地组合模式、兼容性约束、当前变更文件及命令契约条目 | 类、函数、角色接口、策略、适配器、装饰器、状态机、测试、包装器及同步更新的文档或模板 | 脆弱的父子耦合、子类爆炸、替换原则破坏、隐藏受保护状态、过度组合或未测试的行为保持重构 | `changes_status`、`changes_diff_summary`、`test_related`、`test`、`lint`、`build`、`docs_validate_fast`、`test_release`、`mustflow_check` | 继承审查、保留或替换决策、变更维度、组合模式、测试、验证及剩余层次风险 |
-| 多个可互换的算法、策略、计算、评分方法、排序方法、推荐方法、定价规则、折扣规则、配送方式、支付方式、通知方式、权限策略、提供者选择、功能开关变体或重复分支，用于选择同类工作的实现方式 | `.mustflow/skills/strategy-pattern/SKILL.md` | 稳定工作流、变体及共享目标、当前分支位置、通用输入输出形态、选择标准、本地结果、依赖注入、装饰器、注册表及测试模式，当前变更文件及命令契约条目 | 策略函数类型、接口、具体策略、选择器、解析器、注册表、装饰器、上下文连接、测试及同步更新的文档或模板 | 过度抽象的小分支、错误的用例分组、上下文暴露具体策略、静默回退、不安全的用户选择策略、有状态请求策略、策略组合爆炸或未测试的选择器行为 | `changes_status`、`changes_diff_summary`、`test_related`、`test`、`lint`、`build`、`docs_validate_fast`、`test_release`、`mustflow_check` | 策略分类、共享契约、策略注册表、选择器或解析器、默认及不支持键行为、测试、验证及剩余策略风险 |
-| 状态变更的用户或系统意图、命令数据对象、命令处理器、命令总线、幂等性、授权、事务、发件箱事件、审计日志、重试、并发、长时任务或外部副作用需具备可追踪的执行单元 | `.mustflow/skills/command-pattern/SKILL.md` | 用户或系统意图、边界来源、负载、执行者及上下文、受影响资源、本地结果、仓库、网关、工作单元、发件箱、幂等、审计、重试及测试模式 | 命令负载、命令上下文、处理器、命令总线连接（如有必要）、幂等、发件箱、审计、重试、事务、控制器或工作适配器、测试及同步更新的文档或模板 | 读取命令仪式、巨型处理器、隐藏领域策略、不安全的重复副作用、事务与外部调用耦合、缺失审计轨迹、无幂等重试或未测试的命令边界 | `changes_status`、`changes_diff_summary`、`test_related`、`test`、`lint`、`build`、`docs_validate_fast`、`test_release`、`mustflow_check` | 命令分类、负载及上下文形态、处理器依赖、领域委托、事务、发件箱、幂等、重试、审计、并发选择、测试、验证及剩余命令安全风险 |
-| 控制器、处理器、命令处理器、工作线程、服务或 UI 事件需要一个稳定的高层入口，用于复杂子系统、多步重复工作流、多重依赖、外部服务、存储、队列、缓存、事务、幂等性、重试、日志记录或规范化结果 | `.mustflow/skills/facade-pattern/SKILL.md` | 调用者接口、高层操作、重复的内部序列、泄露的子系统细节、依赖关系、预期响应和错误、授权、幂等性、重试、事务、可观测性、安全性、性能、本地 Result、端口、适配器、命令和测试模式 | 外观请求、上下文、响应和错误类型，注入的协作者，编排，映射器，错误规范化，幂等性，事务，重试，事件，缓存失效，日志，测试，以及直接同步的文档或模板 | 透传包装器，上帝服务，隐藏的领域策略，公开的内部步骤，SDK 或 ORM 泄漏，外观到外观耦合，有状态请求外观，不安全重试，事务内外部调用，未测试的子系统编排 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 外观分类，调用者简化，请求和上下文结构，规范化结果，注入依赖，委托领域规则，事务/幂等/重试/日志选择，测试，验证及剩余外观风险 |
-| 业务决策、验证、授权、定价、资格判断、状态转换、领域事件、效果描述或计算与数据库、HTTP 处理器、仓库、SDK 调用、文件、队列、日志、指标、时钟、随机数、环境读取、支付、邮件或框架请求/响应对象混杂 | `.mustflow/skills/pure-core-imperative-shell/SKILL.md` | 业务动作、决策事实、副作用、当前边界结构、本地结果/事件/效果模式、行为证据、变更文件和命令契约条目 | 核心决策函数、外壳编排、映射器、结果/错误类型、事件、效果描述、测试及直接同步的文档或模板 | 业务规则隐藏于 I/O，核心非确定性，过度依赖模拟的测试，陈旧决策，重复副作用，事务与外部调用耦合，或过度分层的简单 CRUD | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 决策隔离，明确的核心输入输出，外壳职责，事件或效果，类型化业务失败，测试，验证及剩余混合逻辑风险 |
-| 领域对象具有生命周期状态、状态字段、阶段或步骤字段，允许的操作依赖状态，状态转换分散，外部结果改变状态，可能出现重复事件，或状态变更需要转换表、守卫、效果、历史、幂等性或并发控制 | `.mustflow/skills/state-machine-pattern/SKILL.md` | 实体、状态字段、状态列表、事件列表、终止状态、当前状态变更代码、守卫、上下文事实、效果、历史、幂等性、并发风险、本地 Result 和发件箱模式，以及命令契约条目 | 状态联合类型、事件联合类型、转换表、守卫函数、纯转换函数、调度外壳、发件箱、转换日志、幂等记录、可用操作辅助、测试及直接同步的文档或模板 | 直接状态赋值，隐藏的非法转换，静默无操作，非纯守卫，提交前的外部效果，重复的 webhook 损害，状态爆炸，过时的并发转换，UI/服务器规则漂移，未测试的生命周期 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 生命周期分类，状态与事件，转换表，守卫与上下文事实，效果与历史，幂等性与并发选择，直接赋值清理，测试，验证及剩余状态机风险 |
-| 预期失败、有意义的缺失、null 或 undefined 返回、抛出的业务错误、布尔成功标志、原始字符串错误、仓库查找、验证、解析、外部适配器错误或边界错误映射需要显式的基于值的处理 | `.mustflow/skills/result-option/SKILL.md` | 操作语义、缺失和失败情况、本地 Result/Option/错误约定、层所有权、公共响应规则、敏感数据限制、变更文件和命令契约条目 | Result 和 Option 辅助函数，函数签名，类型化错误，边界映射器，仓库/服务/控制器契约，测试及直接同步的文档或模板 | 隐藏的 null，吞噬错误，抛出的业务失败，模糊的布尔结果，提供者错误泄漏，公共错误形态漂移，或过度包装的全函数 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 返回形态决策，错误码和类别，缺失处理，边界转换，保留抛出路径，测试，验证及剩余异常或 null 风险 |
-| 重复的 null、undefined、None 或 nil 检查，可选依赖，禁用集成，空日志器、空分析器、空缓存，可选通知，无操作协作者，身份处理器或安全中立实现被引入或重构 | `.mustflow/skills/null-object-pattern/SKILL.md` | 可选协作者、接口、缺失语义、调用者分支需求、中立输出、必要副作用、安全、资金、数据和审计风险、组装位置、本地 Result、Option、依赖注入、策略和测试模式 | 接口、空实现、无操作、禁用、身份、空集合、拒绝所有或失败实现，组装连接，非空依赖类型，测试及直接同步的文档或模板 | 隐藏的必需失败，伪成功，授权绕过，持久化丢失，审计跳过，初始化错误吞噬，有状态空对象，调用者仍然可空 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 缺失分类，空对象决策，中立实现，组装选择，可空调用者清理，测试，验证及剩余隐藏失败风险 |
-| 用户需求、验收标准、问题报告、缺陷报告、产品说明、兼容性承诺或示例必须在实现前或过程中保留为回归覆盖 | `.mustflow/skills/requirement-regression-guard/SKILL.md` | 需求来源、可观察行为、现有测试或固件、实现范围、变更文件和命令契约条目 | 针对需求的集中测试、固件、示例、模式、文档及实现变更 | 未测试的需求，虚构的验收标准，弱化的测试，隐藏的行为漂移，无法验证的实现声明 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `test_audit`, `docs_validate_fast`, `test_release`, `mustflow_check` | 需求来源，覆盖映射，新增或复用守卫，实现变更，延期需求，验证及剩余回归风险 |
-| 一个仓库任务计划或使用多个 AI 工作线程、子代理、外部代理、并行任务运行器或基于工作树的工作角色 | `.mustflow/skills/multi-agent-work-coordination/SKILL.md` | 任务目标、工作角色、写权限、文件所有权、工作区隔离、凭证边界、合并负责人和命令契约条目 | 协调方案、工作指令、所有权边界、合并注释及直接同步的测试或文档 | 同文件竞态，冲突指令，凭证泄漏，共享认证缓存，不可信工作输出，合并漂移，未验证的并行结果 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `docs_validate_fast`, `test_release`, `mustflow_check` | 工作线程限制，角色映射，写权限所有权，隔离与凭证边界，合并负责人，验证，跳过检查及剩余协调风险 |
-| 对陌生代码库区域需要基于证据的地图以便规划、实现或报告 | `.mustflow/skills/codebase-orientation/SKILL.md` | 用户请求、目标区域、相关指令及当前源代码、测试、模式、模板、配置或文档文件 | 只读定向笔记及从检查证据中选出的最小后续编辑 | 陈旧文档，错误所有权边界，虚构架构声明 | `changes_status`, `changes_diff_summary`, `mustflow_check` | 检查范围，入口点，流程图，所有权边界，验证选项，风险，未知及最小安全下一步 |
-| 请求仓库改进、审计、优先级排序、稳定性提升、润色、入门、贡献者准备、生产准备或迭代改进，但无单一预定编辑 | `.mustflow/skills/repo-improvement-loop/SKILL.md` | 用户目标、改进模式、仓库证据、候选风险、当前变更文件和命令契约条目 | 仓库诊断，候选排序，最多一个范围限定的改进周期，除非用户明确请求仅分析 | 思路泛滥，无根据的优先级排序，自主循环漂移，广泛重写，未验证的改进声明 | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | 模式，检查证据，评分候选，选定改进，变更文件或仅分析注释，验证，下一改进问题及停止原因 |
-| 密集的计划、建议、代码解释、评审结果、流程图或决策集更适合以安全的静态 HTML 评审工件形式检查 | `.mustflow/skills/visual-review-artifact/SKILL.md` | 用户请求，工件目标，目标受众，源证据，输出路径及相关命令契约条目 | 临时 `.mustflow/state/artifacts/**` 输出或明确请求的版本化 HTML 工件，及直接引用、文档或包元数据 | 不安全的 HTML 行为，提示注入，未验证的工件声明，错误的审批权限 | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | 工件类型和路径，源证据，仅评审边界，本地交互，验证，跳过检查及剩余决策风险 |
-| 变更文件需要风险分类和验证选择 | `.mustflow/skills/diff-risk-review/SKILL.md` | 变更文件列表，差异摘要和任务目标 | 变更表面及验证报告 | 验证不足或过度 | `changes_status`, `changes_diff_summary`, `test`, `test_related`, `test_audit`, `lint`, `build`, `docs_validate`, `mustflow_check` | 风险等级，验证选择，回滚备注 |
-| 声明行为必须在代码、模式、模板、测试和文档间保持一致 | `.mustflow/skills/contract-sync-check/SKILL.md` | 变更文件，预期行为，事实来源，派生表面及命令契约条目 | 合同源及必需同步表面 | 合同漂移 | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | 合同源，同步表面，延期表面，验证及漂移风险 |
-| 日期、版本、计数、时长、限制、指标、基准、价格、百分比或其他数值事实被创建、编辑或报告 | `.mustflow/skills/date-number-audit/SKILL.md` | 日期或数值事实，事实来源，依赖表面，精度预期及命令契约条目 | 数值声明，元数据，测试，文档，模板及报告 | 虚构、陈旧或不匹配的数值声明 | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | 审计值，事实来源，同步表面，跳过检查及剩余数值风险 |
-| Database schema, query, transaction, ORM model, repository/store, index, cache-backed read model, data retention, pagination, concurrency, idempotency, audit log, or persistence boundary is introduced, changed, reviewed, or reported | `.mustflow/skills/database-change-safety/SKILL.md` | Data role, affected tables or stores, read/write path, transaction boundary, migration or rollback expectations, local DB or ORM patterns, changed files, and command contract entries | Schema, migrations, repositories, stores, queries, transactions, indexes, read models, fixtures, tests, docs, and directly synchronized templates | data loss, stale cache, authorization leak, transaction bug, duplicate side effect, slow query, or unverified migration claim | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Data role, schema/query/transaction review, migration and rollback status, index/performance notes, security/retention checks, tests, verification, and remaining database risk |
-| 假设、添加、调用或记录包、运行时、工具、命令、服务或平台能力 | `.mustflow/skills/dependency-reality-check/SKILL.md` | 依赖或能力，仓库声明，版本或能力声明及命令契约条目 | 依赖声明，导入，命令元数据，测试及文档 | 虚构或不可用依赖 | `changes_status`, `changes_diff_summary`, `build`, `test_release`, `mustflow_check` | 依赖状态，同步表面，验证及剩余依赖风险 |
-| 外部系统、协议、SDK、数据库、Webhook、队列、文件、缓存、框架请求或响应、AI 模型、浏览器存储或提供者数据跨越核心边界或需要端口/适配器转换、错误映射、重试、幂等、安全或可观测性处理 | `.mustflow/skills/adapter-boundary/SKILL.md` | 外部系统或协议，入站/出站方向，内部用例，本地端口/适配器模式，提供者风险，变更文件及命令契约条目 | 端口、适配器、映射器、控制器、工作线程、存储、网关、测试、固件、组装连接及直接同步的文档或模板 | 提供者泄漏，透传包装，未分类外部失败，重复副作用，不安全重试，缺失超时，秘密或个人数据泄漏，未测试集成漂移 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 边界分类，内部端口，提供者封装，验证与映射，超时/重试/幂等处理，安全备注，验证及剩余提供者风险 |
-| 核心或应用逻辑创建、导入、解析或隐藏外部依赖，如数据库、SDK、时钟、随机数生成器、配置、日志器、框架对象、文件系统、队列、AI 客户端或支付/邮件提供者 | `.mustflow/skills/dependency-injection/SKILL.md` | 目标代码区域，隐藏依赖，预期业务能力，层所有权，本地端口/适配器模式，变更文件及命令契约条目 | 核心逻辑签名，端口，适配器，组装根，测试及直接同步的文档或模板 | 隐藏全局状态，难测业务逻辑，提供者泄漏，生命周期漂移，服务定位器耦合 | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | 依赖边界，发现直接依赖，注入风格，端口/适配器，组装边界，测试或替身，验证及剩余依赖泄漏 |
-| Git 报告 CRLF/LF 警告或跟踪文本文件可能需要行尾规范化 | `.mustflow/skills/line-ending-hygiene/SKILL.md` | 警告文本或变更文件证据，行尾策略，变更文件状态及命令契约条目 | 行尾策略文件，跟踪文本文件，命令元数据，测试及报告 | 静默工作树重写或策略漂移 | `line_endings_check`, `changes_status`, `mustflow_check` | 策略确认，漂移文件，规范化状态，验证及剩余行尾风险 |
-| 性能预算、包体积、页面大小、启动时间、命令时长、内存使用、资源大小、吞吐量、延迟、基准输出或性能声明被计划、编辑、评审或报告 | `.mustflow/skills/performance-budget-check/SKILL.md` | 性能表面，预算来源，测量方法，环境边界及命令契约条目 | 预算检查，阈值，测量，依赖权衡说明，测试，文档，包元数据及报告 | 虚构预算，陈旧测量，隐藏性能成本，未验证的速度声明 | `changes_status`, `changes_diff_summary`, `build`, `test_related`, `docs_validate_fast`, `test_release`, `mustflow_check` | 性能表面，预算来源，测量边界，同步声明，跳过测量及剩余性能风险 |
-| New tests or test cases are designed, TDD RED or GREEN evidence is reported, or test-case choices are made for requirements, bugs, refactors, security boundaries, schemas, templates, or public docs | `.mustflow/skills/test-design-guard/SKILL.md` | Contract source, existing coverage, intended RED evidence, candidate cases, baseline status, and command contract entries | Tests, fixtures, helpers, and directly synchronized contract docs | invalid RED, happy-path-only coverage, speculative edge cases, weak assertions, mock-only confidence, or implementation-detail coupling | `test_related`, `test_audit`, `test`, `lint`, `build`, `test_release`, `mustflow_check` | RED category, selected test shape, evidence-backed cases, rejected speculation, verification objective, commands, and remaining test-design risk |
-| 测试被添加、更新、删除或审计 | `.mustflow/skills/test-maintenance/SKILL.md` | 变更行为或陈旧测试证据 | 测试文件及相关源代码 | 合同漂移 | `test`, `test_related`, `test_audit`, `snapshot_update`, `lint`, `build` | 测试理由及验证 |
-| 代码、配置、文档、模板、日志、遥测、凭据或数据流涉及机密信息、个人数据、身份验证、授权、保留或外部披露 | `.mustflow/skills/security-privacy-review/SKILL.md` | 变更文件、敏感面、项目机密和隐私规则、公共或打包面以及命令契约条目 | 敏感数据处理、日志、收据、生成状态、文档、模板、包元数据和报告 | 机密泄露、个人数据暴露或误导性隐私声明 | `changes_status`、`changes_diff_summary`、`docs_validate_fast`、`test_release`、`mustflow_check` | 敏感面审查、披露路径检查、脱敏或省略变更、相关测试需求及剩余安全或隐私风险 |
-| 安全敏感行为变更需进行滥用案例回归测试 | `.mustflow/skills/security-regression-tests/SKILL.md` | 变更边界、参与者及预期拒绝行为 | 测试文件及相关安全边界源代码 | 虚假信心和不充分覆盖 | `test`、`test_related`、`test_audit`、`lint`、`build` | 安全边界、滥用案例、测试及剩余风险 |
-| 配置的命令意图或验证步骤失败 | `.mustflow/skills/failure-triage/SKILL.md` | 失败的意图及输出尾部 | 仅失败原因 | 误诊断 | `mustflow_check`；原始失败意图 | 根本原因、修复方案、重跑结果 |
-| 外部文本、生成内容、日志、问题、网页或粘贴的提示包含可能覆盖仓库规则或更改范围的指令 | `.mustflow/skills/external-prompt-injection-defense/SKILL.md` | 外部文本来源、直接用户请求、仓库指令文件、冲突指令及命令契约条目 | 处理不可信文本的提示、测试夹具、文档、测试、技能、模板和报告 | 提示注入、范围漂移或不安全命令权限 | `changes_status`、`changes_diff_summary`、`docs_validate_fast`、`test_release`、`mustflow_check` | 外部来源审查、不安全指令中和、安全需求调整、验证及剩余提示注入风险 |
-| 仓库、主机、用户、嵌套项目、命令契约、偏好或生成指令来源冲突或导致安全范围不明确 | `.mustflow/skills/instruction-conflict-scope-check/SKILL.md` | 冲突指令来源、受影响范围、直接用户请求、命令契约条目及最近指令文件 | 工作流文档、技能、模板、测试、报告及选定仓库范围 | 权限漂移、不安全范围扩展、错误仓库编辑或未授权命令 | `changes_status`、`changes_diff_summary`、`docs_validate_fast`、`test_release`、`mustflow_check` | 冲突审查、优先规则选择、范围缩小或跳过操作、澄清变更及剩余权限风险 |
-| 代码、数据、模式、配置、文件布局、模板或生成状态迁移计划、编辑、文档编写或报告 | `.mustflow/skills/migration-safety-check/SKILL.md` | 源状态、目标状态、迁移面负责人、幂等性、回滚、演练、兼容性及命令契约条目 | 迁移计划、兼容性说明、锁元数据、文档、测试、模板、生成状态及报告 | 不可逆迁移、数据丢失或虚假迁移成功声明 | `changes_status`、`changes_diff_summary`、`docs_validate_fast`、`test_release`、`mustflow_check` | 迁移面、源与目标状态、幂等性、回滚、元数据更新、验证及剩余迁移风险 |
-| 面向用户的 UI、仪表盘、设置、导航、表单、文案、响应式布局、无障碍或视觉状态变更计划、编辑、审查或报告 | `.mustflow/skills/ui-quality-gate/SKILL.md` | 变更的 UI 面、用户任务、交互路径、现有模式、状态组合、本地化规则及命令契约条目 | UI 控件、标签、状态、布局约束、无障碍属性、本地化钩子、文档、模板及报告 | 装饰性 UI 漂移、控件不可访问、布局破坏或未经验证的视觉声明 | `changes_status`、`changes_diff_summary`、`docs_validate_fast`、`test_release`、`mustflow_check` | UI 面审查、状态检查、布局/无障碍/本地化说明、跳过视觉检查及剩余 UI 风险 |
-| 在不熟悉领域实施需先有本地先例再引入新结构 | `.mustflow/skills/pattern-scout/SKILL.md` | 用户请求、目标文件区域、附近示例及当前变更文件 | 模式证据及需遵循的文件 | 自创平行结构 | `changes_status`、`changes_diff_summary`、`mustflow_check` | 本地模式、应用对齐、刻意偏离及验证 |
-| 新功能、模块、文件夹布局、架构、脚手架、重构、路由、数据模型或外部服务集成可能需在编码前做隐含结构决策 | `.mustflow/skills/structure-discovery-gate/SKILL.md` | 用户请求、预期能力、隐含假设、指定技术或服务及相关本地模式 | 问题、假设、建议文件边界及最小实现方案 | 脆弱结构、厂商名称泄露、过度质疑或推测性抽象 | `changes_status`、`changes_diff_summary`、`docs_validate_fast`、`test_release`、`mustflow_check` | 阻塞问题、假设、建议文件及职责、依赖方向、本地模式、验证及剩余结构风险 |
-| 需在最小复现明确前修复错误或混淆失败 | `.mustflow/skills/repro-first-debug/SKILL.md` | 症状、预期行为、观察输出及可能变更文件 | 复现说明、聚焦测试及可能原因 | 推测性修复或过度测试 | `test_related`、`test_fast`、`mustflow_check` | 复现证据、最小修复、验证及剩余风险 |
-| 声明依赖当前、外部、过时、版本化或其他易漂移来源 | `.mustflow/skills/source-freshness-check/SKILL.md` | 过时敏感声明、来源文本或页面、日期或版本上下文及来源策略 | 来源措辞、文档及新鲜度报告 | 过时或不可验证声明 | `changes_status`、`docs_validate_fast`、`mustflow_check` | 检查来源边界、措辞变更、跳过刷新及过时来源风险 |
-| `.mustflow/context/PROJECT.md` 需谨慎的项目上下文 | `.mustflow/skills/project-context-authoring/SKILL.md` | 支持的项目事实 | `.mustflow/context/PROJECT.md` | 权限漂移 | `mustflow_check` | 更新谨慎上下文 |
-| 技能流程或路由被创建或维护 | `.mustflow/skills/skill-authoring/SKILL.md` | 重复任务证据 | `.mustflow/skills/**` | 重叠及命令漂移 | `mustflow_check`、`docs_validate` | 技能路由及流程变更 |
-| `README.md` 被创建、重构或大幅重写 | `.mustflow/skills/readme-authoring/SKILL.md` | 用户请求、现有 README（如有）、仓库证据、最近指令及命令契约 | `README.md` 及直接关联的公共文档 | 虚构项目声明、营销漂移或丢失人工意图 | `docs_validate_fast`、`mustflow_check` | 基于证据的 README 变更，保留或延后章节，验证说明 |
-| 文档审查队列条目需润色 | `.mustflow/skills/docs-prose-review/SKILL.md` | 审查队列条目或选中文档路径、审查意见（如有）、目标语言、审查者元数据 | 选定文档文件及审查记录 | 含义漂移或过时队列状态 | `docs_validate`、`mustflow_check` | 文案变更、记录审查状态、验证说明 |
-| 网络图片资源被添加、转换、调整大小或替换 | `.mustflow/skills/web-asset-optimization/SKILL.md` | 图片资源请求及目标路径 | 网络图片资源 | 资源质量及大小 | `asset_optimize`、`build` | 优化资源说明 |
-| 文档变更影响公共或工作流文档 | `.mustflow/skills/docs-update/SKILL.md` | 变更行为或字段 | 相关文档 | 过时公共文档 | `docs_validate_fast`、`docs_validate`、`mustflow_check` | 文档变更及跳过检查说明 |
-引入新技能时，请在此处链接并定义具体的触发器和路由字段。
-避免在技能文档中直接包含原始 shell 命令，建议引用 `.mustflow/config/commands.toml` 中定义的命令意图名称。