dekiru-data_migration 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5428a8cf5e2a02ff63e8b5a7d3dd2703cf471f60a7bf1dfdd289418a93f1bca
-  data.tar.gz: d0b1afb0f2d5bad6112849c8f046e90c309a19eddde473bde1cf179e8e2a395a
+  metadata.gz: 342d506a7d85aa5b54c2023c5bdd2f13d7ccc968e562bde836571461e67541c8
+  data.tar.gz: a30d3c9877ac51fac63dd7a0d69333750e453cd5020ae398b1361428d1185a68
 SHA512:
-  metadata.gz: 30e87b497f402579cac1d212f0cc9e12ba4bf8bcc84166de33dbbf9619f9da734c5d468d115801db0b326cffc7dfe09e4ca21b1b7e2c818ecf4848e18bf7c894
-  data.tar.gz: f5a5b31881fe7485d18ffea31950d70b4a5a05a7f5defd44197ec87b78c454a8db707be376825fc28a010c9f95d0c9584beb50f14965cc508fa211602d4bd226
+  metadata.gz: 19478e294f25f04c5757bd1118f9786bd285b1fbb802a9f91aed81db88fb37503c03ef954c30c6e3d1a7c4476c32a6378c499092a68f786ff5dfb17a4903f2d8
+  data.tar.gz: bc354a7e66c1960dde53c49ded487dd4ad4a8b9d6cd0e1852f82c8b94f20bdb08f6565329ee751de9622cefd984fa9f3a7771b9feeb71d945e9aa144874d0049

data/README.md

@@ -290,3 +290,21 @@ Executes `find_each` with a progress bar for ActiveRecord scopes.
 
 ### `each_with_progress(enum, options = {}, &block)`
 Executes processing with a progress bar for any Enumerable objects.
+
+## Agent Skills
+
+This repository provides an agent skill for creating data migration scripts.
+
+### Available Skills
+
+#### `data-migration-script`
+
+Automatically creates data migration and deletion scripts using the `dekiru-data_migration` gem.
+
+**Triggers**: The agent will use this skill when you ask to "create a data migration script", "create a script to delete unnecessary records", or similar requests involving DB operations via scripts (bulk updates, deleting orphaned records, deleting ActiveStorage files, etc.).
+
+**Install**:
+
+```bash
+gh skill install SonicGarden/dekiru-data_migration
+```

data/lib/dekiru/data_migration/version.rb

@@ -2,6 +2,6 @@
 
 module Dekiru
   module DataMigration
-    VERSION = "1.0.0"
+    VERSION = "1.1.0"
   end
 end

data/skills/data-migration-script/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: data-migration-script
+description: Skill for creating data migration and deletion scripts using the dekiru-data_migration gem in the social-apartment project. Always use this skill when asked to "create a script using dekiru-data_migration", "create a data migration script", "create a script to delete unnecessary records", or "turn this into a script". Use proactively for DB operations via scripts such as deleting orphaned records after feature removal or code changes, bulk data updates, and deleting ActiveStorage files.
+license: MIT
+---
+
+# Data Migration Script Creation
+
+Create data migration and deletion scripts using the `dekiru-data_migration` gem.
+
+## Preliminary Research
+
+Before writing a script, confirm the following:
+
+1. **Understand the changes**: Review related Issues and PRs to understand what was deleted or changed
+2. **Identify target records**: Check the schema (`db/schema.rb`) and current model code to identify the conditions for records that need to be deleted or updated
+
+## Script Creation Steps
+
+### 1. Generate a file with the generator
+
+```bash
+bin/rails generate maintenance_script <PascalCaseName>
+```
+
+- `<PascalCaseName>` is the name describing the operation in PascalCase (e.g., `DeleteDeliveryNotificationImages`)
+- Generated file: `scripts/YYYYMMDD_delete_delivery_notification_images.rb`
+- Today's date (8 digits) is automatically appended to the class name
+
+### 2. Edit the generated file
+
+Implement `migration_targets` and `migrate_record` in the generated file.
+
+### Common Operation Patterns
+
+**Deleting ActiveStorage attachments**:
+```ruby
+def migration_targets
+  ActiveStorage::Attachment.where(record_type: 'ModelName', name: 'attachment_name')
+end
+
+def migrate_record(record)
+  record.purge  # synchronously delete attachment and blob
+end
+```
+
+**Updating record attributes**:
+```ruby
+def migrate_record(record)
+  record.update!(attribute: new_value)
+end
+```
+
+**Deleting records**:
+```ruby
+def migrate_record(record)
+  record.destroy!
+end
+```
+
+**Conditional skip**:
+```ruby
+def migrate_record(record)
+  return if record.some_condition?
+  record.update!(...)
+end
+```
+
+## Execution and Verification Commands
+
+```bash
+# Check target record count (before execution)
+bin/rails runner "p TargetModel.where(...).count"
+
+# Run the script
+bin/rails runner scripts/YYYYMMDD_description.rb
+
+# Verify after execution
+bin/rails runner "p TargetModel.where(...).count"
+```
+
+## Notes
+
+- `purge` deletes synchronously (immediately removes from storage). Use `purge_later` for async deletion
+- `migration_targets` must return an ActiveRecord relation (processed in batches via `find_each`)
+- Always verify the target record count before running in production

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dekiru-data_migration
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - SonicGarden
 bindir: exe
 cert_chain: []
-date: 2025-06-30 00:00:00.000000000 Z
+date: 2026-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -65,6 +65,7 @@ files:
 - sig/dekiru/data_migration.rbs
 - sig/dekiru/data_migration/migration.rbs
 - sig/dekiru/data_migration/operator.rbs
+- skills/data-migration-script/SKILL.md
 homepage: https://github.com/SonicGarden/dekiru-data_migration
 licenses:
 - MIT