specdo 1.0.2

package/dist/domains/operations.js

@@ -0,0 +1,344 @@
+/**
+ * Operations Domain Module
+ *
+ * 来源:
+ *   - content/skills/release-management/SKILL.md (49 行)
+ *     发布工作流、release notes、freeze gate、guardrails
+ *   - content/skills/git-commit-and-pr/SKILL.md (46 行)
+ *     提交边界、commit message、PR body checklist
+ *   - content/skills/documentation-writer/SKILL.md (47 行)
+ *     README 默认结构、写作规则、guardrails
+ *   - content/skills/dependency-upgrade/SKILL.md (45 行)
+ *     依赖升级分级 (patch/minor/major)、影响面、验证
+ *   - content/skills/monorepo-management/SKILL.md (72 行)
+ *     工具矩阵 (turbo/nx/pnpm/lerna/bazel)、构建编排、发布
+ *   - content/roles/06-developer-experience/devops-engineer.toml (43 行)
+ *     CI/CD 管线、容器、IaC、监控、SRE 原则
+ *   - content/roles/06-developer-experience/documentation-engineer.toml (42 行)
+ *     文档作为开发者生产力工程；与代码同步、可执行示例
+ *
+ * 压缩方法:
+ *   1. 7 个源文件的 "Use this skill when" 触发场景 → explore.signals
+ *   2. release freeze gate + PR checklist + README checklist → design.checklist
+ *   3. monorepo 工具矩阵 → design.patterns
+ *   4. devops-engineer principles + dependency-upgrade core workflow → implement.focusAreas
+ *   5. 7 个源文件的 guardrails → implement.antiPatterns
+ *   6. release notes checklist + monorepo health checks → verify.checklist
+ *   7. 原始示例代码 / dockerfile 模板 / 工具脚本 → 丢弃
+ *
+ * 与相邻领域的边界:
+ *   - "rollback" / "release" / "deploy" / "ci" 归 operations
+ *   - "database migration rollback" 归 backend；operations 只覆盖发布层 rollback
+ *   - "monitoring" 通用监控归 operations；backend 关注 metrics 端点实现
+ *   - "breaking change" 在 architecture 用于契约层；operations 用 "release breaking change" 多词
+ */
+export const operationsDomain = {
+    name: 'operations',
+    description: 'Release engineering, CI/CD, deployment automation, dependency upgrades, monorepo workflows, and documentation engineering',
+    // ── Explore: 需求澄清 ─────────────────────────────────────
+    explore: {
+        signals: [
+            // 发布与版本
+            'release', 'release notes', 'changelog', 'version bump', 'semver',
+            'freeze', 'cut a release', 'tag a version', 'publish',
+            // Git / PR
+            'commit', 'pull request', 'merge request', 'rebase', 'branch strategy',
+            'conventional commits', 'pr description', 'pr template',
+            // 部署与基础设施
+            'deploy', 'deployment', 'rollout', 'rollback', 'hotfix', 'canary',
+            'pipeline', 'ci pipeline', 'cd pipeline', 'build pipeline',
+            'dockerfile', 'kubernetes', 'k8s', 'helm chart', 'terraform',
+            'pulumi', 'cloudformation', 'iac', 'infrastructure as code',
+            // 监控与运维
+            'monitoring', 'observability', 'alerting', 'dashboard', 'runbook',
+            'slo', 'sli', 'error budget',
+            // 依赖与 monorepo
+            'dependency upgrade', 'dependency bump', 'lockfile', 'peer dependency',
+            'monorepo', 'turborepo', 'nx workspace', 'pnpm workspace', 'lerna', 'bazel',
+            // 文档
+            'readme', 'documentation', 'migration guide', 'onboarding doc',
+            'release breaking change',
+        ],
+        questions: {
+            defaultCount: 8,
+            items: [
+                // ── Tier 1: 发布范围与目标 (priority 10) ──────────────
+                {
+                    text: 'What is the blast radius of this change? Single service, monorepo, or every consumer of a public artefact (npm package, Docker image, API)?',
+                    signals: ['deploy', 'release', 'blast radius', 'service', 'monorepo', 'package', 'docker', 'public', 'artifact'],
+                    priority: 10,
+                },
+                {
+                    text: 'What is the deployment target? (Kubernetes, serverless/lambda, VM, container registry, static hosting) — what are the existing pipeline stages?',
+                    signals: ['deploy', 'kubernetes', 'k8s', 'serverless', 'lambda', 'vm', 'container', 'docker', 'pipeline', 'ci/cd'],
+                    priority: 10,
+                },
+                // ── Tier 2: 回滚与安全发布 (priority 9) ──────────────
+                {
+                    text: 'What is the rollback strategy if this fails in production? Has it been smoke-tested? How fast can we roll back (seconds vs minutes vs hours)?',
+                    id: 'rollback-strategy',
+                    signals: ['rollback', 'deploy', 'failure', 'production', 'smoke', 'revert', 'recovery', 'incident'],
+                    priority: 9,
+                },
+                {
+                    text: 'Is this a canary, blue-green, or rolling deployment? What is the rollback trigger (error rate spike, latency degradation, custom metric)?',
+                    signals: ['canary', 'blue-green', 'rolling', 'deploy', 'strategy', 'rollback', 'trigger', 'metric', 'monitoring'],
+                    priority: 8,
+                    requiresAnswer: ['operations:rollback-strategy'],
+                },
+                // ── Tier 3: CI/CD 管道 (priority 8) ──────────────────
+                {
+                    text: 'What CI checks gate the release? Which are blocking vs advisory, and how do we record skipped checks with rationale?',
+                    signals: ['ci/cd', 'ci', 'pipeline', 'gate', 'check', 'block', 'advisory', 'skip', 'validation'],
+                    priority: 8,
+                },
+                {
+                    text: 'For monorepo work: which packages are affected? Is the affected-only test/build path correct in CI (no unnecessary rebuilds)?',
+                    signals: ['monorepo', 'package', 'ci', 'build', 'test', 'affected', 'nx', 'turborepo', 'lerna'],
+                    priority: 8,
+                },
+                {
+                    text: 'What is the build artifact strategy? (immutable tags, checksum verification, SBOM generation, provenance attestation)',
+                    signals: ['build', 'artifact', 'docker', 'image', 'checksum', 'sbom', 'provenance', 'immutable', 'tag'],
+                    priority: 7,
+                },
+                // ── Tier 4: 依赖管理 (priority 7-8) ───────────────────
+                {
+                    text: 'For dependency upgrades: is this patch, minor, or major? What is the contract risk classification? Is there a changelog review?',
+                    signals: ['dependency', 'upgrade', 'patch', 'minor', 'major', 'semver', 'contract', 'risk', 'changelog'],
+                    priority: 8,
+                },
+                {
+                    text: 'Are all production dependencies pinned to exact versions? Is there a lockfile integrity check in CI?',
+                    signals: ['dependency', 'pin', 'lockfile', 'version', 'integrity', 'ci', 'supply chain', 'npm', 'pip'],
+                    priority: 7,
+                },
+                {
+                    text: 'What is the vulnerability scanning strategy for dependencies? (npm audit, Snyk, Trivy) — does CI block on CRITICAL?',
+                    signals: ['dependency', 'vulnerability', 'cve', 'npm audit', 'snyk', 'trivy', 'scan', 'ci', 'supply chain'],
+                    priority: 7,
+                },
+                // ── Tier 5: 环境管理 (priority 7) ────────────────────
+                {
+                    text: 'What environments does this change flow through? (dev → staging → canary → production) Are environments consistent (infra-as-code)?',
+                    signals: ['environment', 'dev', 'staging', 'canary', 'production', 'infra', 'terraform', 'pulumi', 'iac'],
+                    priority: 7,
+                },
+                {
+                    text: 'How are environment variables and secrets managed per environment? (vault, KMS, CI secrets, .env files — are they encrypted at rest?)',
+                    signals: ['environment', 'secret', 'env', 'variable', 'vault', 'kms', 'ci', 'configuration'],
+                    priority: 7,
+                },
+                {
+                    text: 'Is there a staging/production parity gap? What differs between staging and production (data, scale, configuration, third-party integration)?',
+                    signals: ['staging', 'production', 'parity', 'environment', 'data', 'scale', 'configuration', 'integration'],
+                    priority: 6,
+                },
+                // ── Tier 6: 可观测性 (priority 7-8) ──────────────────
+                {
+                    text: 'What observability is in place for this change? (dashboards, alerts, SLOs, error budgets — are they defined before deploy?)',
+                    id: 'observability',
+                    signals: ['observability', 'monitoring', 'dashboard', 'alert', 'slo', 'error budget', 'grafana', 'datadog', 'prometheus'],
+                    priority: 8,
+                },
+                {
+                    text: 'How do we know the deploy was successful? What metric or health check confirms "this change is working as expected"?',
+                    signals: ['deploy', 'verification', 'health check', 'metric', 'monitoring', 'success', 'smoke', 'validation'],
+                    priority: 8,
+                    requiresAnswer: ['operations:observability'],
+                },
+                {
+                    text: 'What is the logging strategy in production? (structured JSON, log levels, retention period, PII redaction, log aggregation tool)',
+                    signals: ['logging', 'log', 'production', 'structured', 'json', 'retention', 'pii', 'elk', 'loki', 'splunk'],
+                    priority: 7,
+                },
+                // ── Tier 7: 事件响应 (priority 6-7) ──────────────────
+                {
+                    text: 'What is the incident response playbook for this change? Who is on-call, what is the escalation path, where are runbooks?',
+                    signals: ['incident', 'on-call', 'escalation', 'runbook', 'pagerduty', 'opsgenie', 'alert', 'response'],
+                    priority: 7,
+                },
+                {
+                    text: 'What manual steps remain in the release process today, and which can we eliminate this iteration? Is there a runbook for remaining manual steps?',
+                    signals: ['release', 'manual', 'runbook', 'automation', 'process', 'checklist', 'operation'],
+                    priority: 7,
+                },
+                // ── Tier 8: 下游通信 (priority 6-7) ──────────────────
+                {
+                    text: 'Who are the downstream adopters that need a migration guide or upgrade notes? When do they get notified (before or at release)?',
+                    signals: ['downstream', 'adopter', 'migration', 'upgrade', 'notification', 'changelog', 'consumer', 'breaking change'],
+                    priority: 7,
+                },
+                {
+                    text: 'What is the deprecation policy for removed or changed functionality? Is there a sunset period with warnings before removal?',
+                    signals: ['deprecation', 'removal', 'sunset', 'warning', 'migration', 'backward compatibility', 'breaking change'],
+                    priority: 6,
+                },
+                // ── Tier 9: 基础设施 (priority 6) ────────────────────
+                {
+                    text: 'What infrastructure changes are needed? (new DB instance, queue, cache cluster, DNS, load balancer, firewall rule) — is it provisioned via IaC?',
+                    signals: ['infra', 'infrastructure', 'terraform', 'pulumi', 'cloudformation', 'database', 'cache', 'dns', 'load balancer', 'firewall'],
+                    priority: 7,
+                },
+                {
+                    text: 'What is the resource sizing/capacity plan? (CPU, memory, disk, network — request vs limit; horizontal vs vertical scaling)',
+                    signals: ['resource', 'capacity', 'cpu', 'memory', 'disk', 'network', 'scaling', 'sizing', 'request', 'limit'],
+                    priority: 6,
+                },
+                {
+                    text: 'How are database migrations run in production? (manual, automated in CI/CD, approval-gated — what is the rollback if migration fails?)',
+                    signals: ['database', 'migration', 'production', 'ci/cd', 'rollback', 'ddl', 'schema', 'automation'],
+                    priority: 6,
+                },
+                // ── Tier 10: 安全运维 (priority 6-7) ─────────────────
+                {
+                    text: 'What is the security review process before production deploy? Is there a pre-flight security checklist (secrets rotation, dependency audit, CSP update)?',
+                    signals: ['security', 'deploy', 'review', 'checklist', 'production', 'audit', 'csp'],
+                    priority: 6,
+                },
+                {
+                    text: 'What is the backup and disaster recovery plan for data affected by this change? Is backup tested regularly?',
+                    signals: ['backup', 'disaster recovery', 'dr', 'data', 'restore', 'rpo', 'rto', 'snapshot'],
+                    priority: 6,
+                },
+                {
+                    text: 'Are there rate limits or abuse protections at the infrastructure level? (WAF rules, DDoS protection, API gateway throttling)',
+                    signals: ['rate limit', 'waf', 'ddos', 'api gateway', 'throttle', 'abuse', 'infrastructure', 'protection'],
+                    priority: 6,
+                },
+                // ── Tier 11: 成本与 FinOps (priority 5-6) ─────────────
+                {
+                    text: 'What is the estimated cost impact of this change? (additional compute, storage, bandwidth, third-party API calls)',
+                    signals: ['cost', 'finops', 'compute', 'storage', 'bandwidth', 'budget', 'cloud', 'aws', 'gcp', 'azure'],
+                    priority: 5,
+                },
+                {
+                    text: 'Are there any resource cleanup or decommissioning steps for deprecated services/endpoints after this deploy?',
+                    signals: ['cleanup', 'decommission', 'deprecated', 'remove', 'delete', 'resource', 'cost'],
+                    priority: 5,
+                },
+            ],
+        },
+    },
+    // ── Design: 设计阶段 ─────────────────────────────────────
+    design: {
+        checklist: [
+            // 发布门 (release freeze gate)
+            'Release scope is explicit: what is in this release and what is intentionally not',
+            'Code, docs, and examples are aligned on the public surface — no doc drift',
+            'Required validations have actually run; skipped validations are listed explicitly with reason',
+            'Release notes drafted with user-visible impact, not internal phrasing',
+            'Upgrade and rollback path documented; no hidden manual steps required for adopters',
+            // PR / 提交质量
+            'Commit boundaries reflect coherent changes, not file-count or chronology',
+            'Mechanical churn is separated from behavioral change where practical',
+            'PR description answers: what changed, why it changed, how it was verified, what risks remain, what was intentionally left out',
+            // 依赖升级
+            'Dependency upgrade classified (patch / minor / major) with explicit contract-risk note',
+            'Upstream release notes / migration guides reviewed before any code change',
+            'Validation plan defined before the upgrade, not improvised after the build breaks',
+            // Monorepo / 构建编排
+            'Workspace boundaries and naming are stable; new packages follow existing convention',
+            'Build pipeline order respects the dependency graph; affected-only tasks are correct in CI',
+            'Caching strategy declared (Turborepo / Nx / remote cache) with a target hit rate',
+            // 部署 / 基础设施
+            'Pipeline stages are idempotent and re-triggerable safely',
+            'Infrastructure changes are reproducible from code (no manual console edits)',
+            'Resource limits and requests specified for every container; no implicit defaults',
+            'Monitoring covers both infrastructure and application-level health, not just one layer',
+            // 文档
+            'README / migration guide passes the "new visitor in 30 seconds" check; required vs optional setup is unambiguous',
+        ],
+        patterns: {
+            'Modular Monorepo with Turborepo / Nx': 'Use a workspace tool with task graph + remote cache for JS/TS monorepos. Define one canonical build/test/lint task per package; CI runs only affected packages.',
+            'pnpm Workspaces for Strict Dependencies': 'When dependency hygiene matters, pnpm workspaces enforce strict resolution and avoid phantom dependencies. Pair with workspace:* protocol for internal packages.',
+            'Conventional Commits + Automated Versioning': 'Adopt Conventional Commits (feat/fix/chore/...) so changelog, semver bump, and release notes can be generated automatically. Commit hook enforces format at the boundary.',
+            'Trunk-Based with Short-Lived Release Branches': 'Mainline development on trunk; cut a release branch only at freeze. Hotfixes target the release branch and are forward-merged to trunk.',
+            'Multi-Stage Dockerfile + Reproducible Image': 'Build stage compiles and tests; runtime stage copies only required artefacts. Pin base image digest; declare resource limits in the orchestration manifest.',
+            'IaC with Plan / Apply Discipline': 'All infra changes go through plan → review → apply (Terraform / Pulumi / CloudFormation). State is remote and locked; drift detection runs on schedule.',
+        },
+        antiPatterns: [
+            'Releasing on the assumption that an unrun check would have passed — assume nothing you did not actually verify',
+            'Hiding breaking changes inside minor wording in release notes — adopters lose the ability to plan migrations',
+            'Bundling unrelated refactors into the same PR for "convenience" — review quality drops, blast radius widens',
+            'Committing "fix stuff" / "update files" / similarly empty messages — the audit trail becomes useless within months',
+            'Mass-upgrading multiple high-risk dependencies without a rollback strategy — every regression becomes ambiguous to attribute',
+            'Manual console changes to production infrastructure — kills reproducibility and creates undetectable drift',
+            'Treating "works on my machine" as a valid quick-start in the README — every new contributor pays the same setup tax',
+            'Storing secrets in pipeline YAML, env files committed to git, or build logs — one commit becomes a credential leak',
+        ],
+    },
+    // ── Implement: 实施阶段 ──────────────────────────────────
+    implement: {
+        focusAreas: [
+            // 提交 / PR 规范
+            'Commit message states the change, not just the area touched; subject is imperative and < 72 chars',
+            'PR includes validation evidence (commands run, output, screenshots if UI) and explicit risk notes',
+            'Mechanical churn (formatting, lint fixes, mass renames) lands in its own commit before behavioral change',
+            // 依赖升级
+            'Upgrade scope mapped: APIs, config, build, runtime behavior, tests are listed before any version bump',
+            'Lockfile churn reviewed deliberately — large unexpected diffs investigated, not waved through',
+            'Plugin / peer dependency alignment verified after upgrade; no silent peer-dep mismatches',
+            // CI/CD 管线
+            'Pipeline stages cache aggressively (node_modules, build outputs, docker layers) and use affected-only execution',
+            'Pipeline failure modes produce actionable logs — no "exit code 1" without context',
+            'Secrets resolved at runtime from a managed store (Vault, AWS Secrets Manager, GitHub OIDC) — never embedded in YAML or images',
+            // 容器 / 编排
+            'Dockerfile uses multi-stage build; runtime image contains only required artefacts; image is pinned by digest',
+            'Kubernetes manifests / Helm values declare resource requests, limits, liveness, readiness, and PodDisruptionBudget',
+            'Health checks distinguish liveness (process alive) from readiness (ready to receive traffic)',
+            // 监控 / 运维
+            'Alerts target SLO violations, not infrastructure CPU; every alert has a runbook entry',
+            'Dashboards cover the four golden signals (latency, traffic, errors, saturation) per service',
+            // 文档
+            'Docs are validated against current commands and file paths; copy-paste examples actually run on a clean checkout',
+            'Migration guides include the failure mode users hit when they skip the steps, not just the steps themselves',
+        ],
+        patterns: {
+            'Affected-Only CI': 'Compute the changed package set from `git diff` against the merge base; run lint/test/build only for affected packages and their dependents. Cuts CI time linearly with monorepo size.',
+            'Idempotent Release Pipeline': 'Every pipeline stage can be re-run safely. Tag/version creation is conditional on artefact non-existence; publish step is at-most-once via idempotency key on the registry.',
+            'Pinned Lockfile + Renovate Schedule': 'Lock dependencies exactly (no ^ or ~ for production); use Renovate / Dependabot to open scheduled PRs. Each upgrade PR gets its own validation cycle.',
+            'Runbook-Linked Alert': 'Every alert payload contains a runbook URL with: detection criteria, immediate actions, escalation path. On-call never debugs an alert without docs.',
+            'Documentation as Code': 'Docs live in the same repo as the code, follow the same review process, and are validated by CI (link check, example execution where feasible).',
+        },
+        antiPatterns: [
+            'Claiming tests passed without actually running them — every later regression becomes a trust problem',
+            'Committing secrets, local config, caches, or temporary artefacts — once on remote, treat as compromised',
+            'Disabling a flaky test in CI without filing the follow-up issue — flakiness compounds silently',
+            'Writing release notes as "various improvements" — adopters cannot decide whether to upgrade',
+            'Mass-renames or mass-formatting in the same commit as logic changes — reviewers lose the ability to spot regressions',
+            'Relying on type checks alone for runtime-heavy upgrades (DB driver, HTTP client, queue lib) — runtime smoke is required',
+            'Pinning to "latest" tag for container base images or CI runners — builds become non-reproducible week to week',
+        ],
+    },
+    // ── Verify: 验证阶段 ─────────────────────────────────────
+    verify: {
+        checklist: [
+            // 发布 freeze gate
+            'Release notes include: headline changes, breaking/behavioral changes, migration actions, compatibility caveats, known limits',
+            'Code, docs, examples agree on the public surface; required validations actually ran',
+            'Skipped validations are listed explicitly in the release record',
+            'Upgrade and rollback path are present and have been smoke-tested at least once',
+            // CI / 管线
+            'Pipeline runs are idempotent; re-triggering on the same commit produces the same artefact',
+            'Build cache hit rate is observable and within expected band (≥ 80% for steady-state CI)',
+            'CI runs only affected package tasks on PRs in the monorepo',
+            // Monorepo 健康
+            'No circular dependencies between internal packages',
+            'All internal dependencies use the workspace protocol (workspace:*) — no version drift',
+            'Package boundaries enforced — no deep imports across packages',
+            'Tooling versions (Node, pnpm, TypeScript, eslint) are consistent across the workspace',
+            // 部署 / 基础设施
+            'Resource requests and limits specified for every container in production manifests',
+            'Rollback path is documented and verified, not just hypothesised',
+            'Secrets never appear in pipeline logs, build artefacts, or committed files',
+            // 监控
+            'Alerts are linked to runbooks; on-call has run through the top-3 alerts at least once',
+            'Monitoring covers both infrastructure layer and application-level health',
+            // 文档
+            'A new contributor can complete the documented quick-start path on a clean machine',
+            'Required vs optional setup is explicit; prerequisites appear before usage examples',
+        ],
+    },
+};
+//# sourceMappingURL=operations.js.map

package/dist/domains/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/domains/operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,2HAA2H;IAE7H,yDAAyD;IAEzD,OAAO,EAAE;QACP,OAAO,EAAE;YACP,QAAQ;YACR,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ;YACjE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS;YACrD,WAAW;YACX,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB;YACtE,sBAAsB,EAAE,gBAAgB,EAAE,aAAa;YACvD,UAAU;YACV,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ;YACjE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB;YAC1D,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW;YAC5D,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,wBAAwB;YAC3D,QAAQ;YACR,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS;YACjE,KAAK,EAAE,KAAK,EAAE,cAAc;YAC5B,eAAe;YACf,oBAAoB,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB;YACtE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO;YAC3E,KAAK;YACL,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB;YAC9D,yBAAyB;SAC1B;QAED,SAAS,EAAE;YACT,YAAY,EAAE,CAAC;YACf,KAAK,EAAE;gBACL,kDAAkD;gBAClD;oBACE,IAAI,EAAE,6IAA6I;oBACnJ,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;oBAChH,QAAQ,EAAE,EAAE;iBACb;gBACD;oBACE,IAAI,EAAE,iJAAiJ;oBACvJ,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;oBAClH,QAAQ,EAAE,EAAE;iBACb;gBAED,iDAAiD;gBACjD;oBACE,IAAI,EAAE,+IAA+I;oBACrJ,EAAE,EAAE,mBAAmB;oBACvB,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;oBACnG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,2IAA2I;oBACjJ,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;oBACjH,QAAQ,EAAE,CAAC;oBACX,cAAc,EAAE,CAAC,8BAA8B,CAAC;iBACjD;gBAED,sDAAsD;gBACtD;oBACE,IAAI,EAAE,sHAAsH;oBAC5H,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC;oBAChG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,+HAA+H;oBACrI,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC;oBAC/F,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,uHAAuH;oBAC7H,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC;oBACvG,QAAQ,EAAE,CAAC;iBACZ;gBAED,qDAAqD;gBACrD;oBACE,IAAI,EAAE,iIAAiI;oBACvI,OAAO,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC;oBACxG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,sGAAsG;oBAC5G,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC;oBACtG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,qHAAqH;oBAC3H,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC;oBAC3G,QAAQ,EAAE,CAAC;iBACZ;gBAED,oDAAoD;gBACpD;oBACE,IAAI,EAAE,qIAAqI;oBAC3I,OAAO,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC;oBACzG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,uIAAuI;oBAC7I,OAAO,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC;oBAC5F,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,8IAA8I;oBACpJ,OAAO,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,CAAC;oBAC5G,QAAQ,EAAE,CAAC;iBACZ;gBAED,oDAAoD;gBACpD;oBACE,IAAI,EAAE,6HAA6H;oBACnI,EAAE,EAAE,eAAe;oBACnB,OAAO,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC;oBACzH,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,sHAAsH;oBAC5H,OAAO,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC;oBAC7G,QAAQ,EAAE,CAAC;oBACX,cAAc,EAAE,CAAC,0BAA0B,CAAC;iBAC7C;gBACD;oBACE,IAAI,EAAE,kIAAkI;oBACxI,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC;oBAC5G,QAAQ,EAAE,CAAC;iBACZ;gBAED,oDAAoD;gBACpD;oBACE,IAAI,EAAE,0HAA0H;oBAChI,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC;oBACvG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,kJAAkJ;oBACxJ,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;oBAC5F,QAAQ,EAAE,CAAC;iBACZ;gBAED,oDAAoD;gBACpD;oBACE,IAAI,EAAE,iIAAiI;oBACvI,OAAO,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,CAAC;oBACtH,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,6HAA6H;oBACnI,OAAO,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE,iBAAiB,CAAC;oBAClH,QAAQ,EAAE,CAAC;iBACZ;gBAED,oDAAoD;gBACpD;oBACE,IAAI,EAAE,iJAAiJ;oBACvJ,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC;oBACtI,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,4HAA4H;oBAClI,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;oBAC9G,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,wIAAwI;oBAC9I,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC;oBACpG,QAAQ,EAAE,CAAC;iBACZ;gBAED,oDAAoD;gBACpD;oBACE,IAAI,EAAE,0JAA0J;oBAChK,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC;oBACpF,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,6GAA6G;oBACnH,OAAO,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC;oBAC3F,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,8HAA8H;oBACpI,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,YAAY,CAAC;oBAC1G,QAAQ,EAAE,CAAC;iBACZ;gBAED,sDAAsD;gBACtD;oBACE,IAAI,EAAE,mHAAmH;oBACzH,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC;oBACxG,QAAQ,EAAE,CAAC;iBACZ;gBACD;oBACE,IAAI,EAAE,8GAA8G;oBACpH,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;oBAC1F,QAAQ,EAAE,CAAC;iBACZ;aACF;SACF;KACF;IAED,wDAAwD;IAExD,MAAM,EAAE;QACN,SAAS,EAAE;YACT,4BAA4B;YAC5B,kFAAkF;YAClF,2EAA2E;YAC3E,+FAA+F;YAC/F,uEAAuE;YACvE,oFAAoF;YACpF,YAAY;YACZ,0EAA0E;YAC1E,sEAAsE;YACtE,+HAA+H;YAC/H,OAAO;YACP,wFAAwF;YACxF,2EAA2E;YAC3E,mFAAmF;YACnF,kBAAkB;YAClB,qFAAqF;YACrF,2FAA2F;YAC3F,kFAAkF;YAClF,YAAY;YACZ,0DAA0D;YAC1D,6EAA6E;YAC7E,kFAAkF;YAClF,wFAAwF;YACxF,KAAK;YACL,kHAAkH;SACnH;QAED,QAAQ,EAAE;YACR,sCAAsC,EACpC,iKAAiK;YACnK,yCAAyC,EACvC,kKAAkK;YACpK,6CAA6C,EAC3C,2KAA2K;YAC7K,+CAA+C,EAC7C,yIAAyI;YAC3I,6CAA6C,EAC3C,6JAA6J;YAC/J,kCAAkC,EAChC,yJAAyJ;SAC5J;QAED,YAAY,EAAE;YACZ,gHAAgH;YAChH,8GAA8G;YAC9G,6GAA6G;YAC7G,oHAAoH;YACpH,8HAA8H;YAC9H,4GAA4G;YAC5G,qHAAqH;YACrH,oHAAoH;SACrH;KACF;IAED,wDAAwD;IAExD,SAAS,EAAE;QACT,UAAU,EAAE;YACV,aAAa;YACb,mGAAmG;YACnG,mGAAmG;YACnG,0GAA0G;YAC1G,OAAO;YACP,uGAAuG;YACvG,+FAA+F;YAC/F,0FAA0F;YAC1F,WAAW;YACX,iHAAiH;YACjH,mFAAmF;YACnF,+HAA+H;YAC/H,UAAU;YACV,8GAA8G;YAC9G,oHAAoH;YACpH,8FAA8F;YAC9F,UAAU;YACV,uFAAuF;YACvF,6FAA6F;YAC7F,KAAK;YACL,kHAAkH;YAClH,6GAA6G;SAC9G;QAED,QAAQ,EAAE;YACR,kBAAkB,EAChB,wLAAwL;YAC1L,6BAA6B,EAC3B,6KAA6K;YAC/K,qCAAqC,EACnC,uJAAuJ;YACzJ,sBAAsB,EACpB,sJAAsJ;YACxJ,uBAAuB,EACrB,iJAAiJ;SACpJ;QAED,YAAY,EAAE;YACZ,sGAAsG;YACtG,yGAAyG;YACzG,gGAAgG;YAChG,6FAA6F;YAC7F,sHAAsH;YACtH,yHAAyH;YACzH,+GAA+G;SAChH;KACF;IAED,wDAAwD;IAExD,MAAM,EAAE;QACN,SAAS,EAAE;YACT,iBAAiB;YACjB,8HAA8H;YAC9H,qFAAqF;YACrF,iEAAiE;YACjE,gFAAgF;YAChF,UAAU;YACV,2FAA2F;YAC3F,yFAAyF;YACzF,4DAA4D;YAC5D,cAAc;YACd,oDAAoD;YACpD,uFAAuF;YACvF,+DAA+D;YAC/D,uFAAuF;YACvF,YAAY;YACZ,oFAAoF;YACpF,iEAAiE;YACjE,4EAA4E;YAC5E,KAAK;YACL,uFAAuF;YACvF,0EAA0E;YAC1E,KAAK;YACL,mFAAmF;YACnF,oFAAoF;SACrF;KACF;CACF,CAAC"}

package/dist/domains/pool-ranking.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Question Pool Ranking Engine
+ *
+ * rankQuestions() 是领域问题池的核心排序函数。
+ * 根据用户输入 + 已收集回答，从池中选出最相关的 top-N 问题。
+ *
+ * 纯函数 — 无副作用，无 I/O，确定性输出。
+ */
+import type { QuestionPool, RankedQuestion, RankQuestionsOptions } from './types.js';
+/**
+ * 从 questions（string[] | QuestionPool）中提取纯问题文本数组。
+ * 用于向后兼容已有的数组遍历代码。
+ */
+export declare function extractQuestions(questions: string[] | QuestionPool): string[];
+/**
+ * 从 questions（string[] | QuestionPool）中获取问题数量。
+ */
+export declare function getQuestionCount(questions: string[] | QuestionPool): number;
+/**
+ * 带类型的类型守卫：判断 questions 是否为 QuestionPool。
+ */
+export declare function isQuestionPool(questions: string[] | QuestionPool): questions is QuestionPool;
+/**
+ * 自动将 legacy string[] 格式升级为 QuestionPool。
+ * 每个字符串转为合成 QuestionPoolItem（priority=5, signals=[]）。
+ */
+export declare function upgradeLegacyQuestions(questions: string[]): QuestionPool;
+/**
+ * 纯函数：对问题池按相关性排序，返回 top-N。
+ *
+ * 算法步骤:
+ *   1. 对每个 pool item 计算分数
+ *   2. 过滤掉依赖未满足的项
+ *   3. 过滤掉条件未满足的项
+ *   4. 按 score desc → priority desc 排序
+ *   5. 取 top-N
+ *
+ * @param questions - 问题池 或 legacy string[]
+ * @param options  - 排序选项（用户输入、已有回答、数量上限）
+ * @returns 排序后的问题列表
+ */
+export declare function rankQuestions(questions: string[] | QuestionPool, options: RankQuestionsOptions): RankedQuestion[];
+//# sourceMappingURL=pool-ranking.d.ts.map

package/dist/domains/pool-ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-ranking.d.ts","sourceRoot":"","sources":["../../src/domains/pool-ranking.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACd,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,MAAM,EAAE,CAG7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,SAAS,IAAI,YAAY,CAE5F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,CAQxE;AAqED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,EAClC,OAAO,EAAE,oBAAoB,GAC5B,cAAc,EAAE,CAgDlB"}

package/dist/domains/pool-ranking.js

@@ -0,0 +1,153 @@
+/**
+ * Question Pool Ranking Engine
+ *
+ * rankQuestions() 是领域问题池的核心排序函数。
+ * 根据用户输入 + 已收集回答，从池中选出最相关的 top-N 问题。
+ *
+ * 纯函数 — 无副作用，无 I/O，确定性输出。
+ */
+import { tokenize, signalMatchesToken } from './signal-match.js';
+/**
+ * 从 questions（string[] | QuestionPool）中提取纯问题文本数组。
+ * 用于向后兼容已有的数组遍历代码。
+ */
+export function extractQuestions(questions) {
+    if (Array.isArray(questions))
+        return questions;
+    return questions.items.map((item) => item.text);
+}
+/**
+ * 从 questions（string[] | QuestionPool）中获取问题数量。
+ */
+export function getQuestionCount(questions) {
+    if (Array.isArray(questions))
+        return questions.length;
+    return questions.items.length;
+}
+/**
+ * 带类型的类型守卫：判断 questions 是否为 QuestionPool。
+ */
+export function isQuestionPool(questions) {
+    return !Array.isArray(questions);
+}
+/**
+ * 自动将 legacy string[] 格式升级为 QuestionPool。
+ * 每个字符串转为合成 QuestionPoolItem（priority=5, signals=[]）。
+ */
+export function upgradeLegacyQuestions(questions) {
+    const items = questions.map((text) => ({
+        text,
+        signals: [],
+        priority: 5,
+        requiresAnswer: [],
+    }));
+    return { items, defaultCount: items.length };
+}
+/**
+ * 计算单个 QuestionPoolItem 对用户输入的相关性分数。
+ *
+ * 公式: (匹配信号数 / sqrt(总信号数)) * (priority / 10)
+ *
+ * 如果 signals 为空（legacy 升级项）：
+ *   分数 = priority / 10（始终有资格，只要领域被匹配）
+ */
+function scoreItem(item, lowerInput, tokens) {
+    if (item.signals.length === 0) {
+        return item.priority / 10;
+    }
+    const hits = item.signals.filter((signal) => signalMatchesToken(signal, lowerInput, tokens)).length;
+    return (hits / Math.sqrt(item.signals.length)) * (item.priority / 10);
+}
+/**
+ * 检查依赖链是否满足。
+ *
+ * requiresAnswer 中的每项格式为 "<domain>:<poolIndex>"。
+ * 全部满足返回 true；任何一项未满足返回 false。
+ */
+function dependenciesSatisfied(item, existingAnswers) {
+    if (!item.requiresAnswer || item.requiresAnswer.length === 0) {
+        return true;
+    }
+    if (!existingAnswers) {
+        return false;
+    }
+    return item.requiresAnswer.every((key) => key in existingAnswers);
+}
+/**
+ * 检查条件激活是否满足。
+ *
+ * conditional 中的每项格式为 { "<domain>:<index>": "substring" }。
+ * 如果指定 key 的回答中包含子串（大小写不敏感），则该条件满足。
+ * 全部满足返回 true。
+ */
+function conditionalsSatisfied(item, existingAnswers) {
+    if (!item.conditional || Object.keys(item.conditional).length === 0) {
+        return true;
+    }
+    if (!existingAnswers) {
+        return false;
+    }
+    return Object.entries(item.conditional).every(([key, substring]) => {
+        const answer = existingAnswers[key];
+        if (answer === undefined)
+            return false;
+        return answer.toLowerCase().includes(substring.toLowerCase());
+    });
+}
+/**
+ * 纯函数：对问题池按相关性排序，返回 top-N。
+ *
+ * 算法步骤:
+ *   1. 对每个 pool item 计算分数
+ *   2. 过滤掉依赖未满足的项
+ *   3. 过滤掉条件未满足的项
+ *   4. 按 score desc → priority desc 排序
+ *   5. 取 top-N
+ *
+ * @param questions - 问题池 或 legacy string[]
+ * @param options  - 排序选项（用户输入、已有回答、数量上限）
+ * @returns 排序后的问题列表
+ */
+export function rankQuestions(questions, options) {
+    // Step 0: 自动升级 legacy 格式
+    const pool = Array.isArray(questions)
+        ? upgradeLegacyQuestions(questions)
+        : questions;
+    const count = options.count ?? pool.defaultCount ?? 8;
+    const existingAnswers = options.existingAnswers ?? {};
+    const lowerInput = (options.input ?? '').toLowerCase();
+    const tokens = tokenize(options.input ?? '');
+    // Step 1: 计算每个 item 的分数
+    const scored = [];
+    for (let idx = 0; idx < pool.items.length; idx++) {
+        const item = pool.items[idx];
+        // 过滤依赖
+        if (!dependenciesSatisfied(item, existingAnswers))
+            continue;
+        // 过滤条件
+        if (!conditionalsSatisfied(item, existingAnswers))
+            continue;
+        const score = scoreItem(item, lowerInput, tokens);
+        scored.push({ item, idx, score });
+    }
+    // Step 2: 排序 (score desc → priority desc)
+    scored.sort((a, b) => {
+        const scoreDiff = b.score - a.score;
+        if (Math.abs(scoreDiff) > 0.0001)
+            return scoreDiff;
+        return b.item.priority - a.item.priority;
+    });
+    // Step 3: 取 top-N (保留 score+priority 排序，交互循环会按此顺序提问)
+    const top = scored.slice(0, count);
+    // Step 4: 确定 source 标签
+    const source = Array.isArray(questions) ? 'legacy' : 'pool';
+    return top.map((s) => ({
+        text: s.item.text,
+        score: Math.round(s.score * 1000) / 1000,
+        source,
+        index: s.idx,
+        id: s.item.id,
+        answerKey: s.item.id ?? String(s.idx),
+    }));
+}
+//# sourceMappingURL=pool-ranking.js.map

package/dist/domains/pool-ranking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-ranking.js","sourceRoot":"","sources":["../../src/domains/pool-ranking.ts"],"names":[],"mappings":"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"}

package/dist/domains/quality.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Quality Domain Module
+ *
+ * 来源 (11 个，不含 review-to-solid):
+ *   - content/skills/code-reviewer/SKILL.md (45 行) + references/review-checklist.md (26 行)
+ *     正确性 / 安全 / 可维护性 / 性能 / 测试 5 维评审顺序
+ *   - content/skills/test-driven-development/SKILL.md (32 行)
+ *     Red-Green-Refactor 循环 + 行为命名 + 集成边界优先
+ *   - content/skills/systematic-debugging/SKILL.md (31 行)
+ *     5 步根因调查工作流（Reproduce/Localize/Trace/Fix/Verify）
+ *   - content/skills/verification-before-completion/SKILL.md (49 行)
+ *     完成前必须有新鲜证据；不得依赖旧 output / 子代理报告
+ *   - content/skills/performance-profiling/SKILL.md (65 行)
+ *     基线 → 热点 → 根因 → 优化 → 验证；前后端性能拆分
+ *   - content/skills/webapp-testing/SKILL.md (39 行)
+ *     Playwright 轻量 e2e + 降级链 (browser → jsdom → component → http)
+ *   - content/roles/04-quality-security/code-reviewer.toml (42 行)
+ *     evidence-driven review，1 normal + 1 failure path 验证
+ *   - content/roles/04-quality-security/debugger.toml (42 行)
+ *     fault-origin isolation，假设 vs 证据分离
+ *   - content/roles/04-quality-security/qa-expert.toml (42 行)
+ *     risk-based test scope；release gating
+ *   - content/roles/04-quality-security/test-automator.toml (42 行)
+ *     deterministic regression coverage；行为契约断言
+ *   - content/roles/04-quality-security/performance-engineer.toml (42 行)
+ *     bottleneck identification with measurement evidence
+ *
+ * 压缩方法:
+ *   1. code-reviewer 5 维评审顺序 → design.checklist 顶部 + implement.focusAreas
+ *   2. TDD Red-Green-Refactor → design.patterns + implement.patterns
+ *   3. systematic-debugging 5 步 → implement.focusAreas + implement.patterns
+ *   4. verification-before-completion 红旗短语 → implement.antiPatterns
+ *   5. performance-profiling 5 步工作流 → design.patterns + verify.checklist
+ *   6. webapp-testing 降级链 → implement.patterns
+ *   7. 5 个 role 的 quality checks → verify.checklist
+ *
+ * 与相邻领域的边界:
+ *   - 单词 'n+1' / 'query plan' / 'slow query' 归 backend；quality 用通用 'profile' / 'bottleneck'
+ *   - 'lighthouse' / 'core web vitals' / 'lcp' 归 frontend
+ *   - review-to-solid 不在此处；它是独立 Protocol，由 apply 命令显式注入
+ *   - 'review' 单词归 quality；operations 用多词 'pr description' / 'pr template'
+ */
+import type { DomainModule } from './types.js';
+export declare const qualityDomain: DomainModule;
+//# sourceMappingURL=quality.d.ts.map

package/dist/domains/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/domains/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE,YAwW3B,CAAC"}