Skip to content

Reverse Engineering / Authorized Penetration Testing / Security Research Skill Router Pack AI-powered routing + On-demand toolchain bootstrapping + Self-evolving knowledge base Supports Claude Code, Kiro, Cursor, Cline, and other AI coding clients 逆向/渗透/安全技能路由包 - AI 自动路由 + 按需自举工具链 + 自动进化经验库 | 支持 Claude Code / Kiro / Cursor / Cline 等代码 AI 客户端

Shell

docs: add community issue triage and Chinese quick start (#110)

Edisonf31d813f173e
diff --git a/README.md b/README.md
index 0b3ce24..f091b07 100644
--- a/README.md
+++ b/README.md
@@ -313,3 +313,7 @@ This project is intended solely for lawful security research, education, CTF com
## Installation and download security
See [Installation and Download Security Guidance](docs/UV-AND-DOWNLOAD-SECURITY.md).
+
+## Community quick start and issue triage
+
+See [Quick Start](docs/QUICKSTART_zh.md) and [Community Issue Triage](docs/COMMUNITY-ISSUE-TRIAGE.md) for installation, client integration, and how community issues are classified. Installation/archive security details remain in [Installation and Download Security Guidance](docs/UV-AND-DOWNLOAD-SECURITY.md).
diff --git a/README_zh.md b/README_zh.md
index 0e7f74b..24e6ee2 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -310,3 +310,7 @@ GitHub Actions 会在 Windows 与 Ubuntu 上执行同一套核心检查。
## 安裝與下載安全
請參閱[安裝與下載安全指引](docs/UV-AND-DOWNLOAD-SECURITY_zh.md)。
+
+## 社群問題、快速開始與分類
+
+請參閱[快速開始指南](docs/QUICKSTART_zh.md)與[社群 Issue 分類說明](docs/COMMUNITY-ISSUE-TRIAGE.md)。安裝與壓縮檔安全細節仍見[安裝與下載安全指引](docs/UV-AND-DOWNLOAD-SECURITY_zh.md)。
diff --git a/docs/COMMUNITY-ISSUE-TRIAGE.md b/docs/COMMUNITY-ISSUE-TRIAGE.md
new file mode 100644
index 0000000..e0a6822
--- /dev/null
+++ b/docs/COMMUNITY-ISSUE-TRIAGE.md
@@ -0,0 +1,19 @@
+# Community Issue Triage
+
+This document records which community concerns can be addressed in-repository and which require a maintainer or platform owner.
+
+| Issue | Assessment | Repository action |
+|---|---|---|
+| #21, #86 | AI safety refusal for a particular target | Added authorization-first and defensive-use guidance; this cannot override a client safety policy. |
+| #44, #61 | Installation and usage questions | Added `QUICKSTART_zh.md` and linked it from both READMEs. |
+| #47 | Codex/plugin integration request | The project remains client-neutral; client-specific plugin work needs an agreed integration contract. |
+| #51 | Prefer uv over pip | Added correct guidance for `uv tool install` and `uv pip` without unsafe mechanical replacement. Bootstrap still uses pinned pipx. |
+| #58, #60 | Low-information reports | Need a reproducible sample, environment, and exact error before a code fix is possible. |
+| #62 | iOS workflow evidence threshold | Requires a maintainer decision about workflow policy and test data rather than a blind code change. |
+| #63 | Account-ban concern | Depends on third-party platform policy; users should follow applicable terms. |
+| #80 | radare2-skills contribution discussion | Contribution instructions are available in `skills/CONTRIBUTING.md`; maintainers must decide scope and ownership. |
+| #82 | ZIP download security warning | Covered by `docs/UV-AND-DOWNLOAD-SECURITY.md` plus the quick-start archive checklist. |
+| #83 | Codex synchronization failure | Added a diagnostic checklist; a client version and reproducible case are still required for a client-side fix. |
+| #77, #87, #95, #97, #99, #100, #101, #103, #104 | Feature proposals or existing work items | These require separate design review and should not be silently duplicated by a documentation PR. |
+
+A Pull Request should close only issues that it actually resolves. Discussion items, third-party platform behavior, and reports without reproduction details should remain open for maintainer review.
diff --git a/docs/QUICKSTART_zh.md b/docs/QUICKSTART_zh.md
new file mode 100644
index 0000000..3657399
--- /dev/null
+++ b/docs/QUICKSTART_zh.md
@@ -0,0 +1,56 @@
+# reverse-skill 快速開始與社群問題說明
+
+## 專案定位
+
+`reverse-skill` 是 AI 客戶端可讀取的逆向工程、安全研究技能、規則與工具文件集合,不是一個單一的可執行應用程式。使用前,請先確認你對分析目標擁有明確授權,或正在使用合法的 CTF、教學或測試環境。
+
+## 基本使用方式
+
+先下載專案:
+
+ git clone https://github.com/zhaoxuya520/reverse-skill.git
+ cd reverse-skill
+
+接著將專案目錄交給你使用的 AI 客戶端作為工作區或文件來源。核心文件包括:
+
+- `RULES.md`:一般規則與安全邊界。
+- `skills/MASTER-ROUTING.md`:技能路由與任務分流。
+- `skills/*/SKILL.md`:各專業領域的技能說明。
+- `docs/platforms/`:不同作業系統的工具安裝說明。
+
+本專案保持客戶端中立,因此 OpenCode、Codex、Cursor、Claude Code 與其他客戶端的實際載入方式,仍以各客戶端官方文件為準;不要假設某一個客戶端的 plugin 或同步格式能套用到其他客戶端。
+
+## OpenCode、Codex 與同步問題
+
+若客戶端顯示 `Not Synchronizable` 或無法同步,先確認工作區是否指向完整的 repository 根目錄、檔案權限是否允許讀取,以及客戶端是否支援該目錄格式。最可靠的替代方式是直接在本地工作區開啟 repository,並在對話中明確引用所需的規則或技能文件。若問題仍可重現,回報時請附上客戶端版本、作業系統、完整錯誤訊息與最小重現步驟。
+
+## AI 拒絕處理分析請求
+
+AI 的安全策略不會因為提示中加入「我已授權」就必然允許所有操作。請只處理合法授權的目標,避免要求未授權入侵、憑證竊取、持久化或破壞性操作;可將請求限定為程式碼理解、樣本分析、漏洞修補、CTF 或防禦性驗證。對於特定 APK、網站或帳戶,請先準備可驗證的授權範圍與測試環境。
+
+## Python 工具與 uv
+
+獨立命令列工具可使用:
+
+ uv tool install PACKAGE_NAME
+
+專案依賴則使用隔離環境:
+
+ uv venv
+ uv pip install -r requirements.txt
+
+不要機械式把所有 `pip` 字串替換為 `uv pip`;`python -m pip`、`pipx` bootstrap 與已存在的虛擬環境各有不同用途。若尚未安裝 `uv`,請使用作業系統套件管理器或明確建立的虛擬環境,不要把安全工具直接安裝到系統全域 Python。
+
+更完整的安裝與壓縮檔安全說明見 [安裝與下載安全指引](UV-AND-DOWNLOAD-SECURITY_zh.md)。
+
+## ZIP 報毒與下載安全
+
+逆向工程工具可能包含二進位檔、除錯器、封裝檔或測試資料,容易觸發防毒軟體的啟發式偵測。防毒警告不代表已證明安全,也不代表已證明惡意。請勿停用防毒軟體或盲目略過警告。
+
+開啟壓縮檔前,請從預期的 HTTPS repository 或 release 頁面下載,核對 checksum 或 release digest(若有提供),檢查壓縮檔內容,並使用最新的安全軟體掃描。不要因為檔案成功下載,就直接執行其中未知的二進位檔、腳本或安裝程式。
+
+## 帳戶、貢獻與未具體化回報
+
+請遵守 AI 客戶端、GitHub、工具供應商及目標環境的服務條款。repository 本身無法保證第三方平台不會限制帳戶,也不能替平台決定帳戶政策。若要貢獻 radare2 或其他技能,請先閱讀 `skills/CONTRIBUTING.md`,並以小型、可驗證的 Pull Request 提交。
+
+只有包含完整錯誤訊息、環境資訊與重現步驟的問題,才適合進一步修復。像是只有「病毒」、「gaha」或「test」的回報,請補充檔名、下載 URL、掃描產品、版本與重現方式。