KI-Tools & -Skripte
Datei-Vorgeschichte: Warum dieser Code so ist, aus seiner Git-Historie
Für Entwickler: Richten Sie Ihren Agenten auf eine Datei oder einen Ordner und erhalten Sie deren Vorgeschichte aus git: die Änderungen, die sie geprägt haben, was rückgängig gemacht wurde und welche Commits die heutigen Zeilen geschrieben haben; jeder Grund ist aus einem Commit zitiert oder als abgeleitet oder unbekannt markiert. قصة ملف واحد من git، وكل معلومة بمصدرها.
Das bekommst du: 1 Datei · 73.73 KB · ZIP
Kaufoptionen ansehenProduktbeschreibung
English
For developers who open a file and ask: why is this code like this?
Point your agent at one file or folder. You get back its backstory from git: the changes that shaped it, what was undone, which commits wrote today's lines, and why, with every point citing its commit.
What you get each run
backstory.md: five fixed sections: what the file does now (with line numbers), the changes that matter in date order, the changes that were undone, who wrote today's lines, and open questions.backstory.html: the same as one printable page.history.json: what the scan found, every fact with its short hash.
Every reason is labelled
- Stated: quoted word for word from the commit message, with the hash.
- Inferred: a reading of the history, said plainly as a reading, citing the commits it rests on.
- Unknown: git does not say. A message like "fix" or "wip" is never taken as a reason; it becomes an open question.
Which change wrote these lines
The agent exports the file's git log (followed across renames, with no email addresses) and its blame. A bundled Python script (standard library, read-only, no network calls, never runs git) reads those exports: commits, renames, reverts found from their messages, fixup and squash markers, ticket references, and each commit's share of today's lines.
Checked, not just written
A checker confirms every cited hash is in the export, every stated quote matches the commit message letter for letter, every reason has a label and every cited line exists. The agent fixes and checks again until no FIX is left.
Honest about its limits
It holds what git recorded. Tickets, pull request discussions and squashed history are not in the export, and the backstory says so. Revert detection reads commit messages, so a change undone by hand is found only by reading the history. The checker verifies citations, not whether the reading is right.
One file, minutes
File Backstory stays with one file or folder. For the decisions of a whole project across git, tickets, decision records and notes, use Decision Trail.
Arabic
The backstory can be written in Arabic with a right-to-left page. Quotes stay in the language of the commit message, and hashes and file names stay as they are.
In the download: SKILL.md, the scripts, references (the backstory format, the git export commands for PowerShell and bash), and a complete example so you can see the output before you buy: a money-rounding module with 25 commits over a year (a rename, a revert, fixups, terse messages) and its English and Arabic backstories.
بالعربي
للمبرمجين الذين يفتحون ملفًا ويسألون: لماذا هذا الكود هكذا؟
وجّه وكيلك إلى ملف أو مجلد واحد. تستلم قصته من git: التغييرات التي صنعته، وما أُلغي، والإيداعات التي كتبت أسطره الحالية، ولماذا، وكل نقطة معها رمز إيداعها.
ماذا تستلم في كل مرة
- ملف
backstory.md: خمسة أقسام ثابتة: ماذا يفعل الملف الآن (مع أرقام الأسطر)، والتغييرات المهمة بترتيب التاريخ، والتغييرات التي أُلغيت، ومن كتب أسطر اليوم، وأسئلة مفتوحة. - صفحة
backstory.html: الشيء نفسه كصفحة واحدة قابلة للطباعة. - ملف
history.json: ما وجده الفحص، وكل معلومة مع رمز إيداعها.
كل سبب له وصف
- مذكور: منقول حرفيًا من رسالة الإيداع، مع رمزه.
- مستنتج: قراءة للتاريخ، مكتوب بوضوح أنه قراءة، مع الإيداعات التي يستند إليها.
- غير معروف: git لا يقول. رسالة مثل "fix" أو "wip" لا تُعتبر سببًا أبدًا، بل تصير سؤالًا مفتوحًا.
أي تغيير كتب هذه الأسطر
يصدّر الوكيل سجل git للملف (عبر تغييرات الاسم، وبلا عناوين بريد) وناتج blame. وسكربت بايثون مرفق (يقرأ فقط، بلا اتصال بالشبكة، ولا يشغّل git) يقرأ هذه الملفات: الإيداعات، وتغييرات الاسم، والإلغاءات من رسائلها، وعلامات fixup وsquash، وأرقام التذاكر، ونصيب كل إيداع من أسطر اليوم.
مدقَّق، لا مكتوب فقط
أداة فحص تتأكد أن كل رمز إيداع مذكور موجود في الملف المصدَّر، وكل اقتباس يطابق رسالة الإيداع حرفًا بحرف، ولكل سبب وصفه، وكل سطر مذكور موجود. يصلح الوكيل ويعيد الفحص حتى لا يبقى أي FIX.
صادق في حدوده
يحمل ما سجّله git فقط. التذاكر ونقاشات طلبات الدمج والتاريخ المضغوط ليست في الملف المصدَّر، والقصة تذكر ذلك. والأداة تتحقق من المصادر، لا من صحة القراءة.
ملف واحد، في دقائق
هذه المهارة لملف أو مجلد واحد. لقرارات مشروع كامل عبر git والتذاكر وسجلات القرار والمحاضر، استعمل Decision Trail.
العربية
تُكتب القصة بالعربي في صفحة من اليمين إلى اليسار. الاقتباسات تبقى بلغة رسالة الإيداع، ورموز الإيداع وأسماء الملفات كما هي.
داخل الملف: ملف SKILL.md، والسكربتات، والمراجع، ومثال كامل لترى النتيجة قبل الشراء: وحدة تقريب مبالغ بـ25 إيداعًا خلال سنة، وقصتها بالإنجليزي والعربي.
Questions / أسئلة
Does it change my repository? / هل يغيّر مستودعي؟
No. The agent runs only read-only git commands (log, blame, show) and saves their output; the scripts read those files and run nothing. لا، أوامر git للقراءة فقط.
Does it make up reasons? / هل يخترع أسبابًا؟
No. A stated reason is a quote the checker matches against the commit message. A reading is labelled inferred, and a terse message such as "fix" makes the reason unknown. لا، السبب المذكور اقتباس تتحقق منه أداة الفحص.
How is it different from Decision Trail? / ما الفرق بينها وبين Decision Trail؟
File Backstory answers for one file or folder from git alone, in minutes, and says which commit wrote today's lines. Decision Trail reconstructs a whole project's decisions from git, tickets, decision records and notes. هذه لملف واحد من git، وتلك لقرارات المشروع كله.
Does it show email addresses? / هل يظهر عناوين البريد؟
No. The export commands leave them out, and the checker fails a backstory that contains one. لا، أوامر التصدير تستبعدها.
Will it find every undone change? / هل يجد كل تغيير أُلغي؟
It finds reverts from their commit messages. A change undone by hand is found only when the agent reads the history, and the backstory says how it was found. يجد الإلغاءات من رسائلها، وما أُلغي يدويًا يجده الوكيل بقراءة التاريخ.
Does it work on Windows? / هل يعمل على ويندوز؟
Yes. The export commands are given for PowerShell and for bash, and the files stay UTF-8. نعم، الأوامر مكتوبة لـ PowerShell وbash.
Can it be in Arabic? / هل يكون بالعربي؟
Yes, as an added option: a right-to-left page. Quotes stay in the language of the commit message. نعم، والاقتباسات تبقى بلغة رسالة الإيداع.
Das bekommst du
1 Datei · 73.73 KB
- file-backstory-1.0.0.zipZIP · 73.73 KB
KI-Tools & -Skripte
Datei-Vorgeschichte: Warum dieser Code so ist, aus seiner Git-Historie
Für Entwickler: Richten Sie Ihren Agenten auf eine Datei oder einen Ordner und erhalten Sie deren Vorgeschichte aus git: die Änderungen, die sie geprägt haben, was rückgängig gemacht wurde und welche Commits die heutigen Zeilen geschrieben haben; jeder Grund ist aus einem Commit zitiert oder als abgeleitet oder unbekannt markiert. قصة ملف واحد من git، وكل معلومة بمصدرها.
Getly hat die hochgeladenen Dateien geöffnet und nichts gefunden, was das Öffnen verhindern würde. Das ist kein Virenscan und keine Qualitätsbewertung.
Tags
Häufige Fragen
Erhalte ich sofort Zugriff?
Ja. Dies ist ein digitales Produkt - du kannst es direkt nach dem Kauf aus deiner Bibliothek herunterladen.
Darf ich es für kommerzielle Projekte nutzen?
Ja. Kommerzielle Nutzung ist erlaubt: im eigenen Business und in dem, was du verkaufst. Die Datei selbst darfst du nicht weiterverkaufen oder verbreiten.
Wie sind die Rückerstattungsbedingungen?
Du kannst innerhalb von 30 Tagen eine Rückerstattung anfordern. Stimmt etwas nicht, fordere sie bei deiner Bestellung an - das Getly-Team prüft sie.
Welche Dateiformate und -größen erhalte ich?
Du lädst 1 Datei herunter - ZIP - insgesamt 73.73 KB.
Erhalte ich kostenlose Updates?
Ja - wenn der Verkäufer eine neue Version veröffentlicht, kannst du die aktuellen Dateien kostenlos erneut aus deiner Bibliothek herunterladen. Aktuelle Änderungen findest du im Changelog.
Preis
$5.00



