heraspec 0.1.16 → 0.1.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -63
- package/bin/heraspec.js +587 -31
- package/bin/heraspec.js.map +2 -2
- package/dist/commands/create.d.ts +1 -0
- package/dist/core/config.d.ts +1 -1
- package/dist/core/init.d.ts +4 -0
- package/dist/core/schemas/base.schema.d.ts +3 -0
- package/dist/core/schemas/spec.schema.d.ts +2 -0
- package/dist/core/templates/skills/content-channel/content-compliance/skill.md +83 -0
- package/dist/core/templates/skills/content-channel/content-prompts/skill.md +74 -0
- package/dist/core/templates/skills/content-channel/content-scaffolding/skill.md +82 -0
- package/dist/core/templates/skills/content-channel/content-scripting/skill.md +147 -0
- package/dist/core/templates/skills/content-channel/content-strategy/skill.md +78 -0
- package/dist/core/templates/skills/content-channel/content-vault-sync/skill.md +74 -0
- package/dist/core/templates/skills/content-channel/content-voice-adapter/skill.md +143 -0
- package/dist/core/templates/skills/content-channel/skill.md +127 -0
- package/dist/index.js +229 -16
- package/package.json +3 -3
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: content-voice-adapter
|
|
3
|
+
description: Transmute and adapt any arbitrary raw content, article, or idea to match the specific DNA, philosophy, tone of voice, and TTS acoustic standards of any designated channel.
|
|
4
|
+
projectType: content-channel
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Skill: Content Voice Adapter
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Take any arbitrary raw content (raw article, folk story, health tip, social post, quote, reflection, or rough draft) and transmute it through a target channel's **Specific Philosophical Lens & Tone of Voice**, eliminating genre-specific off-brand elements, reframing the core insight, and restructuring it into MTxStudio's standardized 6-part video script schema.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## The Dynamic Transmutation Framework
|
|
15
|
+
|
|
16
|
+
Content transmutation is **NOT one-size-fits-all**. What constitutes "off-brand" (lệch tone) and how content is restructured completely change depending on the channel's niche, target audience, and legal constraints.
|
|
17
|
+
|
|
18
|
+
```text
|
|
19
|
+
┌────────────────────────────────────────────────────────────────────────┐
|
|
20
|
+
│ 1. CONTENT EXTRACTION & DYNAMIC DE-BIASING │
|
|
21
|
+
│ - Extract core human insight, story premise, or practical value │
|
|
22
|
+
│ - Purge genre-specific negative triggers via De-biasing Matrix │
|
|
23
|
+
│ (e.g., horror: purge real place names & gore; healing: purge │
|
|
24
|
+
│ fatalism & victimhood; health: purge pseudoscience/overpromising)│
|
|
25
|
+
└───────────────────────────────────┬────────────────────────────────────┘
|
|
26
|
+
│
|
|
27
|
+
┌───────────────────────────────────▼────────────────────────────────────┐
|
|
28
|
+
│ 2. CHANNEL DNA REFRAMING & VOICE PERSONA │
|
|
29
|
+
│ - Reframe core insight through channel philosophy & narrative lens │
|
|
30
|
+
│ - Adapt persona pronouns (I - You / We / 3rd-person narrator) │
|
|
31
|
+
│ - Map vocabulary domain & signature metaphors to audience archetype │
|
|
32
|
+
└───────────────────────────────────┬────────────────────────────────────┘
|
|
33
|
+
│
|
|
34
|
+
┌───────────────────────────────────▼────────────────────────────────────┐
|
|
35
|
+
│ 3. GENRE-AWARE TTS ACOUSTIC ADAPTATION │
|
|
36
|
+
│ - Enforce sentence pacing: 12-20 words/sentence, 8-12 words/clause │
|
|
37
|
+
│ - Pacing style: Chilling suspense (horror) vs. Gentle warmth │
|
|
38
|
+
│ (healing) vs. Clear instructional (health) vs. Rhythm/rhyme (poem)│
|
|
39
|
+
│ - Prevent Reduplicative Looping, zero artificial tags │
|
|
40
|
+
│ - Preserve \n newline for rhythmic verse and breathing pauses │
|
|
41
|
+
└───────────────────────────────────┬────────────────────────────────────┘
|
|
42
|
+
│
|
|
43
|
+
┌───────────────────────────────────▼────────────────────────────────────┐
|
|
44
|
+
│ 4. 6-PART SCHEMA & COMPLIANCE ASSEMBLY │
|
|
45
|
+
│ - Fatal Hook (0:00 - 0:15) tailored to format (16:9 or 9:16) │
|
|
46
|
+
│ - Audio Narration Script & Technical Audio Pacing │
|
|
47
|
+
│ - Scene-by-scene Storyboard with Midjourney/Flux Art Style Prompts │
|
|
48
|
+
│ - Facebook Caption & Engagement Hook │
|
|
49
|
+
│ - Genre-Specific Legal Disclaimer (Decree 15 / Medical / Financial) │
|
|
50
|
+
└────────────────────────────────────────────────────────────────────────┘
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Dynamic De-biasing Matrix (Niche-Specific Negative Filtering)
|
|
56
|
+
|
|
57
|
+
When transmuting content, the AI agent MUST consult this matrix to apply the exact negative filtering criteria required for the target niche:
|
|
58
|
+
|
|
59
|
+
| Channel Niche | Reference Channel | Negative Constraints to Purge ("Off-Brand") | Target Transmutation Direction |
|
|
60
|
+
| :--- | :--- | :--- | :--- |
|
|
61
|
+
| **Healing & Psychology** | *Làm Bạn Với Bản Thân*, *An Trú Quán* | ❌ Superstition, fate-blaming, resentment, victim mindset, moral preaching | ✅ Turning inward, acknowledging wounds, emotional boundary setting, inner peace |
|
|
62
|
+
| **Horror & Paranormal** | *Truyện Ma Đêm Mưa* | ❌ Gratuitous gore, real names of temples/pagodas/people (Decree 15 violation), frivolous disrespect, black magic curses | ✅ Safe atmospheric fiction, psychological suspense, eerie mood, karmic retribution, ethical closure |
|
|
63
|
+
| **Health & Wellness** | *Thân An Tâm Lạc* | ❌ Miracle cures, 100% cure guarantees, anti-medical advice, diagnosing diseases, fearmongering | ✅ Everyday safe wellness, gentle stretching, mindful tea/diet, respecting medical guidance |
|
|
64
|
+
| **Life Reflection** | *Góc Chiêm Nghiệm* | ❌ Cynical whining, abstract academic lecturing, impractical theories, hatred or malice | ✅ Pragmatic fortitude, human psychological insight, mindful living, calm composure under adversity |
|
|
65
|
+
| **Philosophy & Zen** | *Tĩnh Tâm Quán* | ❌ Wealth-worship rituals, superstitious fortune telling, sectarian disputes, judging other groups | ✅ Compassionate wisdom, letting go of distress, filial piety to parents, karmic mindfulness |
|
|
66
|
+
| **Poetry & Nostalgia** | *Năm Năm Tháng Tháng* | ❌ Abrupt modern slang, excessive melodrama, bitter resentment toward the past, broken meter | ✅ Lyrical verse / poetic prose, honoring family memories, pure bittersweet nostalgia, musical cadence |
|
|
67
|
+
| **Finance & Business** | *Tài Chính Thực Chiến* | ❌ Guaranteed ROI, get-rich-quick schemes, multi-level marketing, exaggerated product claims | ✅ Prudent money management, investment discipline, objective product evaluation |
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Channel DNA Profiles
|
|
72
|
+
|
|
73
|
+
### 1. Làm Bạn Với Bản Thân (`lam_ban_voi_ban_than`)
|
|
74
|
+
* **Core Philosophy**: "A sanctuary for weary hearts to let go of external expectations and cultivate inner peace."
|
|
75
|
+
* **Persona**: Compassionate, non-judgmental companion.
|
|
76
|
+
* **Transmutation Example**:
|
|
77
|
+
- *Raw*: "You are destined by fate to be alone until your past karmic debt is paid..."
|
|
78
|
+
- ➔ *Transmuted*: "Solitude is a sacred space where you learn to honor your self-worth, set healthy emotional boundaries, and become your own truest friend first."
|
|
79
|
+
* **Audio Voice**: Warm female, slow 112-116 wpm, Lo-fi acoustic solo piano.
|
|
80
|
+
* **Visual Style**: Minimalist pastel watercolor, cozy indoor warmth, gentle natural morning light.
|
|
81
|
+
|
|
82
|
+
### 2. Truyện Ma Đêm Mưa (`truyen_ma_dem_mua`)
|
|
83
|
+
* **Core Philosophy**: "Telling chilling midnight tales - Karma never misses anyone."
|
|
84
|
+
* **Persona**: Mysterious late-night storyteller with a deep, atmospheric voice and an unwavering moral compass.
|
|
85
|
+
* **Transmutation Example**:
|
|
86
|
+
- *Raw*: Forum story mentioning real pagoda names, graphic torture, and black magic vengeance.
|
|
87
|
+
- ➔ *Transmuted*: Fictionalized story setting (Pagoda T., Village K.), focusing on eerie suspense, psychological fear, and a righteous karmic resolution.
|
|
88
|
+
* **Audio Voice**: Deep male baritone, 118 wpm, Dark Ambient cello, ominous sub-bass.
|
|
89
|
+
* **Visual Style**: Dark cinematic, heavy shadows, flickering candlelight, foggy twilight.
|
|
90
|
+
|
|
91
|
+
### 3. Tĩnh Tâm Quán (`tinh_tam_quan`)
|
|
92
|
+
* **Core Philosophy**: "A daily verse of mindfulness - Sowing wholesome seeds, letting go of sorrow."
|
|
93
|
+
* **Persona**: Serene spiritual mentor, dignified, deeply compassionate.
|
|
94
|
+
* **Transmutation Example**: Converts daily grievances and rivalry into lessons on releasing grudges, honoring parents, and practicing mindfulness.
|
|
95
|
+
* **Audio Voice**: Mature male, measured 115 wpm, temple bells, bamboo flute.
|
|
96
|
+
* **Visual Style**: Traditional Zen ink wash painting (thủy mặc), misty mountains, white lotus.
|
|
97
|
+
|
|
98
|
+
### 4. Góc Chiêm Nghiệm (`goc_chiem_nghiem`)
|
|
99
|
+
* **Core Philosophy**: "Pausing amidst the rush - To understand human nature and stride forward with fortitude."
|
|
100
|
+
* **Persona**: Seasoned, poised observer of life, realistic yet never bitter.
|
|
101
|
+
* **Transmutation Example**: Reframes social setbacks into self-reliance, emotional resilience, and calm composure without blaming circumstances.
|
|
102
|
+
* **Audio Voice**: Neutral, poised, 120 wpm, modern acoustic guitar and cello.
|
|
103
|
+
* **Visual Style**: Urban cafe aesthetic, dusk streetlights, warm coffee tones.
|
|
104
|
+
|
|
105
|
+
### 5. Thân An Tâm Lạc (`than_an_tam_lac`)
|
|
106
|
+
* **Core Philosophy**: "When the body is at ease, the mind finds joy - Small daily habits for a tired body."
|
|
107
|
+
* **Persona**: Attentive wellness practitioner promoting harmony with nature.
|
|
108
|
+
* **Transmutation Example**: Converts exaggerated health hacks into safe relaxation habits (foot baths, acupressure, deep breathing) paired with medical disclaimers.
|
|
109
|
+
* **Audio Voice**: Warm, gentle, relaxed 120 wpm, singing bowls, trickling water sound.
|
|
110
|
+
* **Visual Style**: Organic herbal textures, tea ceremony, morning forest sun.
|
|
111
|
+
|
|
112
|
+
### 6. Năm Năm Tháng Tháng (`nam_nam_thang_thang`)
|
|
113
|
+
* **Core Philosophy**: "Drifting through months and years, gathering memories into verse."
|
|
114
|
+
* **Persona**: Nostalgic traveler cherishing childhood memories and vintage heirlooms.
|
|
115
|
+
* **Transmutation Example**: Transmutes past hardships and nostalgia into six-eight (*lục bát*) verse or poetic prose honoring parental devotion.
|
|
116
|
+
* **Audio Voice**: Slow rhythmic cadence 110 wpm, acoustic nylon guitar, rain sounds.
|
|
117
|
+
* **Visual Style**: Vintage watercolor, sepia rustic village, retro film photography.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Universal Activation Prompt Template
|
|
122
|
+
|
|
123
|
+
Copy and use this prompt when adapting any raw draft for **any channel**:
|
|
124
|
+
|
|
125
|
+
```text
|
|
126
|
+
Use skill content-voice-adapter to transmute the raw text below into a production-ready Video Script for channel [CHANNEL_NAME] (Niche: [CHANNEL_NICHE]):
|
|
127
|
+
|
|
128
|
+
[PASTE RAW INPUT TEXT HERE]
|
|
129
|
+
|
|
130
|
+
Execution Requirements across 4 Steps:
|
|
131
|
+
1. Dynamic De-biasing:
|
|
132
|
+
- Extract core insight and purge all off-brand elements based on the De-biasing Matrix: [List negative constraints, e.g., victim mindset / superstitious fatalism / medical overpromising / graphic gore].
|
|
133
|
+
2. Channel DNA Reframing:
|
|
134
|
+
- Persona Pronouns: [e.g., Tôi - Bạn / Chúng ta / 3rd-person].
|
|
135
|
+
- Target Emotional State: [e.g., Inner Peace / Gripping Suspense / Soothed Relaxation / Fortitude].
|
|
136
|
+
3. TTS Acoustic Optimization:
|
|
137
|
+
- Sentence length strictly 12-20 words, comma clauses 8-12 words, zero duplicate reduplicative words.
|
|
138
|
+
- ZERO artificial bracket tags ([breath], [sigh], etc.).
|
|
139
|
+
- Preserve \n newline for poetry or rhythmic breathing.
|
|
140
|
+
4. MTxStudio 6-Part Schema Packaging:
|
|
141
|
+
- Generate: Fatal Hook, Spoken Narration Script, Visual Storyboard Prompts (English, matching channel art style), Facebook Caption, and Genre-Specific Legal Disclaimer.
|
|
142
|
+
- Spoken script and captions in Vietnamese; Visual Prompts in English.
|
|
143
|
+
```
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: content-channel
|
|
3
|
+
description: Enterprise guidelines and skill suite for multi-channel social video/audio content production, channel DNA development, AI voice synthesis optimization, and MTxStudio vault integration.
|
|
4
|
+
projectType: content-channel
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Content & Multi-Channel Production Framework
|
|
8
|
+
|
|
9
|
+
This skill suite serves as the authoritative framework for developing, scaling, and managing multi-channel content operations across Facebook, YouTube, TikTok, and Podcasts, integrated directly with the desktop studio application **MTxStudio (Script & Content Vault v2)**.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Core Content Skills Ecosystem
|
|
14
|
+
|
|
15
|
+
```text
|
|
16
|
+
heraspec/skills/
|
|
17
|
+
├── content-strategy # Channel positioning, 5-pillar matrix, 14-day Cold Start, $100 RPM monetization
|
|
18
|
+
├── content-scaffolding # Standard 2-level directory tree, zero [Channel] prefix, export auto-discovery
|
|
19
|
+
├── content-scripting # Standard 6-part episode authoring, natural acoustic TTS optimization
|
|
20
|
+
├── content-voice-adapter # Raw content de-biasing and transmutation through target channel DNA
|
|
21
|
+
├── content-prompts # Cinematic AI visual prompts (Avatar, Cover, Storyboard) & Suno BGM
|
|
22
|
+
├── content-compliance # Legal safety, platform policy compliance, 3-position disclaimers
|
|
23
|
+
└── content-vault-sync # Data integrity validation, dash sanitization, MTxStudio JSON export
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 2. Inviolable Operational Rules
|
|
29
|
+
|
|
30
|
+
1. **Golden Naming Rule (Pure Brand Identity)**:
|
|
31
|
+
- ❌ **NEVER** prepend `[Channel]`, `[Kênh]`, or `Channel:` to folder names, identifiers, or titles.
|
|
32
|
+
- ✅ Use 100% pure brand names (e.g., `Làm Bạn Với Bản Thân`, `Truyện Ma Đêm Mưa`, `Thân An Tâm Lạc`, `An Trú Quán`).
|
|
33
|
+
|
|
34
|
+
2. **2-Level MTxStudio Tree Hierarchy**:
|
|
35
|
+
- Every channel repository maps into standardized subcategories:
|
|
36
|
+
- `_plan` (`type: "docs"`, icon: `Layers`)
|
|
37
|
+
- `_posts` (`type: "article"`, icon: `BookOpen`)
|
|
38
|
+
- `_prompts` (`type: "prompts"`, icon: `Sparkles`)
|
|
39
|
+
- `_music` (`type: "music"`, icon: `Radio`)
|
|
40
|
+
- `_affiliate` (`type: "docs"`, icon: `Tag`, optional)
|
|
41
|
+
|
|
42
|
+
3. **Natural Acoustic TTS Rules (Clean Voice Synthesis)**:
|
|
43
|
+
- Maintain sentence length between **12 to 20 words** (maximum 25 words).
|
|
44
|
+
- Clauses separated by commas must span **8 to 12 words**.
|
|
45
|
+
- ❌ **ABSOLUTELY NO artificial bracket tags** (e.g., `[breath]`, `[sigh]`, `[0.3s]`, `[lấy hơi]`, `[thở dài]`). Rely entirely on natural punctuation and sentence cadence.
|
|
46
|
+
- Prevent repetition loops on phonetic/reduplicative words by inserting commas and avoiding consecutive duplicate roots.
|
|
47
|
+
|
|
48
|
+
4. **Poetry & Verse Line Integrity**:
|
|
49
|
+
- Every verse line MUST occupy its own individual line (`\n`). Stanzas must be separated by an empty line (`\n\n`).
|
|
50
|
+
- ❌ NEVER collapse verse lines using `join(' ')`.
|
|
51
|
+
|
|
52
|
+
5. **3-Position Legal Disclaimer**:
|
|
53
|
+
- For sensitive categories (Horror/Supernatural, Health/Wellness, Psychology, Finance), disclaimers must be deployed in 3 spots:
|
|
54
|
+
1. Video **Intro Warning Card (0:00 - 0:04)**.
|
|
55
|
+
2. Post **Caption footer or Pinned Top Comment**.
|
|
56
|
+
3. Spoken **Audio Narration** for long-form podcasts (>10 mins).
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## 3. Quick Reference Matrix
|
|
61
|
+
|
|
62
|
+
| Goal | Target Skill | Required Input | Output Artifact |
|
|
63
|
+
| :--- | :--- | :--- | :--- |
|
|
64
|
+
| Plan and position a new channel | `content-strategy` | Channel concept, niche, target audience | 30-day `plan.md`, 5-pillar matrix, RPM KPI |
|
|
65
|
+
| Scaffold folders and initial files | `content-scaffolding` | Channel name, color, icon, slogan | Standard folders, starter post, prompts suite |
|
|
66
|
+
| Write a brand new episode script | `content-scripting` | Channel name, episode topic, pillar | Standard 6-part `posts/{index}.md` script |
|
|
67
|
+
| Transmute raw text into channel DNA | `content-voice-adapter` | Raw draft/article + Target channel | De-biased script aligned with channel voice |
|
|
68
|
+
| Generate visual prompts or Suno BGM | `content-prompts` | Channel name, script scene descriptions | Midjourney/SD prompts, Suno instrumental tags |
|
|
69
|
+
| Audit legal risk and generate disclaimers | `content-compliance` | Channel niche (Horror, Health, Healing) | Standardized legal disclaimer + Warning Card |
|
|
70
|
+
| Package and export to MTxStudio | `content-vault-sync` | Markdown posts, plans, and prompts | Clean `mtxstudio_vault_import.json` bundle |
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 4. Multi-Language Directives
|
|
75
|
+
|
|
76
|
+
- **Instruction & Meta-Logic**: All skills and operational reasoning are structured in English for maximum LLM instruction-following accuracy.
|
|
77
|
+
- **Audience-Facing Creative Content**: Generated in the channel's target language as defined in `plan.md` (e.g., Vietnamese, English, Japanese).
|
|
78
|
+
- **Visual & Audio Generation Prompts**: Always formulated in English for optimal image/music synthesis quality (Midjourney, Flux, Stable Diffusion, Suno AI).
|
|
79
|
+
- **Markdown Structural Contract**: When outputting posts for channels processed by `export_vault_json.py`, retain the required section heading literals:
|
|
80
|
+
```markdown
|
|
81
|
+
# TẬP {number}: {TITLE}
|
|
82
|
+
## 1. HOOK MỞ ĐẦU
|
|
83
|
+
## 2. KỊCH BẢN THUYẾT MINH & LỜI THOẠI CHI TIẾT
|
|
84
|
+
### PHÂN CẢNH VISUAL STORYBOARD
|
|
85
|
+
## 4. CAPTION FACEBOOK BÀI ĐĂNG
|
|
86
|
+
## 5. SẢN PHẨM AFFILIATE GẮN KÈM
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## 5. Standard Production Workflows
|
|
92
|
+
|
|
93
|
+
### Workflow A: Daily Script Adaptation from Raw Input
|
|
94
|
+
```
|
|
95
|
+
[Raw External Article / Story / Idea]
|
|
96
|
+
│
|
|
97
|
+
▼ (Activate: content-voice-adapter)
|
|
98
|
+
[De-biased, Reframed 6-Part Script Matching Channel DNA]
|
|
99
|
+
│
|
|
100
|
+
▼ (Activate: content-compliance)
|
|
101
|
+
[Attach Genre Disclaimer & Intro Warning Card Prompt]
|
|
102
|
+
│
|
|
103
|
+
▼ (Save to: Facebook/[Channel]/posts/{index}.md)
|
|
104
|
+
│
|
|
105
|
+
▼ (Activate: content-vault-sync)
|
|
106
|
+
[Run export_vault_json.py ➔ Import bundle into MTxStudio]
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Workflow B: Complete Channel Launch
|
|
110
|
+
```
|
|
111
|
+
[New Channel Concept]
|
|
112
|
+
│
|
|
113
|
+
▼ (Activate: content-strategy)
|
|
114
|
+
[30-Day Master Plan plan.md + 5 Pillars + $100 RPM Model]
|
|
115
|
+
│
|
|
116
|
+
▼ (Activate: content-scaffolding)
|
|
117
|
+
[Create 2-Level Folder Tree + Pure Brand Name + Prompts Suite]
|
|
118
|
+
│
|
|
119
|
+
▼ (Activate: content-prompts)
|
|
120
|
+
[Generate Avatar 1:1, Cover 16:9, Warning Card & Suno BGM]
|
|
121
|
+
│
|
|
122
|
+
▼ (Activate: content-scripting)
|
|
123
|
+
[Produce Episode Batches in posts/]
|
|
124
|
+
│
|
|
125
|
+
▼ (Activate: content-vault-sync)
|
|
126
|
+
[Export Master Vault Package ➔ 1-Click MTxStudio Import]
|
|
127
|
+
```
|
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { createRequire } from 'module'; const require =
|
|
1
|
+
import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
|
|
2
2
|
var __defProp = Object.defineProperty;
|
|
3
3
|
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
4
4
|
var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
|
|
@@ -36,7 +36,8 @@ var init_config = __esm({
|
|
|
36
36
|
"generic-webapp",
|
|
37
37
|
"backend-api",
|
|
38
38
|
"frontend-app",
|
|
39
|
-
"multi-stack"
|
|
39
|
+
"multi-stack",
|
|
40
|
+
"content-channel"
|
|
40
41
|
];
|
|
41
42
|
SKILLS = {
|
|
42
43
|
"wordpress-plugin": [
|
|
@@ -119,6 +120,15 @@ var init_config = __esm({
|
|
|
119
120
|
"api-contract",
|
|
120
121
|
"shared-type",
|
|
121
122
|
"integration-point"
|
|
123
|
+
],
|
|
124
|
+
"content-channel": [
|
|
125
|
+
"content-strategy",
|
|
126
|
+
"content-scaffolding",
|
|
127
|
+
"content-scripting",
|
|
128
|
+
"content-voice-adapter",
|
|
129
|
+
"content-prompts",
|
|
130
|
+
"content-compliance",
|
|
131
|
+
"content-vault-sync"
|
|
122
132
|
]
|
|
123
133
|
};
|
|
124
134
|
HERASPEC_MARKERS = {
|
|
@@ -460,6 +470,84 @@ var init_skills_template_map = __esm({
|
|
|
460
470
|
templateFileName: "wordpress/plugin-directory/skill.md",
|
|
461
471
|
isCrossCutting: false,
|
|
462
472
|
projectType: "wordpress-plugin"
|
|
473
|
+
},
|
|
474
|
+
// Content Channel skills
|
|
475
|
+
"content-channel": {
|
|
476
|
+
templateFileName: "content-channel/skill.md",
|
|
477
|
+
isCrossCutting: true,
|
|
478
|
+
resourceDirs: [
|
|
479
|
+
"content-channel/content-strategy",
|
|
480
|
+
"content-channel/content-scaffolding",
|
|
481
|
+
"content-channel/content-scripting",
|
|
482
|
+
"content-channel/content-voice-adapter",
|
|
483
|
+
"content-channel/content-prompts",
|
|
484
|
+
"content-channel/content-compliance",
|
|
485
|
+
"content-channel/content-vault-sync"
|
|
486
|
+
]
|
|
487
|
+
},
|
|
488
|
+
"content-channel:content-strategy": {
|
|
489
|
+
templateFileName: "content-channel/content-strategy/skill.md",
|
|
490
|
+
isCrossCutting: false,
|
|
491
|
+
projectType: "content-channel"
|
|
492
|
+
},
|
|
493
|
+
"content-channel:content-scaffolding": {
|
|
494
|
+
templateFileName: "content-channel/content-scaffolding/skill.md",
|
|
495
|
+
isCrossCutting: false,
|
|
496
|
+
projectType: "content-channel"
|
|
497
|
+
},
|
|
498
|
+
"content-channel:content-scripting": {
|
|
499
|
+
templateFileName: "content-channel/content-scripting/skill.md",
|
|
500
|
+
isCrossCutting: false,
|
|
501
|
+
projectType: "content-channel"
|
|
502
|
+
},
|
|
503
|
+
"content-channel:content-voice-adapter": {
|
|
504
|
+
templateFileName: "content-channel/content-voice-adapter/skill.md",
|
|
505
|
+
isCrossCutting: false,
|
|
506
|
+
projectType: "content-channel"
|
|
507
|
+
},
|
|
508
|
+
"content-channel:content-prompts": {
|
|
509
|
+
templateFileName: "content-channel/content-prompts/skill.md",
|
|
510
|
+
isCrossCutting: false,
|
|
511
|
+
projectType: "content-channel"
|
|
512
|
+
},
|
|
513
|
+
"content-channel:content-compliance": {
|
|
514
|
+
templateFileName: "content-channel/content-compliance/skill.md",
|
|
515
|
+
isCrossCutting: false,
|
|
516
|
+
projectType: "content-channel"
|
|
517
|
+
},
|
|
518
|
+
"content-channel:content-vault-sync": {
|
|
519
|
+
templateFileName: "content-channel/content-vault-sync/skill.md",
|
|
520
|
+
isCrossCutting: false,
|
|
521
|
+
projectType: "content-channel"
|
|
522
|
+
},
|
|
523
|
+
// Direct aliases (cross-cutting)
|
|
524
|
+
"content-strategy": {
|
|
525
|
+
templateFileName: "content-channel/content-strategy/skill.md",
|
|
526
|
+
isCrossCutting: true
|
|
527
|
+
},
|
|
528
|
+
"content-scaffolding": {
|
|
529
|
+
templateFileName: "content-channel/content-scaffolding/skill.md",
|
|
530
|
+
isCrossCutting: true
|
|
531
|
+
},
|
|
532
|
+
"content-scripting": {
|
|
533
|
+
templateFileName: "content-channel/content-scripting/skill.md",
|
|
534
|
+
isCrossCutting: true
|
|
535
|
+
},
|
|
536
|
+
"content-voice-adapter": {
|
|
537
|
+
templateFileName: "content-channel/content-voice-adapter/skill.md",
|
|
538
|
+
isCrossCutting: true
|
|
539
|
+
},
|
|
540
|
+
"content-prompts": {
|
|
541
|
+
templateFileName: "content-channel/content-prompts/skill.md",
|
|
542
|
+
isCrossCutting: true
|
|
543
|
+
},
|
|
544
|
+
"content-compliance": {
|
|
545
|
+
templateFileName: "content-channel/content-compliance/skill.md",
|
|
546
|
+
isCrossCutting: true
|
|
547
|
+
},
|
|
548
|
+
"content-vault-sync": {
|
|
549
|
+
templateFileName: "content-channel/content-vault-sync/skill.md",
|
|
550
|
+
isCrossCutting: true
|
|
463
551
|
}
|
|
464
552
|
};
|
|
465
553
|
}
|
|
@@ -3280,7 +3368,8 @@ var ProjectTypeSchema = z.enum([
|
|
|
3280
3368
|
"generic-webapp",
|
|
3281
3369
|
"backend-api",
|
|
3282
3370
|
"frontend-app",
|
|
3283
|
-
"multi-stack"
|
|
3371
|
+
"multi-stack",
|
|
3372
|
+
"content-channel"
|
|
3284
3373
|
]);
|
|
3285
3374
|
var SpecMetaSchema = z.object({
|
|
3286
3375
|
projectType: z.union([
|
|
@@ -3368,6 +3457,12 @@ When the user types messages starting with a slash (/), you MUST intercept them
|
|
|
3368
3457
|
## Overview
|
|
3369
3458
|
Describe your project here.
|
|
3370
3459
|
|
|
3460
|
+
## Project Types
|
|
3461
|
+
- List your project type(s) here (e.g., content-channel, node-service, wordpress-plugin, wordpress-theme, perfex-module, laravel-package, generic-webapp, backend-api, frontend-app, multi-stack)
|
|
3462
|
+
|
|
3463
|
+
## Tech Stack
|
|
3464
|
+
- List primary languages, frameworks, runtime, and key libraries
|
|
3465
|
+
|
|
3371
3466
|
## Architecture
|
|
3372
3467
|
Describe the high-level architecture: entry points, module structure, data flow.
|
|
3373
3468
|
|
|
@@ -3443,7 +3538,7 @@ The following commands are classified by risk level. You **MUST NOT** execute th
|
|
|
3443
3538
|
- Existing architecture patterns
|
|
3444
3539
|
- Coding standards
|
|
3445
3540
|
|
|
3446
|
-
> **IGNORE backup files**: Files like
|
|
3541
|
+
> **IGNORE backup files**: Files like \`project.back1.md\`, \`project.back2.md\`, etc. are automatic backups created during \`heraspec init\` updates. NEVER read or reference them unless explicitly asked by the user. Only \`project.md\` is the source of truth.
|
|
3447
3542
|
|
|
3448
3543
|
**Then scaffold:**
|
|
3449
3544
|
- \`heraspec/changes/<slug>/\` - Create proposal.md, tasks.md, design.md (optional)
|
|
@@ -3575,7 +3670,22 @@ The following commands are classified by risk level. You **MUST NOT** execute th
|
|
|
3575
3670
|
10. **Zero Emojis**: 0 Unicode emojis across custom code, comments, views, documentation, and UI.
|
|
3576
3671
|
- Use templates from \`heraspec/skills/perfex-module/module-codebase/templates/\` (module-main.php, install.php, uninstall.php, controller-admin.php, controller-api.php, model-main.php, helper.php, deploy.ps1, webpack.config.js).
|
|
3577
3672
|
|
|
3578
|
-
|
|
3673
|
+
**Special case - Content & Channel Development skills (projectType: content-channel):**
|
|
3674
|
+
- Tasks: \`(projectType: content-channel, skill: content-strategy)\`, \`(skill: content-scaffolding)\`, \`(skill: content-scripting)\`, \`(skill: content-voice-adapter)\`, \`(skill: content-prompts)\`, \`(skill: content-compliance)\`, \`(skill: content-vault-sync)\`, or \`(skill: content-channel)\`
|
|
3675
|
+
- Install: \`heraspec skill add content-channel\` or \`heraspec skill add <skill-name> --project-type content-channel\`
|
|
3676
|
+
- Agent reads corresponding skill instructions in \`heraspec/skills/<skill-name>/skill.md\` or \`heraspec/skills/content-channel/<skill-name>/skill.md\`.
|
|
3677
|
+
- Agent MUST adhere to **7 Core Content Production Standards**:
|
|
3678
|
+
1. **Golden Naming Rule**: ZERO \`[K\xEAnh]\`, \`[Channel]\`, or \`K\xEAnh:\` prefixes in channel/folder names. 100% pure brand names only.
|
|
3679
|
+
2. **MTxStudio 2-Level Tree Hierarchy**: Every channel must map to standard categories: \`_plan\` (\`type: "docs"\`), \`_posts\` (\`type: "article"\`), \`_prompts\` (\`type: "prompts"\`), \`_music\` (\`type: "music"\`), and optional \`_affiliate\` (\`type: "docs"\`).
|
|
3680
|
+
3. **Strict TTS Acoustic Rules (Natural Flow)**:
|
|
3681
|
+
- Short sentences: 12 - 20 words max per sentence (never exceed 25 words or 120 chars).
|
|
3682
|
+
- Comma clauses: 8 - 12 words max.
|
|
3683
|
+
- Repetition Bug Prevention: Never place 2 reduplicative words (t\u1EEB l\xE1y) adjacently; always separate with a natural comma \`,\`.
|
|
3684
|
+
- Clean text: Zero artificial bracket tags; rely entirely on natural punctuation (\`.\`, \`,\`, \`...\`, \`!\`) and sentence rhythm for voice pacing.
|
|
3685
|
+
4. **Strict Poetry & Verse Formatting**: Never use \`join(' ')\` or combine verses into a single line. EVERY verse line MUST preserve its \`\\n\` newline.
|
|
3686
|
+
5. **Mandatory 3-Position Disclaimer (Decree 15/2020/ND-CP)**: For horror, health, psychological healing, and finance niches, disclaimers are mandatory at: (1) Intro Warning Card 0:00-0:04, (2) Caption Footer / Pinned Comment, (3) Spoken Narration.
|
|
3687
|
+
6. **Safe Vault Sync (Zero SQLite Tampering)**: NEVER write directly to \`mtxstudio.db\`. All channel exports must go through \`Facebook/export_vault_json.py\` to generate sanitized JSON bundles (\`mtxstudio_vault_import.json\`, \`all_channels_bundle.json\`) with UTF-8 encoding and zero en-dash/em-dash characters.
|
|
3688
|
+
7. **Channel Voice Adaptation (Transmutation)**: When repurposing raw texts, always use \`content-voice-adapter\` to de-bias off-brand elements and reframe the message through the designated channel's core philosophy and natural voice style.
|
|
3579
3689
|
|
|
3580
3690
|
- Follow tasks.md
|
|
3581
3691
|
- Mark tasks completed: \`- [x]\`
|
|
@@ -3628,6 +3738,7 @@ Tasks grouped by project type and skill:
|
|
|
3628
3738
|
> heraspec skill add documents"
|
|
3629
3739
|
- **DO NOT** create a task plan or attempt manual generation without the skill language.
|
|
3630
3740
|
3. **Execute After Install**: Only after the skill folder is created (or installed), read the \`skill.md\` and proceed with the task.
|
|
3741
|
+
4. **Ignore Vietnamese Skill Files**: You MUST only read the English \`skill.md\` file inside the skill folder. Completely ignore all \`*.vi.md\` files (e.g., \`skill.vi.md\`), as they are strictly for reference purposes by human developers.
|
|
3631
3742
|
|
|
3632
3743
|
**Example prompt for Documents skill:**
|
|
3633
3744
|
If you need to generate multi-format documentation, use this prompt:
|
|
@@ -3638,6 +3749,42 @@ If you need to generate multi-format documentation, use this prompt:
|
|
|
3638
3749
|
> - Premium Documentation Landing Page (documentations/documentation-landing-page.html)
|
|
3639
3750
|
> - CRITICAL: Save all files in the /documentations directory (create it if missing)."
|
|
3640
3751
|
|
|
3752
|
+
**Example prompts for Content Channel Development (content-channel skills):**
|
|
3753
|
+
- **Channel Strategy (\`content-strategy\`)**:
|
|
3754
|
+
> "S\u1EED d\u1EE5ng skill content-strategy \u0111\u1EC3 l\u1EADp B\u1EA3n K\u1EBF Ho\u1EA1ch 30 Ng\xE0y (plan.md) cho k\xEAnh m\u1EDBi:
|
|
3755
|
+
> - T\xEAn k\xEAnh: [T\xEAn thu\u1EA7n t\xFAy, v\xED d\u1EE5: G\xF3c An Tr\xFA]
|
|
3756
|
+
> - Ng\xE1ch: [V\xED d\u1EE5: Thi\u1EC1n \u0111\u1ECBnh & L\u1ED1i s\u1ED1ng t\u1ED1i gi\u1EA3n]
|
|
3757
|
+
> - Kh\xE1n gi\u1EA3 m\u1EE5c ti\xEAu: [V\xED d\u1EE5: 25 - 40 tu\u1ED5i, nh\xE2n vi\xEAn v\u0103n ph\xF2ng stress]
|
|
3758
|
+
> - Y\xEAu c\u1EA7u: X\xE2y d\u1EF1ng 5 tr\u1EE5 c\u1ED9t n\u1ED9i dung, l\u1ED9 tr\xECnh Cold Start 14 ng\xE0y (70% Reels / 30% In-stream), khung gi\u1EDD v\xE0ng v\xE0 b\u1EA3ng ph\xE2n b\u1ED5 30 b\xE0i vi\u1EBFt chi ti\u1EBFt."
|
|
3759
|
+
|
|
3760
|
+
- **Channel Scaffolding (\`content-scaffolding\`)**:
|
|
3761
|
+
> "S\u1EED d\u1EE5ng skill content-scaffolding \u0111\u1EC3 kh\u1EDFi t\u1EA1o c\u1EA5u tr\xFAc th\u01B0 m\u1EE5c k\xEAnh m\u1EDBi:
|
|
3762
|
+
> - T\xEAn k\xEAnh: [V\xED d\u1EE5: Th\xE2n An T\xE2m L\u1EA1c] | Folder: [Than-An-Tam-Lac]
|
|
3763
|
+
> - Slogan: [V\xED d\u1EE5: Th\xE2n c\xF3 an, t\xE2m m\u1EDBi l\u1EA1c] | Icon Lucide: [Heart] | M\xE0u: [#10b981]
|
|
3764
|
+
> - Y\xEAu c\u1EA7u: Tu\xE2n th\u1EE7 quy t\u1EAFc c\u1EA5m ti\u1EC1n t\u1ED1 [K\xEAnh], t\u1EA1o posts/README.md v\xE0 \u0111\u0103ng k\xFD v\xE0o CHANNELS_CONFIG trong export_vault_json.py."
|
|
3765
|
+
|
|
3766
|
+
- **Raw Text Transmutation (\`content-voice-adapter\`)**:
|
|
3767
|
+
> "S\u1EED d\u1EE5ng skill content-voice-adapter \u0111\u1EC3 chuy\u1EC3n th\u1EC3 \u0111o\u1EA1n v\u0103n b\u1EA3n th\xF4 d\u01B0\u1EDBi \u0111\xE2y th\xE0nh K\u1ECBch b\u1EA3n Video chu\u1EA9n cho k\xEAnh [T\xEAn K\xEAnh] (Th\u1EC3 lo\u1EA1i: [Ch\u1EEFa l\xE0nh / Truy\u1EC7n ma / D\u01B0\u1EE1ng sinh / Chi\xEAm nghi\u1EC7m...]):
|
|
3768
|
+
> [D\xC1N \u0110O\u1EA0N V\u0102N B\u1EA2N TH\xD4 V\xC0O \u0110\xC2Y]
|
|
3769
|
+
> Y\xEAu c\u1EA7u qua 4 b\u01B0\u1EDBc: (1) L\u1ECDc l\u1EC7ch tone theo ma tr\u1EADn th\u1EC3 lo\u1EA1i (ch\u1EEFa l\xE0nh: l\u1ECDc m\xEA t\xEDn/\u0111\u1ED5 l\u1ED7i; truy\u1EC7n ma: l\u1ECDc m\xE1u me/vi ph\u1EA1m N\u0110 15 t\xEAn ng\u01B0\u1EDDi th\u1EADt/c\u1EE3t nh\u1EA3; d\u01B0\u1EE1ng sinh: l\u1ECDc ph\u1EA3n khoa h\u1ECDc/th\u1EA7n th\xE1nh h\xF3a; chi\xEAm nghi\u1EC7m: l\u1ECDc than th\u1EDF n\u1EA1n nh\xE2n), (2) T\xE1i c\u1EA5u tr\xFAc theo DNA tri\u1EBFt l\xFD v\xE0 \u0111\u1EA1i t\u1EEB nh\xE2n x\u01B0ng c\u1EE7a k\xEAnh, (3) T\u1ED1i \u01B0u \xE2m h\u1ECDc TTS 12-20 t\u1EEB/c\xE2u s\u1EA1ch th\u1EBB ngo\u1EB7c vu\xF4ng, (4) \u0110\xF3ng g\xF3i 6 ph\u1EA7n chu\u1EA9n MTxStudio k\xE8m Storyboard prompt, Caption v\xE0 Disclaimer ph\xE1p l\xFD ph\xF9 h\u1EE3p th\u1EC3 lo\u1EA1i."
|
|
3770
|
+
|
|
3771
|
+
- **Scriptwriting from Scratch (\`content-scripting\`)**:
|
|
3772
|
+
> "S\u1EED d\u1EE5ng skill content-scripting \u0111\u1EC3 vi\u1EBFt K\u1ECBch b\u1EA3n T\u1EADp [S\u1ED1 t\u1EADp]: '[Ti\xEAu \u0111\u1EC1]' cho k\xEAnh [T\xEAn K\xEAnh]:
|
|
3773
|
+
> - Tr\u1EE5 c\u1ED9t: [T\xEAn tr\u1EE5 c\u1ED9t n\u1ED9i dung] | \u0110\u1ECBnh d\u1EA1ng: [Video In-stream 16:9 ho\u1EB7c Reels 9:16]
|
|
3774
|
+
> - Y\xEAu c\u1EA7u \xE2m h\u1ECDc TTS: C\xE2u ng\u1EAFn 12-20 t\u1EEB, ng\u1EAFt nh\u1ECBp d\u1EA5u ph\u1EA9y r\xF5 r\xE0ng, kh\xF4ng \u0111i\u1EC7p \xE2m t\u1EEB l\xE1y, TUY\u1EC6T \u0110\u1ED0I KH\xD4NG ch\xE8n th\u1EBB ngo\u1EB7c vu\xF4ng ([l\u1EA5y h\u01A1i], [th\u1EDF d\xE0i]), b\u1EA3o to\xE0n th\u01A1 ca m\u1ED7i c\xE2u 1 d\xF2ng (\\n), xu\u1EA5t \u0111\u1EA7y \u0111\u1EE7 6 ph\u1EA7n k\xE8m Storyboard v\xE0 Caption Facebook."
|
|
3775
|
+
|
|
3776
|
+
- **AI Visual & Suno BGM Prompts (\`content-prompts\`)**:
|
|
3777
|
+
> "S\u1EED d\u1EE5ng skill content-prompts \u0111\u1EC3 t\u1EA1o b\u1ED9 Prompt Visual v\xE0 \xC2m nh\u1EA1c cho k\xEAnh [T\xEAn K\xEAnh]:
|
|
3778
|
+
> - C\u1EA7n t\u1EA1o: Prompt Avatar 1:1, Cover 16:9, B\u1EA3ng 5 Prompts Storyboard b\xE0i vi\u1EBFt '[T\xEAn b\xE0i vi\u1EBFt]', v\xE0 Prompt Suno AI BGM kh\xF4ng l\u1EDDi."
|
|
3779
|
+
|
|
3780
|
+
- **Legal Compliance & Disclaimer (\`content-compliance\`)**:
|
|
3781
|
+
> "S\u1EED d\u1EE5ng skill content-compliance \u0111\u1EC3 ki\u1EC3m duy\u1EC7t k\u1ECBch b\u1EA3n v\xE0 sinh Disclaimer cho video thu\u1ED9c th\u1EC3 lo\u1EA1i [Truy\u1EC7n Ma / D\u01B0\u1EE1ng Sinh / T\xE2m L\xFD / T\xE0i Ch\xEDnh]:
|
|
3782
|
+
> - Cung c\u1EA5p Disclaimer chu\u1EA9n ph\xE1p l\xFD (Ngh\u1ECB \u0111\u1ECBnh 15/2020/N\u0110-CP) \u0111\u1EB7t \u1EDF ch\xE2n Caption.
|
|
3783
|
+
> - Cung c\u1EA5p Prompt m\xE0n h\xECnh c\u1EA3nh b\xE1o Intro Warning Card (0:00 - 0:04, t\u1EF7 l\u1EC7 16:9)."
|
|
3784
|
+
|
|
3785
|
+
- **Vault Synchronization (\`content-vault-sync\`)**:
|
|
3786
|
+
> "S\u1EED d\u1EE5ng skill content-vault-sync \u0111\u1EC3 \u0111\u1ED3ng b\u1ED9 d\u1EEF li\u1EC7u: Ki\u1EC3m tra t\xEDnh to\xE0n v\u1EB9n c\xE1c k\xEAnh trong Facebook/, ch\u1EA1y export_vault_json.py \u0111\u1EC3 t\xE1i xu\u1EA5t mtxstudio_vault_import.json v\xE0 all_channels_bundle.json, b\xE1o c\xE1o s\u1ED1 l\u01B0\u1EE3ng k\xEAnh, danh m\u1EE5c v\xE0 k\u1ECBch b\u1EA3n \u0111\xE3 \u0111\xF3ng g\xF3i th\xE0nh c\xF4ng."
|
|
3787
|
+
|
|
3641
3788
|
**Dynamic Documentation Generation**:
|
|
3642
3789
|
When generating documentation, do NOT simply fill a template. The Agent MUST:
|
|
3643
3790
|
1. **Create** the \`/documentations\` directory if it does not exist.
|
|
@@ -3674,12 +3821,12 @@ Example with multiple skills in one change:
|
|
|
3674
3821
|
|
|
3675
3822
|
## Proactive Memory-Aware Development
|
|
3676
3823
|
|
|
3677
|
-
If
|
|
3824
|
+
If \`heraspec/skills/project-memory/\` exists, the agent MUST proactively use memory to maintain project context. DO NOT wait for the user to prompt you to use memory.
|
|
3678
3825
|
|
|
3679
3826
|
### CRITICAL RULES FOR AUTOMATIC MEMORY USAGE
|
|
3680
|
-
1. **Always Check Context First**: At the beginning of a complex task or when encountering an unfamiliar codebase area, you MUST autonomously run
|
|
3681
|
-
2. **Auto-Log via Archive**: You DO NOT need to run
|
|
3682
|
-
3. **Session Summary**: (Optional) When wrapping up a large session, you can run
|
|
3827
|
+
1. **Always Check Context First**: At the beginning of a complex task or when encountering an unfamiliar codebase area, you MUST autonomously run \`heraspec memory context\` or \`heraspec memory search "keywords"\` BEFORE writing any code.
|
|
3828
|
+
2. **Auto-Log via Archive**: You DO NOT need to run \`heraspec memory log\` manually. Every time you successfully implement a feature and run \`heraspec archive <change-name>\`, the system will automatically read your proposal and log the memory observation under the hood. Just use \`heraspec archive\` as normal!
|
|
3829
|
+
3. **Session Summary**: (Optional) When wrapping up a large session, you can run \`heraspec memory summarize --request "..." --completed "..."\` to compress knowledge, though \`archive\` already auto-logs completed features.
|
|
3683
3830
|
|
|
3684
3831
|
### When to SKIP Memory
|
|
3685
3832
|
- Simple bug fixes, typo corrections, formatting changes
|
|
@@ -3687,10 +3834,10 @@ If \\\`heraspec/skills/project-memory/\\\` exists, the agent MUST proactively us
|
|
|
3687
3834
|
- When doing what the agent's built-in context already covers
|
|
3688
3835
|
|
|
3689
3836
|
### Smart Code Exploration
|
|
3690
|
-
If
|
|
3691
|
-
-
|
|
3692
|
-
-
|
|
3693
|
-
-
|
|
3837
|
+
If \`heraspec/skills/smart-explore/\` exists, prefer token-efficient exploration:
|
|
3838
|
+
- \`heraspec explore outline <file>\` \u2192 View structure (~1K tokens vs ~12K full file)
|
|
3839
|
+
- \`heraspec explore search "<query>" <path>\` \u2192 Find symbols across codebase
|
|
3840
|
+
- \`heraspec explore unfold <file> <symbol>\` \u2192 Read just one function
|
|
3694
3841
|
`;
|
|
3695
3842
|
}
|
|
3696
3843
|
static getSkillsSection() {
|
|
@@ -3811,6 +3958,7 @@ var InitCommand = class {
|
|
|
3811
3958
|
await this.updateInstalledSkills(heraspecPath);
|
|
3812
3959
|
}
|
|
3813
3960
|
await this.checkAndBootstrapMemory(heraspecPath, resolvedPath, spinner);
|
|
3961
|
+
await this.checkAndBootstrapContentChannel(heraspecPath, resolvedPath, spinner);
|
|
3814
3962
|
await this.updateRelatedMarkdownFiles(resolvedPath);
|
|
3815
3963
|
spinner.stop();
|
|
3816
3964
|
try {
|
|
@@ -4351,7 +4499,8 @@ ${section.content.trimEnd()}`);
|
|
|
4351
4499
|
"generic-webapp",
|
|
4352
4500
|
"backend-api",
|
|
4353
4501
|
"frontend-app",
|
|
4354
|
-
"multi-stack"
|
|
4502
|
+
"multi-stack",
|
|
4503
|
+
"content-channel"
|
|
4355
4504
|
];
|
|
4356
4505
|
for (const entry of entries) {
|
|
4357
4506
|
if (entry === "README.md" || entry === "UI_UX_SKILL_QUICK_REFERENCE.md") continue;
|
|
@@ -4445,6 +4594,70 @@ ${section.content.trimEnd()}`);
|
|
|
4445
4594
|
}
|
|
4446
4595
|
spinner.start();
|
|
4447
4596
|
}
|
|
4597
|
+
/**
|
|
4598
|
+
* Automatically install content-channel skills if project type is content-channel
|
|
4599
|
+
*/
|
|
4600
|
+
async checkAndBootstrapContentChannel(heraspecPath, projectPath, spinner) {
|
|
4601
|
+
const configPath = path8.join(heraspecPath, HERASPEC_MARKERS.CONFIG_YAML);
|
|
4602
|
+
const projectMdPath = path8.join(heraspecPath, HERASPEC_MARKERS.PROJECT_MD);
|
|
4603
|
+
let isContentChannel = false;
|
|
4604
|
+
if (await FileSystemUtils.fileExists(configPath)) {
|
|
4605
|
+
const configContent = await FileSystemUtils.readFile(configPath);
|
|
4606
|
+
if (/\bprojectType:\s*["']?content-channel["']?/i.test(configContent)) {
|
|
4607
|
+
isContentChannel = true;
|
|
4608
|
+
}
|
|
4609
|
+
}
|
|
4610
|
+
if (!isContentChannel && await FileSystemUtils.fileExists(projectMdPath)) {
|
|
4611
|
+
const projectContent = await FileSystemUtils.readFile(projectMdPath);
|
|
4612
|
+
if (/##\s*Project Types\s*\n\s*-\s*content-channel\b/i.test(projectContent)) {
|
|
4613
|
+
isContentChannel = true;
|
|
4614
|
+
}
|
|
4615
|
+
}
|
|
4616
|
+
if (!isContentChannel) {
|
|
4617
|
+
const hasFacebook = await FileSystemUtils.fileExists(path8.join(projectPath, "Facebook"));
|
|
4618
|
+
const hasPosts = await FileSystemUtils.fileExists(path8.join(projectPath, "posts"));
|
|
4619
|
+
const hasPrompts = await FileSystemUtils.fileExists(path8.join(projectPath, "prompts"));
|
|
4620
|
+
if (hasFacebook || hasPosts && hasPrompts) {
|
|
4621
|
+
isContentChannel = true;
|
|
4622
|
+
}
|
|
4623
|
+
}
|
|
4624
|
+
if (isContentChannel) {
|
|
4625
|
+
const channelSkills = [
|
|
4626
|
+
"content-strategy",
|
|
4627
|
+
"content-scaffolding",
|
|
4628
|
+
"content-scripting",
|
|
4629
|
+
"content-voice-adapter",
|
|
4630
|
+
"content-prompts",
|
|
4631
|
+
"content-compliance",
|
|
4632
|
+
"content-vault-sync"
|
|
4633
|
+
];
|
|
4634
|
+
const skillsDir = path8.join(heraspecPath, SKILLS_DIR_NAME);
|
|
4635
|
+
const missingSkills = [];
|
|
4636
|
+
for (const skillName of channelSkills) {
|
|
4637
|
+
const flatPath = path8.join(skillsDir, skillName);
|
|
4638
|
+
const scopedPath = path8.join(skillsDir, "content-channel", skillName);
|
|
4639
|
+
if (!await FileSystemUtils.fileExists(flatPath) && !await FileSystemUtils.fileExists(scopedPath)) {
|
|
4640
|
+
missingSkills.push(skillName);
|
|
4641
|
+
}
|
|
4642
|
+
}
|
|
4643
|
+
if (missingSkills.length > 0) {
|
|
4644
|
+
spinner.stop();
|
|
4645
|
+
console.log(chalk2.cyan(`
|
|
4646
|
+
\u{1F3AC} Detected content-channel project. Installing ${missingSkills.length} channel skill(s)...`));
|
|
4647
|
+
try {
|
|
4648
|
+
const { SkillCommand: SkillCommand2 } = await Promise.resolve().then(() => (init_skill(), skill_exports));
|
|
4649
|
+
const skillCommand = new SkillCommand2();
|
|
4650
|
+
for (const skillName of missingSkills) {
|
|
4651
|
+
await skillCommand.add(skillName, void 0, projectPath);
|
|
4652
|
+
}
|
|
4653
|
+
console.log(chalk2.green(`\u2713 Channel skills suite ready for production.
|
|
4654
|
+
`));
|
|
4655
|
+
} catch (err) {
|
|
4656
|
+
}
|
|
4657
|
+
spinner.start();
|
|
4658
|
+
}
|
|
4659
|
+
}
|
|
4660
|
+
}
|
|
4448
4661
|
/**
|
|
4449
4662
|
* Get the knowledge source directory from CLI package
|
|
4450
4663
|
*/
|
|
@@ -4897,7 +5110,7 @@ After copying UI/UX skill to your project, see:
|
|
|
4897
5110
|
return `<!-- HeraSpec Section -->
|
|
4898
5111
|
## HeraSpec Development
|
|
4899
5112
|
|
|
4900
|
-
This project uses [HeraSpec](https://github.com/
|
|
5113
|
+
This project uses [HeraSpec](https://github.com/PolyXGO/HeraSpec) for spec-driven development.
|
|
4901
5114
|
|
|
4902
5115
|
### Quick Start
|
|
4903
5116
|
|
|
@@ -4946,7 +5159,7 @@ heraspec skill add unit-test
|
|
|
4946
5159
|
heraspec skill show ui-ux
|
|
4947
5160
|
\`\`\`
|
|
4948
5161
|
|
|
4949
|
-
For more information, see the [HeraSpec documentation](https://github.com/
|
|
5162
|
+
For more information, see the [HeraSpec documentation](https://github.com/PolyXGO/HeraSpec#readme).
|
|
4950
5163
|
|
|
4951
5164
|
---
|
|
4952
5165
|
|