reverse-engineer
/reverse-engineer
[UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 Use when: 為沒有文件的系統補上文件、從既有程式碼回推規格、繪製未知的資料模型或執行環境拓樸。 Not for: 動工前評估健康度與風險——請用 /discover;從已核准的規格正向推導測試——請用 /spec-derive。 Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 反向工程, 系統考古, 規格提取, 資料模型.
- Author
- AsiaOstrich ↗
- Repository
- universal-dev-standards ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
[UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 Use when: 為沒有文件的系統補上文件、從既有程式碼回推規格、繪製未知的資料模型或執行環境拓樸。 Not for: 動工前評估健康度與風險——請用 /discover;從已核准的規格正向推導測試——請用 /spec-derive。 Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 反向工程, 系統考古, 規格提取, 資料模型.
Original author description
[UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 Use when: 為沒有文件的系統補上文件、從既有程式碼回推規格、繪製未知的資料模型或執行環境拓樸。 Not for: 動工前評估健康度與風險——請用 /discover;從已核准的規格正向推導測試——請用 /spec-derive。 Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 反向工程, 系統考古, 規格提取, 資料模型.
How it works
- 三大維度
- 子命令
- 全面分析模式
- 維度詳情
- 防幻覺規則
- 使用方式
- 下一步引導
- 參考
- AI 代理行為
SKILL.md preview
--- name: reverse-engineer source: ../../../../skills/reverse-engineer/SKILL.md source_version: 1.2.0 source_hash: d543b24b2422 translation_version: 1.3.0 last_synced: 2026-08-17 status: current description: | [UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 Use when: 為沒有文件的系統補上文件、從既有程式碼回推規格、繪製未知的資料模型或執行環境拓樸。 Not for: 動工前評估健康度與風險——請用 /discover;從已核准的規格正向推導測試——請用 /spec-derive。 Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 反向工程, 系統考古, 規格提取, 資料模型. --- # 反向工程助手 > **語言**: [English](../../../../skills/reverse-engineer/SKILL.md) | 繁體中文 系統考古框架:從三個維度反向工程既有系統——**邏輯**、**資料**、**執行環境**。 ## 三大維度 ``` ┌─────────────────────────────────────────────────────────┐ │ System Archeology Framework │ ├──────────┬──────────────┬────────────────────────────────┤ │ Logic │ Data │ Runtime │ │ (spec) │ (data) │ (runtime) │ ├──────────┼──────────────┼────────────────────────────────┤ │ APIs │ DB Schemas │ Logs & Error Patterns │ │ Modules │ ORMs/Models │ Config & Environment │ │ Flows │ Migrations │ Metrics & Performance │ │ Tests │ Seed Data │ Infra & Deployment │ └──────────┴──────────────┴────────────────────────────────┘ ``` ## 子命令 | 子命令 | 維度 | 輸入 | 輸出 | 說明 | |--------|------|------|------|------| | *(無)* | 全部 | 專案根目錄 | 完整考古報告 | 三維度全面分析 | | `spec` | 邏輯 | 程式碼檔案/目錄 | `SPEC-XXX.md` | 從程式碼提取規格 | | `data` | 資料 | DB 結構、ORM、遷移檔 | 資料模型規格 | 分析資料模型與結構 | | `runtime` | 執行環境 | 日誌、設定、指標 | 執行環境基準 | 分析執行環境基準 | | `bdd` | — | `SPEC-XXX.md` | `.feature` | 將 AC 轉為 Gherkin | | `tdd` | — | `.feature` | 覆蓋率報告 | 分析測試覆蓋率 | ## 全面分析模式 當 `/reverse` 在未帶子命令的情況下被呼叫時,依序執行全部三個維度: 1. **資料(Data)** → 掃描結構、ORM、遷移檔 2. **執行環境(Runtime)** → 分析日誌、設定、部署 3. **邏輯(Logic / spec)** → 提取 API、流程、測試 → 產生 SPEC 輸出:整合三個維度的 **系統考古報告(System Archeology Report)**。 ## 維度詳情 ### spec:邏輯維度(既有) 1. **掃描** - 讀取原始碼檔案,識別公開 API、資料流與業務邏輯 2. **分類** - 將每個發現標記為 `[Confirmed]`、`[Inferred]` 或 `[Unknown]` 3. **結構化** - 整理為 SDD 規格格式,包含驗收條件 4. **引用來源** - 每項反向結果皆以 `file:line` 引用來源 ### data:資料維度(新增) 1. **探索** - 找出資料庫結構、ORM 模型、遷移檔、種子資料 2. **對應** - 從程式碼證據建立實體關聯模型 3. **分類** - 將關聯標記為 `[Confirmed]`(FK 約束)或 `[Inferred]`(程式碼模式) 4. **報告** - 輸出資料模型規格,包含: - 含欄位與型別的實體清單 - 關聯對應(1:1、1:N、M:N) - 索引與約束清單 - 遷移歷史摘要 - 資料流路徑(寫入 → 讀取) **證據來源**:`schema.prisma`、`*.migration.*`、`models/`、`entities/`、`knexfile.*`、`sequelize`、`typeorm`、SQL 檔案、`docker-compose.yml`(DB 服務) ### runtime:執行環境維度(新增) 1. **掃描設定** - 環境變數、設定檔、功能旗標 2. **分析日誌** - 日誌模式、錯誤頻率、日誌層級 3. **檢查基礎設施** - Docker 設定、CI/CD 管線、部署清單 4. **建立基準** - 輸出執行環境基準,包含: - 環境變數清單(僅名稱,**絕不含值/密鑰**) - 設定檔對應與階層 - 外部服務依賴(API、佇列、快取) - 部署拓撲(容器、服務) - 健康檢查與監控端點 **證據來源**:`.env.example`、`docker-compose.yml`、`Dockerfile`、`*.config.*`、CI/CD 檔案、`k8s/`、日誌檔案(僅模式) **安全性**:絕不輸出實際密鑰值。僅列出變數名稱並描述其用途。 ## 防幻覺規則 | 規則 | 要求 | |------|------| | **確定性標籤** | 所有發現須使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 標注 | | **來源引用** | 每項反向結果須引用 `file:line` 來源 | | **禁止捏造** | 不得捏造程式碼中不存在的 API 或行為 | | **禁止密鑰** | 不得輸出設定檔或環境變數的密鑰值 | ## 使用方式 ``` /reverse - 三維度全面分析 /reverse spec src/auth/ - 邏輯:提取規格 /reverse data - 資料:分析結構與模型 /reverse runtime - 執行環境:分析設定與基礎設施 /reverse bdd specs/SPEC-AUTH.md - 將規格 AC 轉為 Gherkin /reverse tdd features/auth.feature - 分析測試覆蓋率 ``` ## 下一步引導 `/reverse`(完整或 `spec`)完成後,AI 助手應建議: > **系統考古完成。建議下一步:** > - 執行 `/sdd` 審查並核准此規格 ⭐ **推薦** — 審查並核准產生的規格 > - 執行 `/derive` 從規格推導測試 — 從規格推導測試(須先核准) > - 審查規格中的 `[Inferred]` 和 `[Unknown]` 標記 — 手動審查不確定性標籤 ## 參考 - [BDD 提取工作流程指南](./bdd-extraction.md) — 要從既有規格裡萃取 BDD 場景時讀它。 - [TDD 分析工作流程指南](./tdd-analysis.md) — 要對照場景分析測試涵蓋率、找出缺口時讀它。 - 逐步流程:[workflow.md](./workflow.md) — 逆向工程的各階段與順序(程式碼掃描、資料模型、設定、測試分析、涵蓋率)。真的要跑一次逆向時讀它。 - 詳細指南:[guide.md](./guide.md) - 核心規範:[reverse-engineering-standards.md](../../../../core/reverse-engineering-standards.md) ## AI 代理行為 > 完整的 AI 行為定義請參閱對應的命令文件:[`/reverse`](../../../../skills/commands/reverse.md#ai-agent-behavior--ai-代理行為)
Files in this package (5)
- SKILL.md 7 KB
- bdd-extraction.md 16 KB
- guide.md 20 KB
- tdd-analysis.md 17 KB
- workflow.md 13 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · AsiaOstrich/universal-dev-standards | 100 | MIT |
| boshu2/agentops | 100 | Apache-2.0 |
| Akshat2430/reverse-engineer-sheets | 100 | MIT |
| marian-kamenistak/sap-ai-skills | 90 | MIT |
| AsiaOstrich/universal-dev-standards | 84 | MIT |
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 1436f7ee2511 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95reverse
[UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 Use when: 為沒有文件的系統補上文件、從既有程式碼回推規格、繪製未知的資料模型或執行環境拓樸。 Not for: 動工前評估健康度與風險——請用 /discover;從已核准的規格正向推導測試——請用 /spec-derive。 Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 反向工程, 系統考古, 規格提取, 資料模型. - 95reverse
[UDS] System archeology — reverse engineer an existing system across the Logic, Data, and Runtime dimensions. Use when: documenting an undocumented system, recovering specifications from existing code, mapping an unknown data model or runtime topology. Not for: assessing health… - 100legacy-spec
Reverse-engineer an undocumented legacy system into a validatable specification. Works unit by unit so large systems fit the context window, writes every finding to disk under spec/ with file:line citations, and resumes from the on-disk state in any session. Use when asked to… - 100code-to-spec
Reverse-engineer a SPEC document from an existing project. Analyzes code, config, tests, and structure to produce a comprehensive specification. Triggers on: code-to-spec, reverse spec, generate spec, 逆向规格, 生成规格文档, 生成设计文档, 生成设计方案, extract spec, document this project, what does this project do. - 100reverse-spec
Use to extract a spec FROM existing code. Inverse of "build from spec" — given the code, recover what it does. Useful for: legacy systems, undocumented modules, post-hoc compliance evidence. - 96reverse-logic-architecture
逻辑架构要素反构编排Skill. 当 reverse 的 --target 为 logic_architecture 或 all 的逻辑架构阶段时触发.