Skip to content

docs(zh-CN): sync Chinese docs with latest upstream changes#1308

Open
zdocapp wants to merge 2 commits intoaffaan-m:mainfrom
zdocapp:zh-CN-62519f2-pr
Open

docs(zh-CN): sync Chinese docs with latest upstream changes#1308
zdocapp wants to merge 2 commits intoaffaan-m:mainfrom
zdocapp:zh-CN-62519f2-pr

Conversation

@zdocapp
Copy link
Copy Markdown
Contributor

@zdocapp zdocapp commented Apr 7, 2026

What Changed

This PR performs an incremental zh-CN translation sync based on the latest commit from main(62519f2).

Approach

  • The translation process traverses the English source files to ensure the zh-CN docs remain a complete mirror of the upstream structure.
  • Translation is performed at the block level:
    • Unchanged blocks reuse existing translations.
    • Modified blocks are retranslated as a whole.

Notes / Trade-offs

  • This approach minimizes unnecessary changes and keeps diffs stable in most cases.
  • However, since the block is the smallest unit, even minor changes within a large block may cause the entire block to be retranslated.
  • This is a known limitation of the current strategy, and finer-grained diffing is not yet implemented.

Why This Change

#1218 (comment)

Testing Done

  • Manual testing completed
  • Automated tests pass locally (node tests/run-all.js)
  • Edge cases considered and tested

Type of Change

  • fix: Bug fix
  • feat: New feature
  • refactor: Code refactoring
  • docs: Documentation
  • test: Tests
  • chore: Maintenance/tooling
  • ci: CI/CD changes

Security & Quality Checklist

  • No secrets or API keys committed (ghp_, sk-, AKIA, xoxb, xoxp patterns checked)
  • JSON files validate cleanly
  • Shell scripts pass shellcheck (if applicable)
  • Pre-commit hooks pass locally (if configured)
  • No sensitive data exposed in logs or output
  • Follows conventional commits format

Documentation

  • Updated relevant documentation
  • Added comments for complex logic
  • README updated (if needed)

Summary by cubic

Synced zh-CN docs to upstream 1.10.0 (commit 62519f2), adding new content and aligning command/agent docs with current workflows and ECC 2.0 alpha. Also fixed the language selector links and several translations in docs/zh-CN/README.md and related pages.

  • New Features

    • Added command quick reference and expanded /code-review with PR mode; introduced /review-pr.
    • Documented PRP workflows: prp-plan, prp-implement, prp-commit, prp-pr, prp-prd.
    • Added GAN harness docs and commands (gan-build, gan-design) plus gan-* agents.
    • Added Flutter/Dart docs: build/test/review commands and dart-build-resolver, flutter-reviewer; new Dart rules (coding style, testing, security, hooks).
    • Added web rules (coding-style, design-quality, hooks); updated common rules (code-review, coding-style, testing, workflow).
    • Added new agents: performance-optimizer, seo-specialist, comment-analyzer, silent-failure-hunter, type-design-analyzer, open‑source pipeline agents, and more.
    • Introduced Hookify docs and commands (hookify, hookify-list, hookify-configure, hookify-help) and updated hooks guide.
    • Added ECC 2.0 alpha overview under ecc2/, repository assessment/evaluation docs, and updated zh-CN README.md and CHANGELOG.md.
    • Polish: fixed the README language selector links and improved Chinese phrasing in several docs.
  • Migration

    • Prefer skills over legacy slash commands where pages are marked as compatibility shims (e.g., use documentation-lookup, tdd-workflow, context-budget, claude-devfleet).
    • Session files now default to ~/.claude/session-data/; update any scripts or usage that assumed ~/.claude/sessions/ (reading from old path is still supported).
    • For PR reviews, use /review-pr or run /code-review with a PR number/URL.
    • To explore ECC 2.0 alpha, build locally via cargo build --manifest-path ecc2/Cargo.toml and use ecc-tui commands as documented.
    • Use new Hookify commands to create, list, and toggle local rules before wider adoption.

Written for commit 28c7c55. Summary will update on new commits.

@ecc-tools
Copy link
Copy Markdown
Contributor

ecc-tools bot commented Apr 7, 2026

ECC bundle files are already tracked in this repository. Skipping generation of another bundle PR.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 7, 2026

Important

Review skipped

Too many files!

This PR contains 251 files, which is 101 over the limit of 150.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b4ea65d5-bb95-47d0-b71e-a1f1a2b54984

📥 Commits

Reviewing files that changed from the base of the PR and between 62519f2 and 28c7c55.

📒 Files selected for processing (251)
  • docs/zh-CN/AGENTS.md
  • docs/zh-CN/CHANGELOG.md
  • docs/zh-CN/CLAUDE.md
  • docs/zh-CN/CODE_OF_CONDUCT.md
  • docs/zh-CN/COMMANDS-QUICK-REF.md
  • docs/zh-CN/CONTRIBUTING.md
  • docs/zh-CN/EVALUATION.md
  • docs/zh-CN/README.md
  • docs/zh-CN/REPO-ASSESSMENT.md
  • docs/zh-CN/RULES.md
  • docs/zh-CN/SECURITY.md
  • docs/zh-CN/SOUL.md
  • docs/zh-CN/agents/code-architect.md
  • docs/zh-CN/agents/code-explorer.md
  • docs/zh-CN/agents/code-simplifier.md
  • docs/zh-CN/agents/comment-analyzer.md
  • docs/zh-CN/agents/conversation-analyzer.md
  • docs/zh-CN/agents/csharp-reviewer.md
  • docs/zh-CN/agents/dart-build-resolver.md
  • docs/zh-CN/agents/gan-evaluator.md
  • docs/zh-CN/agents/gan-generator.md
  • docs/zh-CN/agents/gan-planner.md
  • docs/zh-CN/agents/healthcare-reviewer.md
  • docs/zh-CN/agents/opensource-forker.md
  • docs/zh-CN/agents/opensource-packager.md
  • docs/zh-CN/agents/opensource-sanitizer.md
  • docs/zh-CN/agents/performance-optimizer.md
  • docs/zh-CN/agents/planner.md
  • docs/zh-CN/agents/pr-test-analyzer.md
  • docs/zh-CN/agents/seo-specialist.md
  • docs/zh-CN/agents/silent-failure-hunter.md
  • docs/zh-CN/agents/type-design-analyzer.md
  • docs/zh-CN/commands/agent-sort.md
  • docs/zh-CN/commands/aside.md
  • docs/zh-CN/commands/build-fix.md
  • docs/zh-CN/commands/claw.md
  • docs/zh-CN/commands/code-review.md
  • docs/zh-CN/commands/context-budget.md
  • docs/zh-CN/commands/cpp-build.md
  • docs/zh-CN/commands/cpp-review.md
  • docs/zh-CN/commands/devfleet.md
  • docs/zh-CN/commands/docs.md
  • docs/zh-CN/commands/e2e.md
  • docs/zh-CN/commands/eval.md
  • docs/zh-CN/commands/feature-dev.md
  • docs/zh-CN/commands/flutter-build.md
  • docs/zh-CN/commands/flutter-review.md
  • docs/zh-CN/commands/flutter-test.md
  • docs/zh-CN/commands/gan-build.md
  • docs/zh-CN/commands/gan-design.md
  • docs/zh-CN/commands/go-build.md
  • docs/zh-CN/commands/go-review.md
  • docs/zh-CN/commands/harness-audit.md
  • docs/zh-CN/commands/hookify-configure.md
  • docs/zh-CN/commands/hookify-help.md
  • docs/zh-CN/commands/hookify-list.md
  • docs/zh-CN/commands/hookify.md
  • docs/zh-CN/commands/instinct-import.md
  • docs/zh-CN/commands/jira.md
  • docs/zh-CN/commands/kotlin-build.md
  • docs/zh-CN/commands/kotlin-review.md
  • docs/zh-CN/commands/learn-eval.md
  • docs/zh-CN/commands/multi-plan.md
  • docs/zh-CN/commands/orchestrate.md
  • docs/zh-CN/commands/plan.md
  • docs/zh-CN/commands/prompt-optimize.md
  • docs/zh-CN/commands/prp-commit.md
  • docs/zh-CN/commands/prp-implement.md
  • docs/zh-CN/commands/prp-plan.md
  • docs/zh-CN/commands/prp-pr.md
  • docs/zh-CN/commands/prp-prd.md
  • docs/zh-CN/commands/prune.md
  • docs/zh-CN/commands/python-review.md
  • docs/zh-CN/commands/refactor-clean.md
  • docs/zh-CN/commands/resume-session.md
  • docs/zh-CN/commands/review-pr.md
  • docs/zh-CN/commands/rules-distill.md
  • docs/zh-CN/commands/santa-loop.md
  • docs/zh-CN/commands/save-session.md
  • docs/zh-CN/commands/sessions.md
  • docs/zh-CN/commands/tdd.md
  • docs/zh-CN/commands/test-coverage.md
  • docs/zh-CN/commands/verify.md
  • docs/zh-CN/ecc2/README.md
  • docs/zh-CN/examples/gan-harness/README.md
  • docs/zh-CN/hooks/README.md
  • docs/zh-CN/research/ecc2-codebase-analysis.md
  • docs/zh-CN/rules/README.md
  • docs/zh-CN/rules/common/code-review.md
  • docs/zh-CN/rules/common/coding-style.md
  • docs/zh-CN/rules/common/development-workflow.md
  • docs/zh-CN/rules/common/testing.md
  • docs/zh-CN/rules/dart/coding-style.md
  • docs/zh-CN/rules/dart/hooks.md
  • docs/zh-CN/rules/dart/patterns.md
  • docs/zh-CN/rules/dart/security.md
  • docs/zh-CN/rules/dart/testing.md
  • docs/zh-CN/rules/web/coding-style.md
  • docs/zh-CN/rules/web/design-quality.md
  • docs/zh-CN/rules/web/hooks.md
  • docs/zh-CN/rules/web/patterns.md
  • docs/zh-CN/rules/web/performance.md
  • docs/zh-CN/rules/web/security.md
  • docs/zh-CN/rules/web/testing.md
  • docs/zh-CN/skills/agent-eval/SKILL.md
  • docs/zh-CN/skills/agent-introspection-debugging/SKILL.md
  • docs/zh-CN/skills/agent-payment-x402/SKILL.md
  • docs/zh-CN/skills/agent-sort/SKILL.md
  • docs/zh-CN/skills/ai-regression-testing/SKILL.md
  • docs/zh-CN/skills/android-clean-architecture/SKILL.md
  • docs/zh-CN/skills/api-connector-builder/SKILL.md
  • docs/zh-CN/skills/article-writing/SKILL.md
  • docs/zh-CN/skills/automation-audit-ops/SKILL.md
  • docs/zh-CN/skills/autonomous-agent-harness/SKILL.md
  • docs/zh-CN/skills/autonomous-loops/SKILL.md
  • docs/zh-CN/skills/benchmark/SKILL.md
  • docs/zh-CN/skills/brand-voice/SKILL.md
  • docs/zh-CN/skills/brand-voice/references/voice-profile-schema.md
  • docs/zh-CN/skills/browser-qa/SKILL.md
  • docs/zh-CN/skills/canary-watch/SKILL.md
  • docs/zh-CN/skills/carrier-relationship-management/SKILL.md
  • docs/zh-CN/skills/ck/SKILL.md
  • docs/zh-CN/skills/click-path-audit/SKILL.md
  • docs/zh-CN/skills/code-tour/SKILL.md
  • docs/zh-CN/skills/coding-standards/SKILL.md
  • docs/zh-CN/skills/configure-ecc/SKILL.md
  • docs/zh-CN/skills/connections-optimizer/SKILL.md
  • docs/zh-CN/skills/content-engine/SKILL.md
  • docs/zh-CN/skills/context-budget/SKILL.md
  • docs/zh-CN/skills/continuous-agent-loop/SKILL.md
  • docs/zh-CN/skills/continuous-learning-v2/SKILL.md
  • docs/zh-CN/skills/continuous-learning/SKILL.md
  • docs/zh-CN/skills/council/SKILL.md
  • docs/zh-CN/skills/crosspost/SKILL.md
  • docs/zh-CN/skills/csharp-testing/SKILL.md
  • docs/zh-CN/skills/customer-billing-ops/SKILL.md
  • docs/zh-CN/skills/customs-trade-compliance/SKILL.md
  • docs/zh-CN/skills/dart-flutter-patterns/SKILL.md
  • docs/zh-CN/skills/dashboard-builder/SKILL.md
  • docs/zh-CN/skills/database-migrations/SKILL.md
  • docs/zh-CN/skills/defi-amm-security/SKILL.md
  • docs/zh-CN/skills/design-system/SKILL.md
  • docs/zh-CN/skills/django-verification/SKILL.md
  • docs/zh-CN/skills/dmux-workflows/SKILL.md
  • docs/zh-CN/skills/dotnet-patterns/SKILL.md
  • docs/zh-CN/skills/ecc-tools-cost-audit/SKILL.md
  • docs/zh-CN/skills/email-ops/SKILL.md
  • docs/zh-CN/skills/energy-procurement/SKILL.md
  • docs/zh-CN/skills/evm-token-decimals/SKILL.md
  • docs/zh-CN/skills/finance-billing-ops/SKILL.md
  • docs/zh-CN/skills/frontend-design/SKILL.md
  • docs/zh-CN/skills/git-workflow/SKILL.md
  • docs/zh-CN/skills/github-ops/SKILL.md
  • docs/zh-CN/skills/google-workspace-ops/SKILL.md
  • docs/zh-CN/skills/healthcare-cdss-patterns/SKILL.md
  • docs/zh-CN/skills/healthcare-emr-patterns/SKILL.md
  • docs/zh-CN/skills/healthcare-eval-harness/SKILL.md
  • docs/zh-CN/skills/healthcare-phi-compliance/SKILL.md
  • docs/zh-CN/skills/hexagonal-architecture/SKILL.md
  • docs/zh-CN/skills/hipaa-compliance/SKILL.md
  • docs/zh-CN/skills/hookify-rules/SKILL.md
  • docs/zh-CN/skills/inventory-demand-planning/SKILL.md
  • docs/zh-CN/skills/investor-outreach/SKILL.md
  • docs/zh-CN/skills/iterative-retrieval/SKILL.md
  • docs/zh-CN/skills/jira-integration/SKILL.md
  • docs/zh-CN/skills/knowledge-ops/SKILL.md
  • docs/zh-CN/skills/laravel-plugin-discovery/SKILL.md
  • docs/zh-CN/skills/laravel-verification/SKILL.md
  • docs/zh-CN/skills/lead-intelligence/SKILL.md
  • docs/zh-CN/skills/lead-intelligence/agents/enrichment-agent.md
  • docs/zh-CN/skills/lead-intelligence/agents/mutual-mapper.md
  • docs/zh-CN/skills/lead-intelligence/agents/outreach-drafter.md
  • docs/zh-CN/skills/lead-intelligence/agents/signal-scorer.md
  • docs/zh-CN/skills/llm-trading-agent-security/SKILL.md
  • docs/zh-CN/skills/logistics-exception-management/SKILL.md
  • docs/zh-CN/skills/manim-video/SKILL.md
  • docs/zh-CN/skills/mcp-server-patterns/SKILL.md
  • docs/zh-CN/skills/messages-ops/SKILL.md
  • docs/zh-CN/skills/nestjs-patterns/SKILL.md
  • docs/zh-CN/skills/nodejs-keccak256/SKILL.md
  • docs/zh-CN/skills/nutrient-document-processing/SKILL.md
  • docs/zh-CN/skills/openclaw-persona-forge/SKILL.md
  • docs/zh-CN/skills/openclaw-persona-forge/references/avatar-style.md
  • docs/zh-CN/skills/openclaw-persona-forge/references/boundary-rules.md
  • docs/zh-CN/skills/openclaw-persona-forge/references/error-handling.md
  • docs/zh-CN/skills/openclaw-persona-forge/references/identity-tension.md
  • docs/zh-CN/skills/openclaw-persona-forge/references/naming-system.md
  • docs/zh-CN/skills/openclaw-persona-forge/references/output-template.md
  • docs/zh-CN/skills/opensource-pipeline/SKILL.md
  • docs/zh-CN/skills/plankton-code-quality/SKILL.md
  • docs/zh-CN/skills/product-capability/SKILL.md
  • docs/zh-CN/skills/product-lens/SKILL.md
  • docs/zh-CN/skills/production-scheduling/SKILL.md
  • docs/zh-CN/skills/project-flow-ops/SKILL.md
  • docs/zh-CN/skills/prompt-optimizer/SKILL.md
  • docs/zh-CN/skills/quality-nonconformance/SKILL.md
  • docs/zh-CN/skills/remotion-video-creation/SKILL.md
  • docs/zh-CN/skills/remotion-video-creation/rules/3d.md
  • docs/zh-CN/skills/remotion-video-creation/rules/animations.md
  • docs/zh-CN/skills/remotion-video-creation/rules/assets.md
  • docs/zh-CN/skills/remotion-video-creation/rules/audio.md
  • docs/zh-CN/skills/remotion-video-creation/rules/calculate-metadata.md
  • docs/zh-CN/skills/remotion-video-creation/rules/can-decode.md
  • docs/zh-CN/skills/remotion-video-creation/rules/charts.md
  • docs/zh-CN/skills/remotion-video-creation/rules/compositions.md
  • docs/zh-CN/skills/remotion-video-creation/rules/display-captions.md
  • docs/zh-CN/skills/remotion-video-creation/rules/extract-frames.md
  • docs/zh-CN/skills/remotion-video-creation/rules/fonts.md
  • docs/zh-CN/skills/remotion-video-creation/rules/get-audio-duration.md
  • docs/zh-CN/skills/remotion-video-creation/rules/get-video-dimensions.md
  • docs/zh-CN/skills/remotion-video-creation/rules/get-video-duration.md
  • docs/zh-CN/skills/remotion-video-creation/rules/gifs.md
  • docs/zh-CN/skills/remotion-video-creation/rules/images.md
  • docs/zh-CN/skills/remotion-video-creation/rules/import-srt-captions.md
  • docs/zh-CN/skills/remotion-video-creation/rules/lottie.md
  • docs/zh-CN/skills/remotion-video-creation/rules/measuring-dom-nodes.md
  • docs/zh-CN/skills/remotion-video-creation/rules/measuring-text.md
  • docs/zh-CN/skills/remotion-video-creation/rules/sequencing.md
  • docs/zh-CN/skills/remotion-video-creation/rules/tailwind.md
  • docs/zh-CN/skills/remotion-video-creation/rules/text-animations.md
  • docs/zh-CN/skills/remotion-video-creation/rules/timing.md
  • docs/zh-CN/skills/remotion-video-creation/rules/transcribe-captions.md
  • docs/zh-CN/skills/remotion-video-creation/rules/transitions.md
  • docs/zh-CN/skills/remotion-video-creation/rules/trimming.md
  • docs/zh-CN/skills/remotion-video-creation/rules/videos.md
  • docs/zh-CN/skills/repo-scan/SKILL.md
  • docs/zh-CN/skills/research-ops/SKILL.md
  • docs/zh-CN/skills/returns-reverse-logistics/SKILL.md
  • docs/zh-CN/skills/rules-distill/SKILL.md
  • docs/zh-CN/skills/safety-guard/SKILL.md
  • docs/zh-CN/skills/santa-method/SKILL.md
  • docs/zh-CN/skills/security-bounty-hunter/SKILL.md
  • docs/zh-CN/skills/security-review/SKILL.md
  • docs/zh-CN/skills/seo/SKILL.md
  • docs/zh-CN/skills/skill-comply/SKILL.md
  • docs/zh-CN/skills/skill-comply/prompts/classifier.md
  • docs/zh-CN/skills/skill-comply/prompts/scenario_generator.md
  • docs/zh-CN/skills/skill-comply/prompts/spec_generator.md
  • docs/zh-CN/skills/social-graph-ranker/SKILL.md
  • docs/zh-CN/skills/tdd-workflow/SKILL.md
  • docs/zh-CN/skills/team-builder/SKILL.md
  • docs/zh-CN/skills/terminal-ops/SKILL.md
  • docs/zh-CN/skills/token-budget-advisor/SKILL.md
  • docs/zh-CN/skills/ui-demo/SKILL.md
  • docs/zh-CN/skills/unified-notifications-ops/SKILL.md
  • docs/zh-CN/skills/videodb/SKILL.md
  • docs/zh-CN/skills/visa-doc-translate/README.md
  • docs/zh-CN/skills/workspace-surface-audit/SKILL.md
  • docs/zh-CN/skills/x-api/SKILL.md
  • docs/zh-CN/the-security-guide.md
  • docs/zh-CN/the-shortform-guide.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

37 issues found across 251 files

Note: This PR contains a large number of files. cubic only reviews up to 75 files per PR, so some files may not have been reviewed. We prioritized the most important files first.

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/zh-CN/commands/prp-plan.md">

<violation number="1" location="docs/zh-CN/commands/prp-plan.md:126">
P2: Malformed Markdown table: separator row has 4 columns while header/data rows have 3.</violation>

<violation number="2" location="docs/zh-CN/commands/prp-plan.md:482">
P2: Checklist requires build verification, but the command template does not define a corresponding build-validation section.</violation>
</file>

<file name="docs/zh-CN/commands/gan-build.md">

<violation number="1" location="docs/zh-CN/commands/gan-build.md:48">
P2: `--eval-mode` values are inconsistent within the same command doc, mixing canonical tokens with localized labels and creating ambiguous/invalid mode usage.</violation>

<violation number="2" location="docs/zh-CN/commands/gan-build.md:50">
P2: Feedback filename pattern is inconsistent (unpadded `{iteration}` vs zero-padded `001` format), which can break documented workflow expectations.</violation>
</file>

<file name="docs/zh-CN/commands/flutter-review.md">

<violation number="1" location="docs/zh-CN/commands/flutter-review.md:19">
P2: 先决条件缺少团队要求的 CI/自动化检查通过门禁,可能导致在 checks failing/pending 时仍发起评审并被阻断。</violation>
</file>

<file name="docs/zh-CN/agents/opensource-packager.md">

<violation number="1" location="docs/zh-CN/agents/opensource-packager.md:40">
P2: 嵌套代码块示例使用转义反引号而非更长外层 fence,易导致复制后的 Markdown 模板包含错误 fence。</violation>
</file>

<file name="docs/zh-CN/commands/multi-plan.md">

<violation number="1" location="docs/zh-CN/commands/multi-plan.md:219">
P2: The fenced command block was de-indented, so it is no longer nested under the “执行计划” list item and may render as a separate top-level block.</violation>
</file>

<file name="docs/zh-CN/commands/aside.md">

<violation number="1" location="docs/zh-CN/commands/aside.md:82">
P2: Edge-case templates translate protocol labels (`ASIDE`/`WARNING`), making output markers inconsistent within the same command spec.</violation>
</file>

<file name="docs/zh-CN/commands/python-review.md">

<violation number="1" location="docs/zh-CN/commands/python-review.md:318">
P2: Markdown table row is malformed: escaped backticks prevent code span, leaving an unescaped `|` that can break column parsing.</violation>
</file>

<file name="docs/zh-CN/CONTRIBUTING.md">

<violation number="1" location="docs/zh-CN/CONTRIBUTING.md:124">
P2: Nested markdown template blocks use escaped inner backticks under triple outer fences, producing copy-paste-incorrect examples; use longer outer fences instead.</violation>
</file>

<file name="docs/zh-CN/agents/opensource-sanitizer.md">

<violation number="1" location="docs/zh-CN/agents/opensource-sanitizer.md:129">
P2: The Git history scan command can expose full secret values, contradicting the doc’s own rule to never display full secrets.</violation>
</file>

<file name="docs/zh-CN/CODE_OF_CONDUCT.md">

<violation number="1" location="docs/zh-CN/CODE_OF_CONDUCT.md:74">
P2: Escaping brackets broke the intended Markdown reference link, so the attribution text no longer renders as a clickable link.</violation>
</file>

<file name="docs/zh-CN/commands/prp-pr.md">

<violation number="1" location="docs/zh-CN/commands/prp-pr.md:91">
P2: Post-rebase push instruction is inconsistent and likely fails for diverged remote branches; use lease-protected force push.</violation>

<violation number="2" location="docs/zh-CN/commands/prp-pr.md:176">
P2: The doc instructs requesting code review even when CI may still be pending, violating the team’s gate that checks must pass before human review.</violation>
</file>

<file name="docs/zh-CN/commands/code-review.md">

<violation number="1" location="docs/zh-CN/commands/code-review.md:95">
P2: PR 审查流程缺少“冲突即阻断”的明确门禁,且未采集合并状态字段,可能在不可合并 PR 上继续审查。</violation>

<violation number="2" location="docs/zh-CN/commands/code-review.md:110">
P2: PR 审查流程缺少“先确认自动化 checks 通过再开始人工审查”的前置门禁,当前阶段顺序与团队审查要求不一致。</violation>
</file>

<file name="docs/zh-CN/commands/hookify-list.md">

<violation number="1" location="docs/zh-CN/commands/hookify-list.md:18">
P2: 文档流程前后不一致:步骤2读取 `action` 元数据,但步骤3的输出表格未包含对应列,导致 `/hookify-list` 输出契约不明确。</violation>
</file>

<file name="docs/zh-CN/commands/review-pr.md">

<violation number="1" location="docs/zh-CN/commands/review-pr.md:15">
P2: The `/review-pr` workflow omits required readiness gates (green checks and no merge conflicts) before starting review steps, which can trigger invalid or stale reviews.</violation>

<violation number="2" location="docs/zh-CN/commands/review-pr.md:16">
P2: The review workflow incorrectly tells users to use only `gh pr view` for diffs; it should include `gh pr diff` for actual patch content.</violation>
</file>

<file name="docs/zh-CN/commands/e2e.md">

<violation number="1" location="docs/zh-CN/commands/e2e.md:7">
P2: 文档对 `/e2e` 的实现归属存在冲突:前文称委托 `e2e-testing` 技能,后文仍称调用 `e2e-runner` 代理。</violation>

<violation number="2" location="docs/zh-CN/commands/e2e.md:25">
P2: `委托`段落混入未清理的测试代码,破坏了该旧版入口文档应保持的简洁委托语义。</violation>

<violation number="3" location="docs/zh-CN/commands/e2e.md:82">
P2: 多余的四反引号代码围栏把“测试产物/查看产物”整段包进代码块,导致文档结构和渲染错误。</violation>
</file>

<file name="docs/zh-CN/commands/prune.md">

<violation number="1" location="docs/zh-CN/commands/prune.md:28">
P2: Usage comment overstates `/prune` scope and conflicts with the page’s constrained definition of what gets deleted.</violation>
</file>

<file name="docs/zh-CN/commands/orchestrate.md">

<violation number="1" location="docs/zh-CN/commands/orchestrate.md:44">
P2: Misplaced 4-backtick fence breaks Markdown structure and causes the `并行执行` section to render as code instead of normal documentation.</violation>
</file>

<file name="docs/zh-CN/README.md">

<violation number="1" location="docs/zh-CN/README.md:1">
P2: Language-switcher links in zh-CN README over-traverse (`../../../` / `../../../../`), likely breaking locale and English navigation.</violation>

<violation number="2" location="docs/zh-CN/README.md:1426">
P2: User-facing docs newly link to an unvetted external repository, violating project supply-chain trust guidance.</violation>
</file>

<file name="docs/zh-CN/commands/go-review.md">

<violation number="1" location="docs/zh-CN/commands/go-review.md:134">
P2: Localized `失败:` replaces canonical `FAIL:` status token in the go-review example, creating inconsistent status-token format within the same command doc.</violation>
</file>

<file name="docs/zh-CN/commands/prp-commit.md">

<violation number="1" location="docs/zh-CN/commands/prp-commit.md:36">
P2: `only new files` uses whitespace-unsafe `xargs git add`, which breaks on untracked filenames containing spaces/newlines.</violation>
</file>

<file name="docs/zh-CN/commands/go-build.md">

<violation number="1" location="docs/zh-CN/commands/go-build.md:142">
P2: Localized status token (`通过`) in example output is inconsistent with standardized `PASS`/`SUCCESS` style tokens used across resolver docs, reducing output-to-log fidelity.</violation>
</file>

<file name="docs/zh-CN/agents/gan-evaluator.md">

<violation number="1" location="docs/zh-CN/agents/gan-evaluator.md:45">
P2: Playwright execution instructions are inconsistent with declared tools and include invalid CLI command usage (`playwright navigate`), risking evaluator workflow failure.</violation>
</file>

<file name="docs/zh-CN/commands/harness-audit.md">

<violation number="1" location="docs/zh-CN/commands/harness-audit.md:7">
P2: `--root` was added to command usage but omitted from the `$ARGUMENTS` block, causing inconsistent argument documentation.</violation>
</file>

<file name="docs/zh-CN/commands/learn-eval.md">

<violation number="1" location="docs/zh-CN/commands/learn-eval.md:86">
P2: Step 6 sub-bullets were de-indented to top level, which can break/obscure ordered-list nesting in rendered Markdown.</violation>
</file>

<file name="docs/zh-CN/commands/instinct-import.md">

<violation number="1" location="docs/zh-CN/commands/instinct-import.md:47">
P2: Localized zh-CN documentation regressed to English in the import-process example block, reducing translation consistency and reader usability.</violation>
</file>

<file name="docs/zh-CN/agents/dart-build-resolver.md">

<violation number="1" location="docs/zh-CN/agents/dart-build-resolver.md:45">
P2: 文档对纯 Dart 项目与工作流要求不一致:前文允许 `dart analyze`,后文却强制每次都运行 `flutter analyze`。</violation>

<violation number="2" location="docs/zh-CN/agents/dart-build-resolver.md:66">
P2: Troubleshooting guidance incorrectly claims `--delete-conflicting-outputs` can force rebuild when build_runner reports no actions were run.</violation>
</file>

<file name="docs/zh-CN/agents/csharp-reviewer.md">

<violation number="1" location="docs/zh-CN/agents/csharp-reviewer.md:13">
P2: Reviewer instructions do not enforce the required gate that automated checks must pass before starting code review.</violation>

<violation number="2" location="docs/zh-CN/agents/csharp-reviewer.md:15">
P2: C# reviewer prompt lacks a merge-conflict/merge-readiness gate before beginning review, contrary to team review policy.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.

将发现结果编译成单一参考:

| 类别 | 文件:行号 | 模式 | 关键代码片段 |
|---|---|---|---|
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Malformed Markdown table: separator row has 4 columns while header/data rows have 3.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/commands/prp-plan.md, line 126:

<comment>Malformed Markdown table: separator row has 4 columns while header/data rows have 3.</comment>

<file context>
@@ -0,0 +1,499 @@
+将发现结果编译成单一参考:
+
+| 类别 | 文件:行号 | 模式 | 关键代码片段 |
+|---|---|---|---|
+| 命名 | `src/services/userService.ts:1-5` | 驼峰式服务,帕斯卡式类型 | `export class UserService` |
+| 错误 | `src/middleware/errorHandler.ts:10-25` | 自定义 AppError 类 | `throw new AppError(...)` |
</file context>
Suggested change
|---|---|---|---|
|---|---|---|
Fix with Cubic

### 验证覆盖范围
- [ ] 静态分析命令已指定
- [ ] 测试命令已指定
- [ ] 构建验证已包含
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Checklist requires build verification, but the command template does not define a corresponding build-validation section.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/commands/prp-plan.md, line 482:

<comment>Checklist requires build verification, but the command template does not define a corresponding build-validation section.</comment>

<file context>
@@ -0,0 +1,499 @@
+### 验证覆盖范围
+- [ ] 静态分析命令已指定
+- [ ] 测试命令已指定
+- [ ] 构建验证已包含
+
+### UX 清晰度
</file context>
Fix with Cubic

- 读取 eval-rubric.md 和 spec.md
- 测试实时应用程序(模式:playwright/截图/仅代码)
- 根据评分标准打分
- 将反馈写入 feedback/feedback-{iteration}.md
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Feedback filename pattern is inconsistent (unpadded {iteration} vs zero-padded 001 format), which can break documented workflow expectations.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/commands/gan-build.md, line 50:

<comment>Feedback filename pattern is inconsistent (unpadded `{iteration}` vs zero-padded `001` format), which can break documented workflow expectations.</comment>

<file context>
@@ -0,0 +1,105 @@
+    - 读取 eval-rubric.md 和 spec.md
+    - 测试实时应用程序(模式:playwright/截图/仅代码)
+    - 根据评分标准打分
+    - 将反馈写入 feedback/feedback-{iteration}.md
+
+    # 等待评估器完成
</file context>
Fix with Cubic

# 评估
通过 Task 工具启动 gan-evaluator 代理:
- 读取 eval-rubric.md 和 spec.md
- 测试实时应用程序(模式:playwright/截图/仅代码)
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: --eval-mode values are inconsistent within the same command doc, mixing canonical tokens with localized labels and creating ambiguous/invalid mode usage.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/commands/gan-build.md, line 48:

<comment>`--eval-mode` values are inconsistent within the same command doc, mixing canonical tokens with localized labels and creating ambiguous/invalid mode usage.</comment>

<file context>
@@ -0,0 +1,105 @@
+    # 评估
+    通过 Task 工具启动 gan-evaluator 代理:
+    - 读取 eval-rubric.md 和 spec.md
+    - 测试实时应用程序(模式:playwright/截图/仅代码)
+    - 根据评分标准打分
+    - 将反馈写入 feedback/feedback-{iteration}.md
</file context>
Fix with Cubic


## 先决条件

在运行 `/flutter-review` 之前,请确保:
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: 先决条件缺少团队要求的 CI/自动化检查通过门禁,可能导致在 checks failing/pending 时仍发起评审并被阻断。

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/commands/flutter-review.md, line 19:

<comment>先决条件缺少团队要求的 CI/自动化检查通过门禁,可能导致在 checks failing/pending 时仍发起评审并被阻断。</comment>

<file context>
@@ -0,0 +1,118 @@
+
+## 先决条件
+
+在运行 `/flutter-review` 之前,请确保:
+
+1. **构建通过** — 先运行 `/flutter-build`;对无法构建的代码进行审查是不完整的
</file context>
Fix with Cubic


```
team-instincts.yaml 导入本能
Importing instincts from: team-instincts.yaml
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Localized zh-CN documentation regressed to English in the import-process example block, reducing translation consistency and reader usability.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/commands/instinct-import.md, line 47:

<comment>Localized zh-CN documentation regressed to English in the import-process example block, reducing translation consistency and reader usability.</comment>

<file context>
@@ -44,33 +44,33 @@ python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <
 
  • 从 team-instincts.yaml 导入本能
  • Importing instincts from: team-instincts.yaml
    ================================================

</file context>


</details>

<a href="https://www.cubic.dev/action/fix/violation/62012417-a35b-4b43-961e-0e551c7c8a45" target="_blank" rel="noopener noreferrer" data-no-image-dialog="true">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://cubic.dev/buttons/fix-with-cubic-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://cubic.dev/buttons/fix-with-cubic-light.svg">
    <img alt="Fix with Cubic" src="https://cubic.dev/buttons/fix-with-cubic-dark.svg">
  </picture>
</a>

| `The class 'X' doesn't implement 'Y'` | 缺少 `implements` 或缺少方法 | 添加方法或修正类签名 |
| `Because X depends on Y >=A and Z depends on Y <B, version solving failed` | Pub 版本冲突 | 调整版本约束或添加 `dependency_overrides` |
| `Could not find a file named "pubspec.yaml"` | 工作目录错误 | 从项目根目录运行 |
| `build_runner: No actions were run` | build\_runner 输入无变化 | 使用 `--delete-conflicting-outputs` 强制重新构建 |
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Troubleshooting guidance incorrectly claims --delete-conflicting-outputs can force rebuild when build_runner reports no actions were run.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/agents/dart-build-resolver.md, line 66:

<comment>Troubleshooting guidance incorrectly claims `--delete-conflicting-outputs` can force rebuild when build_runner reports no actions were run.</comment>

<file context>
@@ -0,0 +1,202 @@
+| `The class 'X' doesn't implement 'Y'` | 缺少 `implements` 或缺少方法 | 添加方法或修正类签名 |
+| `Because X depends on Y >=A and Z depends on Y <B, version solving failed` | Pub 版本冲突 | 调整版本约束或添加 `dependency_overrides` |
+| `Could not find a file named "pubspec.yaml"` | 工作目录错误 | 从项目根目录运行 |
+| `build_runner: No actions were run` | build\_runner 输入无变化 | 使用 `--delete-conflicting-outputs` 强制重新构建 |
+| `Part of directive found, but 'X' expected` | 生成的文件过时 | 删除 `.g.dart` 文件并重新运行 build\_runner |
+
</file context>
Fix with Cubic

@@ -0,0 +1,202 @@
---
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: 文档对纯 Dart 项目与工作流要求不一致:前文允许 dart analyze,后文却强制每次都运行 flutter analyze

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/agents/dart-build-resolver.md, line 45:

<comment>文档对纯 Dart 项目与工作流要求不一致:前文允许 `dart analyze`,后文却强制每次都运行 `flutter analyze`。</comment>

<file context>
@@ -0,0 +1,202 @@
+## 解决工作流
+
+```text
+1. flutter analyze        -> 解析错误信息
+2. Read affected file     -> 理解上下文
+3. Apply minimal fix      -> 仅应用必要修复
</file context>
Fix with Cubic

1. 运行 `git diff -- '*.cs'` 以查看最近的 C# 文件更改
2. 如果可用,运行 `dotnet build` 和 `dotnet format --verify-no-changes`
3. 重点关注修改过的 `.cs` 文件
4. 立即开始审查
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: C# reviewer prompt lacks a merge-conflict/merge-readiness gate before beginning review, contrary to team review policy.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/agents/csharp-reviewer.md, line 15:

<comment>C# reviewer prompt lacks a merge-conflict/merge-readiness gate before beginning review, contrary to team review policy.</comment>

<file context>
@@ -0,0 +1,109 @@
+1. 运行 `git diff -- '*.cs'` 以查看最近的 C# 文件更改
+2. 如果可用,运行 `dotnet build` 和 `dotnet format --verify-no-changes`
+3. 重点关注修改过的 `.cs` 文件
+4. 立即开始审查
+
+## 审查优先级
</file context>
Fix with Cubic

当被调用时:

1. 运行 `git diff -- '*.cs'` 以查看最近的 C# 文件更改
2. 如果可用,运行 `dotnet build` 和 `dotnet format --verify-no-changes`
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Reviewer instructions do not enforce the required gate that automated checks must pass before starting code review.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/zh-CN/agents/csharp-reviewer.md, line 13:

<comment>Reviewer instructions do not enforce the required gate that automated checks must pass before starting code review.</comment>

<file context>
@@ -0,0 +1,109 @@
+当被调用时:
+
+1. 运行 `git diff -- '*.cs'` 以查看最近的 C# 文件更改
+2. 如果可用,运行 `dotnet build` 和 `dotnet format --verify-no-changes`
+3. 重点关注修改过的 `.cs` 文件
+4. 立即开始审查
</file context>
Fix with Cubic

@zdocapp
Copy link
Copy Markdown
Contributor Author

zdocapp commented Apr 7, 2026

The CI tests are failing, but I’m not yet sure if it’s the same issue as observed locally.

When running tests locally on the latest main branch (no changes from this PR):

npm run test

I get 5 failing tests, but the failure output differs from what is shown in CI.

Local test output:


Round 73: validate-commands.js (unreadable skill entry — statSync catch):
  ✗ skips unreadable skill directory entries without error (broken symlink)
    Error: EPERM: operation not permitted, symlink 'E:\nonexistent\target\path' -> 'C:\Users\GC\AppData\Local\Temp\ci-validator-test-eqTeia\broken-skill'


Round 83: getAllSessions (broken symlink — statSync catch):
  ✗ getAllSessions skips broken symlink .tmp files gracefully
    Error: EPERM: operation not permitted, symlink 'E:\nonexistent\path\that\does\not\exist' -> 'C:\Users\GC\AppData\Local\Temp\ecc-r83-toctou-1775534134733\.claude\sessions\2026-02-10-deadbeef-session.tmp'

Round 84: getSessionById (broken symlink — statSync catch):
  ✗ getSessionById returns null when matching session is a broken symlink
    Error: EPERM: operation not permitted, symlink 'E:\nonexistent\target\that\does\not\exist' -> 'C:\Users\GC\AppData\Local\Temp\ecc-r84-getbyid-toctou-1775534134736\.claude\sessions\2026-02-11-deadbeef-session.tmp'


Round 84: findFiles (inner statSync catch — broken symlink):
  ✗ findFiles skips broken symlinks that match the pattern
    Error: EPERM: operation not permitted, symlink 'E:\nonexistent\path\does\not\exist' -> 'C:\Users\GC\AppData\Local\Temp\ecc-r84-findfiles-toctou-1775534141354\broken.txt'



=== Testing build-opencode.js ===

  ✓ package.json exposes the OpenCode build and prepack hooks
  ✓ build script generates .opencode/dist
  ✗ npm pack includes the compiled OpenCode dist payload


╔══════════════════════════════════════════════════════════╗
║                     Final Results                        ║
╠══════════════════════════════════════════════════════════╣
║  Total Tests: 1735                                       ║
║  Passed:      1730  ✓                                    ║
║  Failed:         5  ✗                                    ║
╚══════════════════════════════════════════════════════════╝

So at the moment, it's unclear whether:

  • these failures are pre-existing issues on main, or
  • there is an environment/runtime difference between CI and local

Any guidance on how to align the environments or interpret the CI failures would be appreciated.

@ecc-tools
Copy link
Copy Markdown
Contributor

ecc-tools bot commented Apr 7, 2026

ECC bundle files are already tracked in this repository. Skipping generation of another bundle PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants