Writing Skills
writing-skills
效率与协作技能,来自 obra/superpowers,查看原文获取完整用途和操作说明。
review-data-analysis【部署与运维】Review a data analysis for quality, correctness, and reproducibility. Covers data quality assessment, assumption checking, model validation, data leakage detection, and reproducibility verification. Use when reviewing a colleague's analysis before publication, validating an ML pipeline before production deployment, auditing a report for regulatory or…
独立 GitHub 快照 · 自动分类 · 以原作者文档为准
評數析線之正、韌、可復。
評析前先審入數:
## Data Quality Assessment
### Completeness
- [ ] Missing data quantified (% by column and by row)
- [ ] Missing data mechanism considered (MCAR, MAR, MNAR)
- [ ] Imputation method appropriate (if used) or complete-case analysis justified
### Consistency
- [ ] Data types match expectations (dates are dates, numbers are numbers)
- [ ] Value ranges are plausible (no negative ages, future dates in historical data)
- [ ] Categorical variables have expected levels (no misspellings, consistent coding)
- [ ] Units are consistent across records
### Uniqueness
- [ ] Duplicate records identified and handled
- [ ] Primary keys are unique where expected
- [ ] Join operations produce expected row counts (no fan-out or drop)
### Timeliness
- [ ] Data vintage appropriate for the analysis question
- [ ] Temporal coverage matches the study period
- [ ] No look-ahead bias in time-series data
### Provenance
- [ ] Data source documented
- [ ] Extraction date/version recorded
- [ ] Any transformations between source and analysis input documented
得: 數質患已書附其於果之影 敗則: 若數不可審,自碼察其質(何察與化已施)
各統法或所用之模:
| 法 | 要假 | 如何察 |
|---|---|---|
| 線回歸 | 線、獨、殘之常、同方差 | 殘圖、Q-Q 圖、Durbin-Watson、Breusch-Pagan |
| 邏回歸 | 獨、無多共線、線 logit | VIF、Box-Tidwell、殘診 |
| t 試 | 獨、常(或大 n)、等方差 | Shapiro-Wilk、Levene 試、視察 |
| ANOVA | 獨、常、方差同 | 各組 Shapiro-Wilk、Levene 試 |
| 卡方 | 獨、期頻 ≥ 5 | 期頻表 |
| 隨森 | 訓數足、特相關 | OOB 誤、特要、學曲 |
| 神網 | 數足、構宜、無數漏 | 驗曲、過擬察 |
## Assumption Check Results
| Analysis Step | Method | Assumption | Checked? | Result |
|---------------|--------|------------|----------|--------|
| Primary model | Linear regression | Normality of residuals | Yes | Q-Q plot shows mild deviation — acceptable for n>100 |
| Primary model | Linear regression | Homoscedasticity | No | Not checked — recommend adding Breusch-Pagan test |
得: 各統法之諸假明察或承 敗則: 若假違,察著者是否處之(韌法、化、敏析)
數漏發於訓集外之信影模時,致過樂之性:
## Leakage Assessment
| Check | Status | Evidence |
|-------|--------|----------|
| Target leakage | Clear | No features derived from target |
| Temporal leakage | CONCERN | Feature X uses 30-day forward average |
| Train-test contamination | Clear | StandardScaler fit on train only |
| Group leakage | CONCERN | Patient IDs not used for stratified split |
得: 諸常漏形已察附 clear/concern 之態 敗則: 若得漏,估其影由再行而無漏特(若可),或標待析者察
得: 模驗合用境(預對推) 敗則: 若試集之性疑近訓性,標可漏
## Reproducibility Checklist
| Item | Status | Notes |
|------|--------|-------|
| Code runs without errors | [Yes/No] | Tested on [environment description] |
| Random seeds set | [Yes/No] | Line [N] in [file] |
| Dependencies documented | [Yes/No] | requirements.txt / renv.lock present |
| Data loading reproducible | [Yes/No] | Path is [relative/absolute/URL] |
| Results match reported values | [Yes/No] | Verified: Table 1 ✓, Figure 2 ✗ (minor discrepancy) |
| Environment documented | [Yes/No] | Python 3.11 / R 4.5.0 specified |
得: 可復由再行析(或自碼察若數不可得)已驗 敗則: 若果不精復,定差於浮點容內或示患
## Data Analysis Review
### Overall Assessment
[1-2 sentences: Is the analysis sound? Does it support the conclusions?]
### Data Quality
[Summary of data quality findings, impact on results]
### Methodological Concerns
1. **[Title]**: [Description, location in code/report, suggestion]
2. ...
### Strengths
1. [What was done well]
2. ...
### Reproducibility
[Tier assessment: Gold/Silver/Bronze/Opaque with justification]
### Recommendations
- [ ] [Specific action items for the analyst]
得: 審供可行之反附碼所/報段之具引 敗則: 若時限,先處數質與漏察而後格患
review-research — 廣研法與稿審validate-statistical-output — 雙程驗法generate-statistical-tables — 公示備之統表review-software-architecture — 碼構與設審