المهارات safe-refactor
📦

safe-refactor

v1.0 مراجعة المحتوى r1 آمن ⚙️ الأوامر الخارجية

Refactor Code with Tests and Small Changes

Code cleanup can introduce behavior changes that are difficult to detect. This skill guides small refactoring steps with baseline tests, dependency checks, and repeated verification.

يدعم: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 برونزي

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل
Review the Skillstore skill "safe-refactor" from https://skillstore.io/skills/agentkitco-safe-refactor.md and its manifest at https://skillstore.io/api/skills/agentkitco-safe-refactor/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

اختبرها

جارٍ استخدام "safe-refactor". Extract duplicated validation from two functions without changing their behavior.

النتيجة المتوقعة:

  • Boundary: preserve validation order, error messages, and return values.
  • Baseline: relevant tests passed before editing.
  • Change: extracted the shared validation logic in one reviewable step.
  • Verification: relevant tests and lint passed after extraction.
  • Left unchanged: an unrelated naming inconsistency.

جارٍ استخدام "safe-refactor". Restructure a legacy parser that has no tests.

النتيجة المتوقعة:

  • Characterization tests added for representative valid and invalid inputs.
  • Baseline behavior recorded, including existing error messages.
  • Restructuring completed in separate, verified steps.
  • Uncertainty: large input performance was not exercised.
  • Observed bug reported separately and left unchanged.

التدقيق الأمني

آمن

All three static findings are false positives: Markdown command references are not Ruby execution, and the completion report is not system reconnaissance. No evidence found of prompt injection, data exfiltration, or malicious intent in SKILL.md.

1
الملفات التي تم فحصها
38
الأسطر التي تم تحليلها
0
عناصر المراجعة
0
تم تجاهل الإيجابيات الكاذبة

عوامل الخطر

⚙️ الأوامر الخارجية (2)
لم يكتشف أحدث تدقيق ثابت ودلالي مكتمل أي نتائج أمنية مؤكدة. ولا يثبت ذلك أن المهارة خالية من الآثار الجانبية.
شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار
تقييم الأمان

نسخ رابط التقرير

https://skillstore.io/skills/agentkitco-safe-refactor/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/agentkitco-safe-refactor/security.svg)](https://skillstore.io/skills/agentkitco-safe-refactor?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/agentkitco-safe-refactor?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/agentkitco-safe-refactor/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/agentkitco-safe-refactor.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

agentkitco. (2026). safe-refactor security audit report (audit version 2) [Author version 1.0]. Skillstore. https://skillstore.io/skills/agentkitco-safe-refactor/audits/2

اقتباس BibTeX

@techreport{agentkitco-agentkitco-safe-refactor-2026, author = {agentkitco}, title = {safe-refactor security audit report (audit version 2)}, institution = {Skillstore}, year = {2026}, number = {2}, url = {https://skillstore.io/skills/agentkitco-safe-refactor/audits/2}, note = {Author version 1.0} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "safe-refactor security audit report (audit version 2)" version: "1.0" type: report authors: - name: "agentkitco" date-released: "2026-10-22" url: "https://skillstore.io/skills/agentkitco-safe-refactor/audits/2" identifiers: - type: other value: "skillstore:agentkitco-safe-refactor:audit:2" description: "Skillstore immutable audit report identifier"

مقارنة المتغيرات

2 متغيرات قابلة للتثبيت

تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.

سبب تصدر هذا المتغير

تمت صيانته مؤخراً
agentkitco موصى به الحالي

agentkitco-safe-refactor

تقييم Skillstore 78
موثوقية الأدلة متوسط
استخدام Skillstore 9
تم التحديث

2026-10-22

juliusbrussee-safe-refactor

تقييم Skillstore 78
موثوقية الأدلة متوسط
استخدام Skillstore 9
تم التحديث

2026-09-09

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: متوسط
55
الهندسة المعمارية
85
قابلية الصيانة
87
المحتوى
65
المجتمع
91
الامتثال للمواصفات

ما الذي يمكنك بناؤه

Clean Up a Working Module

Extract duplicated logic while preserving outputs, error messages, logging, and edge cases through small, verified edits.

Protect Legacy Behavior

Add characterization tests before restructuring code that lacks coverage, and document behavior that remains unverified.

Review a Shared API Rename

Identify callers and dependents before renaming exported symbols, and request approval when compatibility requires a breaking change.

جرّب هذه الموجّهات

Assess a Refactoring Task
Use safe-refactor to assess [module]. State the goal, behavior boundaries, existing tests, and baseline results before proposing any edits.
Extract Repeated Logic
Use safe-refactor to extract repeated logic in [file]. Preserve behavior, make one change per step, and run relevant tests after each step.
Characterize Untested Code
Use safe-refactor on [legacy module]. Add characterization tests for realistic inputs before restructuring. Preserve current errors and ordering, and report coverage gaps.
Plan a Shared Symbol Rename
Use safe-refactor to rename [exported symbol]. Check all callers and dependents, propose a deprecation path, and request approval before any API break.

أفضل الممارسات

  • Define behavior boundaries and record baseline failures before editing.
  • Add characterization tests before restructuring untested behavior.
  • Review each small diff and verify that rollback preserves pre-existing user edits.

تجنب

  • Mixing refactoring with bug fixes, features, or dependency upgrades.
  • Continuing through failing tests instead of undoing the last step and reducing its scope.
  • Changing public APIs without approval or a deprecation path.

الأسئلة المتكررة

What does this skill provide?
It provides a structured workflow for behavior-preserving refactoring, including test baselines, dependency checks, incremental edits, and a final report.
What happens when the code has no tests?
The workflow calls for characterization tests that record current behavior before refactoring begins.
Does it guarantee identical behavior?
No. Verification depends on test coverage and available checks, and the final report must identify behavior that remains uncertain.
Can it fix bugs during a refactor?
It directs the assistant to report discovered bugs and handle fixes as separate changes.
When does it ask for user input?
It asks when tests cannot run, baseline failures are unexplained, a public API break is needed, or a real bug is found.
Does it require a specific programming language?
No specific language is required. The host assistant must use the existing project tests, type checker, or linter.

تفاصيل المطور

المؤلف

agentkitco

الترخيص

MIT

إصدار المؤلف

v1.0

مراجعة Skillstore

r1

تنبيه الإصدار

الإصدار الذي أعلنه المؤلف ليس SemVer صالحًا.

مرجع

18efac79a818d7e997295839638fdd21906cfd1c

حداثة الصيانة

٢٢‏/١٠‏/٢٠٢٦

الاستخدام

5 تنزيلات · 0 مشاهدات

بنية الملفات

📄 SKILL.md