stock-deepdive

# Stock DeepDive — คำสั่งสำหรับ agent ที่ทำงานใน repo นี้

repo นี้เป็น **ปลั๊กอินวิเคราะห์หุ้นจากเอกสารต้นฉบับ** ที่ติดตั้งได้ทั้งใน Claude Code และ Codex
ถ้าคุณถูกเรียกให้ "วิเคราะห์หุ้น" หรือ "ดึงงบ" ขณะอยู่ใน repo นี้ **อย่าเขียนขั้นตอนขึ้นเอง** — ของมีอยู่แล้ว:

**เนื้อปลั๊กอินทั้งหมดอยู่ใต้ `plugins/stock-deepdive-lite/`** (path ข้างล่างย่อจากตรงนั้น):

| อยากทำอะไร | อ่านไฟล์นี้ |
|---|---|
| วิเคราะห์หุ้นเชิงลึก → บทความ HTML | `skills/deepdive/SKILL.md` |
| ดึงเอกสารต้นฉบับอย่างเดียว | `skills/fetch/SKILL.md` |
| หา path ของสคริปต์ | `ROOT.md` |
| คำสั่งของแต่ละบทบาท | `agents/factcheck.md` · `agents/writer.md` · `agents/critic.md` |

`<ราก>` ในไฟล์เหล่านั้น = **`plugins/stock-deepdive-lite/`** ไม่ใช่รากของ repo

---

## กฎที่ห้ามผ่อน ไม่ว่าจะเรียกด้วยเครื่องมือไหน

1. **ตัวเลขเข้าบทความได้ทางเดียว — ผ่าน `FACTS.md`** คนเขียนห้ามเปิดเอกสารต้นฉบับหยิบตัวเลขเอง
   ⇒ ถ้าต้องใช้ตัวที่ไม่มีในตาราง ให้เขียนบอกว่าขาดอะไร ไม่ใช่ไปหยิบมาเอง
2. **ห้ามเริ่มเขียนถ้าไม่มีเอกสารต้นฉบับ** — ดึงไม่ได้ให้บอกว่าติดตรงไหนแล้วถาม
   **ห้ามเขียนจากความจำของโมเดลแล้วทำเหมือนมีหลักฐาน**
3. **แยกชั้นความน่าเชื่อถือให้เห็น** — เอกสารที่ยื่น ≠ คำพูดผู้บริหาร ≠ พาดหัวข่าว ≠ ข้อมูลตลาดแหล่งรอง
4. **ข้อมูลที่ไม่มี ต้องเขียนว่าไม่มี** ห้ามเว้น ห้ามเดาแทน
5. **เจอความผิดปกติ ≠ พิสูจน์เจตนา** — รายงานได้ว่าเห็นอะไรและผิดปกติยังไง ห้ามสรุปว่าใครตั้งใจทำอะไร
6. **ไม่ใช่คำแนะนำการลงทุน** — ห้ามเขียนว่าควรซื้อหรือควรขาย และห้ามชี้นำอ้อม ๆ ผ่านการเรียงลำดับฉาก

## งานที่ต้องใช้สคริปต์ ห้ามให้ AI ทำแทน

แกะไฟล์ · แปลง PDF · หาหน้าที่เป็นภาพสแกน · ประกอบ HTML · ตรวจว่าตัวเลขหลุดจาก `FACTS.md` ไหม
⇒ ทั้งหมดนี้มีสคริปต์ใน `bin/` ถืออยู่แล้ว ให้ผลลัพธ์เหมือนเดิมทุกครั้งในไม่กี่วินาที
ถ้าปล่อยให้ AI ทำ จะกินเวลาหลายสิบนาทีเพื่อผลลัพธ์เดิม และแย่กว่า

## แก้ไขปลั๊กอินนี้

**เนื้อมีชุดเดียว manifest มีสองชุด** — `skills/*/SKILL.md` · `agents/*.md` · `bin/*.py` ใช้ร่วมกันทั้งสองเครื่องมือ
แก้ที่เดียวมีผลทั้งคู่ ⇒ 🔴 **ห้ามใส่ path หรือตัวแปรที่ผูกกับเครื่องมือใดเครื่องมือหนึ่งลงในไฟล์ที่ใช้ร่วมกัน**
(เช่น `${CLAUDE_PLUGIN_ROOT}`) ให้เขียนเป็น `<ราก>` แล้วอธิบายวิธีหาไว้ใน `ROOT.md` ที่เดียว

ไฟล์ที่ต้องแก้ให้ตรงกันเสมอ (คู่ละสองไฟล์):

| ฝั่ง Claude Code | ฝั่ง Codex |
|---|---|
| `plugins/stock-deepdive-lite/.claude-plugin/plugin.json` | `plugins/stock-deepdive-lite/.codex-plugin/plugin.json` |
| `.claude-plugin/marketplace.json` (ราก repo) | `.agents/plugins/marketplace.json` (ราก repo) |

🔴 **โครง `plugins/<ชื่อ>/` เปลี่ยนไม่ได้** — Codex หาปลั๊กอินที่วางไว้ที่รากของ marketplace ไม่เจอ
(ทดสอบแล้ว: `path: "./"` และ `path: "."` ทั้งคู่คืน `plugin not found`) ส่วน Claude Code รับได้ทั้งสองแบบ
⇒ layout นี้คือตัวส่วนร่วมที่ทั้งคู่ใช้ได้

ตรวจก่อน push ทั้งสองฝั่ง:

```bash
claude plugin validate .
python ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/stock-deepdive-lite
```