docs: 更新 CONTRIBUTING 反映新结构 + 加英文版

- CONTRIBUTING.md 重写:
  - 可贡献类型分优先级：🔥 pitfalls 真实踩坑（最受欢迎）/ 技巧
    / scenarios / 修正过时信息 / 翻译
  - 明确文件结构：加入 cheatsheet.md, pitfalls/, templates/ 说明
  - 明确 CI 会校验 link + 双语对照
  - 说明 templates/ 不需要翻译（是项目专属配置）
- 新增 CONTRIBUTING.en.md 英文版
- CI bilingual-parity 移除 CONTRIBUTING.md 排除（现在有英文版了）

Author: jnMetaCode

.github/workflows/link-check.yml

@@ -44,12 +44,11 @@ jobs:
 
           # .md 没对应 .en.md
           while IFS= read -r -d '' file; do
-            # 跳过不需要双语的文件：模板、license、贡献指南等
+            # 跳过不需要双语的文件：模板、license 等
             case "$file" in
               *.en.md) continue;;
               ./node_modules/*) continue;;
               ./LICENSE*) continue;;
-              ./CONTRIBUTING.md) continue;;
               */templates/*) continue;;       # 配置模板是项目专属，不翻译
             esac
             en="${file%.md}.en.md"

CONTRIBUTING.en.md

@@ -0,0 +1,84 @@
+[简体中文](./CONTRIBUTING.md) | **English**
+
+# Contributing
+
+Thanks for your interest in the AI Coding Practical Guide.
+
+## What to Contribute
+
+Welcome contribution types (ordered by "most valued"):
+
+### 🔥 High priority: real pitfalls you've hit
+
+Write a [`pitfalls/<tool>.md`](./pitfalls/README.en.md) entry for a pitfall you actually hit. **Must be real**, not speculation.
+
+Format: Symptom / Cause / Recovery / Prevention. Full template in [pitfalls/README.en.md](./pitfalls/README.en.md).
+
+Tools not yet covered: Windsurf / Gemini CLI / Kiro / Trae / OpenClaw.
+
+### 🔥 Practical tool tips
+
+Add to the "Prompt Tips" or "Advanced Usage" section of a tool's `README.en.md`. Every tip must:
+- Have a concrete scenario (not "this is better" but "in scenario X, Y beats Z")
+- Include a ❌/✅ comparison or a copy-ready prompt
+- Include verifiable outcomes (what was run, what was seen)
+
+### ⚡ End-to-end dialogue scripts
+
+Add to [`workflows/scenarios.en.md`](./workflows/scenarios.en.md). A complete runnable prompt sequence that covers an entire flow from requirement to acceptance.
+
+### ⚡ Fix outdated info
+
+AI tools move fast. Spot outdated content (versions, pricing, commands, feature deltas) and fix it:
+- [`cheatsheet.en.md`](./cheatsheet.en.md) — comparison parameters
+- Each `<tool>/README.en.md` — commands and hotkeys
+- [`ecosystem.en.md`](./ecosystem.en.md) — ecosystem project specs (role counts, features)
+
+### ⚡ Translation and bilingual maintenance
+
+All content has `.md` (Chinese) and `.en.md` (English) parallels. When you contribute:
+- Update Chinese → sync to English (draft is fine; others will polish)
+- Translating existing zh-only files to English is a valid contribution
+- Files under `templates/` **do not** need translation (they're project-specific configs)
+
+CI automatically verifies every `.md` has a matching `.en.md`.
+
+## Process
+
+1. Fork this repo
+2. Create a feature branch: `git checkout -b add-xxx-tip`
+3. Commit your changes (Chinese or English in commit messages, either is fine)
+4. Push to your fork: `git push origin add-xxx-tip`
+5. Open a Pull Request
+
+CI runs on PR:
+- **Link Check** — validates internal and external Markdown links
+- **Bilingual Parity** — ensures bilingual pairs are complete
+
+If CI is red, check the Actions output and fix.
+
+## Content Standards
+
+- **Practical first** — every tip should have a concrete scenario, no hand-waving
+- **Code examples** — use ❌/✅ comparisons
+- **Concise** — one paragraph beats three when the content fits
+- **Accurate** — commands, configs, APIs must be verified, not invented
+- **Avoid "pitfall of pitfalls"** — don't dress up operator errors as pitfalls (e.g. "forgetting to save a file" is not a pitfall). See quality bar in [pitfalls/README.en.md](./pitfalls/README.en.md).
+
+## File Layout
+
+```
+cheatsheet.md             — 9-tool cheatsheet (comparison + command reference)
+ecosystem.md              — Related ecosystem projects (superpowers / agents / etc.)
+
+<tool>/README.md          — Full guide for one tool (9 tools total)
+<tool>/templates/         — Copy-ready config templates
+
+common/xxx.md             — Cross-tool methodologies (prompting / debugging / ...)
+workflows/xxx.md          — Multi-tool workflows + real-world dialogue scripts
+pitfalls/<tool>.md        — Deep pitfall collection per tool
+```
+
+## License
+
+Contributions are accepted under [Apache 2.0](./LICENSE).

CONTRIBUTING.md

@@ -4,32 +4,77 @@
 
 ## 可以贡献什么
 
-- **补充工具技巧** — 你发现了某个工具的实用技巧，附上实际使用场景
-- **修正过时信息** — AI 工具更新很快，帮忙更新已经变了的内容
-- **分享协作经验** — 你的多工具协作工作流
-- **翻译** — 帮忙把内容翻译成英文或其他语言
+欢迎的贡献类型（按"最受欢迎"排序）：
+
+### 🔥 优先级高：真实踩坑的陷阱
+
+写 [`pitfalls/<tool>.md`](./pitfalls/)：你用某个工具时踩过的坑。**要求真实遇到过**，不是推测。
+
+格式：症状 / 根因 / 出坑 / 预防 四段式。详细模板见 [pitfalls/README.md](./pitfalls/README.md)。
+
+尚未覆盖的工具：Windsurf / Gemini CLI / Kiro / Trae / OpenClaw。
+
+### 🔥 实用工具技巧
+
+补充 `工具名/README.md` 的"提示词技巧"或"进阶技巧"章节。每个技巧必须：
+- 有具体场景（不是"这样更好"而是"在 X 场景下 Y 更好"）
+- 附 ❌/✅ 对比或可复制的提示词
+- 附可验证结果（跑了什么、看到什么）
+
+### ⚡ 实战对话脚本
+
+补充 [`workflows/scenarios.md`](./workflows/scenarios.md) 的端到端场景。一个完整可跑的提示词序列，覆盖从需求到验收的全流程。
+
+### ⚡ 修正过时信息
+
+AI 工具更新很快。发现过时内容（版本号、定价、命令、功能差异）请修正：
+- [`cheatsheet.md`](./cheatsheet.md) — 速查表的参数
+- 各 `工具名/README.md` — 具体命令和快捷键
+- [`ecosystem.md`](./ecosystem.md) — 生态项目的角色数、功能
+
+### ⚡ 翻译与双语维护
+
+所有内容都有 `.md`（中文）和 `.en.md`（英文）双语。贡献时：
+- 更新中文 → 同步更新英文版（可以先放一个 draft，有人会帮忙 polish）
+- 只翻译已有中文但缺英文的文件也是有效贡献
+- `templates/` 目录下的配置模板**不需要**翻译（是项目专属）
+
+CI 会自动校验每个 `.md` 都有配套 `.en.md`。
 
 ## 贡献流程
 
 1. Fork 本项目
 2. 创建 feature 分支：`git checkout -b add-xxx-tip`
-3. 提交修改（commit message 用中文即可）
+3. 提交修改（commit message 用中文或英文均可）
 4. 推送到你的 fork：`git push origin add-xxx-tip`
 5. 提交 Pull Request
 
+PR 提交后会触发 CI：
+- **Link Check** — 检查 Markdown 内外链接是否有效
+- **Bilingual Parity** — 检查双语对照完整性
+
+CI 红的话，看 Actions 输出修复即可。
+
 ## 内容规范
 
 - **实用优先** — 每个技巧都应该有具体的使用场景，不要空谈概念
 - **代码示例** — 用 ❌/✅ 对比展示好坏做法
 - **保持简洁** — 一段话能说清楚的不要写三段
 - **事实准确** — 命令、配置、API 必须经过验证，不要编造
+- **避免"pitfall 的 pitfall"** — 写陷阱时，不要把"忘记保存文件"这种操作失误当成陷阱（详见 [pitfalls/README.md](./pitfalls/README.md) 的质量标准）
 
 ## 文件结构
 
 ```
-工具名/README.md          — 某个工具的完整指南
-common/xxx.md             — 通用方法论
-workflows/xxx.md          — 多工具协作工作流
+cheatsheet.md             — 9 工具速查表（横向对比 + 命令速查）
+ecosystem.md              — 相关项目生态（superpowers / agents 等）
+
+工具名/README.md          — 某个工具的完整指南（9 个工具）
+工具名/templates/         — 可复制的配置模板
+
+common/xxx.md             — 跨工具的通用方法论（prompting / debugging 等）
+workflows/xxx.md          — 多工具协作工作流 + 实战对话脚本
+pitfalls/<tool>.md        — 每个工具的深度陷阱合集
 ```
 
 ## 许可