mirror of
https://github.com/tiennm99/blog.git
synced 2026-10-11 03:13:10 +00:00
tiennm99
e8451d8c24
One Go binary with a subcommand per former script, invoked as 'go run ./scripts/newsletter <command>' from repo root. Stdlib only; publications config embedded via go:embed (go run recompiles on edit). Behavior parity verified side-by-side before deleting the JS — see plans/reports/parity-260818-newsletter-go-migration-report.md. Permissions: allow 'Bash(go *)', drop 'Bash(node *)' and the redundant 'Write(content)' rule (Edit rules cover all file-editing tools).
2.6 KiB
2.6 KiB
name, description
| name | description |
|---|---|
| mt-add-post | Article handler for the Hugo blog newsletter. Adds a single article/blog URL to today's newsletter as a main-content entry with the original source title and a Vietnamese summary. Normally invoked by the mt-add-url meta skill after classification, but can be used directly for a known article URL. |
Overview
mt-add-post is the article handler: given a clean article/blog URL, it extracts the source title and content, writes a Vietnamese summary, and inserts it into today's newsletter main content. It does not classify or route URLs — that is mt-add-url's job. For YouTube/images/other types, use mt-add-url.
Shared scripts: scripts/newsletter/. Shared procedure: ../mt-add-url/references/newsletter-post-mechanics.md (find/create today's post, newsletter numbering, section insertion, language rules) — follow it for all post mechanics.
Input
A clean article URL (passed by mt-add-url, or given directly). If a raw URL is provided directly, you may run the classifier to clean/dedup it first:
go run ./scripts/newsletter add-url "<url>"
Trust route: article; skip if duplicate or not accessible.
Workflow
- Post mechanics — follow
../mt-add-url/references/newsletter-post-mechanics.mdto find/create today's post and (if new) get the newsletter number + apply the template. - Extract the original article title and main content. Preserve the source title exactly enough to remain recognizable: do not translate/localize it; keep source-language wording, capitalization, punctuation, and proper nouns from metadata (
og:title, page title, or fetcher frontmatter). - Summarize in Vietnamese — 1-2 paragraphs, max 300 words, professional tone for junior developers. Optionally add 3-5 key points.
- Write the main-content block and insert it before the
### Bonussection (or append at end of file if there is no Bonus yet — do not create an empty Bonus):
## [Original article title](clean_url)
[Tóm tắt tiếng Việt — tối đa 300 từ]
**Điểm chính:**
- [Ý chính 1]
- [Ý chính 2]
- Report:
✅ Article added to Newsletter #[number]
📄 content/post/YYYY/MM/DD/index.md
🔗 [clean_url]
Checklist
- Valid Hugo front matter (if post was created) with correct date
- Title
"Newsletter #[number]"(if created) - Tags include
"AI-Assisted" - URL is clean (no tracking params)
- Heading uses the original source article title, not a Vietnamese translation
- Vietnamese content ≥99%, grammar correct
- Article inserted before the Bonus section