Artefak GitHub Issues memberi tempat tetap bagi rencana kerja
Kode ada di pull request, tetapi alasannya bisa terkubur di percakapan lama. Jika hasil riset agen tersimpan terpisah, orang berikutnya mungkin mengulanginya. Pada 28 Oktober, GitHub memperkenalkan pratinjau publik issue artifacts untuk menempelkan konteks langsung pada pekerjaan terkait.
Percakapan dan dokumen yang berkembang punya peran berbeda
Artefak bisa berupa dokumen Markdown, tautan eksternal, atau HTML: analisis akar masalah, prototipe, maupun diskusi Slack dan Teams. Di github.com, artefak dapat dibuat dan diedit dengan riwayat versi. Ini berbeda dari artefak GitHub Actions yang merupakan keluaran eksekusi workflow.
Bayangkan contoh fiktif pembayaran yang diproses dua kali. Komentar menampung pengamatan baru; rencana mencatat kunci percobaan ulang dan eksperimen yang belum dilakukan. Gambar pertama dibuat khusus untuk artikel ini, bukan tangkapan layar GitHub. Memisahkan fakta dan dugaan membantu mencegah asumsi menjadi persyaratan.
Lampirkan berkas dan rawat konteks yang sama
gh issue artifact create menerima nomor atau URL issue diikuti berkas atau tautan. gh issue artifact create 42 retry-plan.md -R OWNER/REPO akan melampirkan berkas ke issue 42. Nilainya hanya contoh; menjalankannya menulis ke issue. Perintah ini tidak dijalankan untuk artikel.
Nama dapat mengikuti berkas atau ditentukan dengan --name. --body-file membaca isi satu dokumen dan --attach mendukung gambar serta video. gh issue artifact edit 42 1 --body-file retry-plan.md -R OWNER/REPO mengganti isinya. Gambar kedua menunjukkan sintaks, bukan hasil unggahan.
Rencana terbaru tetap memiliki jejak perubahan
edit mengganti nama atau isi, bukan tipe. --restore-version menyimpan nama dan isi versi lama sebagai versi baru; view menampilkan riwayat edit. Rencana terkini tidak harus menghapus jalan menuju keputusan tersebut.
Dalam contoh pembayaran, dugaan awal timeout mungkin bergeser ke penanganan kunci ganda. Memperbarui rencana dan menautkan komentar alasannya merupakan saran pengelolaan dokumen, bukan perilaku otomatis. Dokumen tetap memerlukan bukti yang mendukung kesimpulannya.
Dukungan HTML berbeda di setiap antarmuka
Pengumuman menjelaskan peralihan antara pratinjau HTML dan sumber. Namun pembuatan serta tampilan HTML di GitHub App masih disebut akan hadir. Penempelan otomatis hasil sesi tidak berarti seluruh dukungan HTML tersedia di semua tempat. CLI juga masih pratinjau.
Nilainya ada pada lokasi konteks, bukan banyaknya dokumen. Coba satu rencana yang sudah ada dan lanjutkan riwayatnya saat revisi berikutnya. Sumber resmi di bawah menjelaskan batas dukungan saat ini.