Compare commits

..

10 Commits
v0.0.5 ... main

Author SHA1 Message Date
ywkj 9f37657fcf feat: auth-rt 改用 Go 二进制,install.sh 自动下载
register-skill-release / register (push) Successful in 15s Details
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 20:52:02 +08:00
ywkj 406b6d417c fix: auth-rt auto-install 使用永久路径 ~/.local/share/auth-runtime
修复之前 clone 到 /tmp 后删除导致 wrapper 指向不存在路径的问题。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 20:34:21 +08:00
ywkj 1884efa54e feat: install.sh 自动下载安装 auth-rt(无需手动 clone)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 18:36:47 +08:00
ywkj 993f038ae9 chore: auth-rt 默认路径改为 ~/.local/bin/
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 18:35:37 +08:00
ywkj 9e9331f8bb fix: auth-cli.ts 修复 HOME 路径解析 + shell wrapper 兼容
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 18:31:06 +08:00
ywkj e18276ce07 refactor: auth-cli.ts 改用 auth-rt 二进制
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 18:26:31 +08:00
ywkj 7ad389adc4 refactor: 移除 @clawd/auth-runtime npm 依赖,改用 CLI subprocess 调用
通过内置 auth-cli.ts 薄 wrapper 调用 auth-runtime CLI,
消除 npm git 依赖带来的缓存和更新问题。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 14:38:07 +08:00
ywkj 88ddfd4ba7 feat: add structured compose guidelines with sender profile, i18n, and review analysis
register-skill-release / register (push) Successful in 13s Details
Enhance email composition with sender identity (sender-profile.json),
auto language selection by country, review pain-point analysis workflow,
structured email template, and personalization tracking.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 07:27:49 +08:00
ywkj 27b204b5fb fix: add install.sh to always fetch latest git deps
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 06:56:43 +08:00
ywkj 8b2351db21 chore: pin @clawd/auth-runtime to v1.1.0
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 06:49:10 +08:00
8 changed files with 205 additions and 7 deletions

View File

@ -28,10 +28,53 @@ Save drafts as a JSON array file. Each draft must have:
- `subject` (string, under 60 chars)
- `body_html` (string, professional HTML with inline styles)
- `body_text` (string, plain text fallback)
- `personalization_context` (object, see below)
#### Email Composition Rules
- Reference the business name and specific review insights
- Mention pain points or strengths identified from reviews
#### a) Sender Profile
Before composing, read `sender-profile.json` in this skill directory. Use it to populate sender identity, product info, and signature in every email.
#### b) Language Selection
Auto-select email language based on the `country` field from fetch output:
- us/gb/au/ca → English
- cn → 中文
- jp → 日本語
- kr → 한국어
- de → Deutsch
- fr → Français
- es/mx → Español
- pt/br → Português
- Unlisted countries → default to English
Write the **entire** email (subject, body, signature) in the selected language.
#### c) Review Pain-Point Analysis
When `reviews_data` is non-empty for a business:
1. Parse JSON into a review array
2. Filter for negative reviews / complaints related to the sender's `product_category`
3. Extract 12 pain points that the sender's products can solve
4. Analyze at most 10 reviews, prioritizing low-score ones
5. If `reviews_data` is empty or null, fall back to the business's general info (category, rating) to craft the email
#### d) Email Template Structure
1. **Subject** — Under 60 chars, in the target language, referencing a specific pain point or business need
2. **Opening** — Address the business by name; demonstrate familiarity with their operations
3. **Pain Point Bridge** — Reference pain-point patterns from reviews (do NOT quote reviews verbatim); connect them to problems the sender's product solves
4. **Value Proposition** — Introduce sender company and products using `product_highlights` from sender-profile.json
5. **CTA** — Low-friction call-to-action: free samples, catalog, or a brief call
6. **Signature** — Use contact info from sender-profile.json (name, title, email, phone, website)
#### e) Personalization Tracking
Populate the `personalization_context` field on each draft:
```json
{
"language": "selected language",
"pain_points_used": ["pain point 1", "pain point 2"],
"reviews_analyzed": true,
"sender_product_match": "brief note on how sender product connects to this business"
}
```
#### General Rules
- Tone: professional, consultative, not salesy
- Save the drafts array to a temp JSON file, e.g. `/tmp/drafts-<workflow-id>.json`

View File

@ -6,7 +6,7 @@ interface:
This skill uses Bun+TypeScript CLI scripts. Do NOT create Python scripts or custom upload logic.
Step 1: cd ~/clawd/skills/email-content-compose && bun run fetch -- --workflow-id=<WORKFLOW_ID>
Step 2: Read the fetch output. For each business with emails, compose a personalized EmailDraft (recipient_email, recipient_name, subject, body_html, body_text). Save all drafts as a JSON array to /tmp/drafts-<WORKFLOW_ID>.json
Step 2: Read sender-profile.json from the skill directory. Then read the fetch output. For each business with emails, compose a personalized EmailDraft following SKILL.md Section 2 rules (language selection by country, review pain-point analysis, structured email template, personalization_context tracking). Save all drafts as a JSON array to /tmp/drafts-<WORKFLOW_ID>.json
Step 3: bun run export -- --drafts=/tmp/drafts-<WORKFLOW_ID>.json --workflow-id=<WORKFLOW_ID>
Return the export result JSON (file URLs + bundle URL). Read SKILL.md for composition rules.

26
install.sh Executable file
View File

@ -0,0 +1,26 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
# Auto-install auth-rt if not found
if ! command -v auth-rt &>/dev/null && [ ! -x "$HOME/.local/bin/auth-rt" ]; then
echo "auth-rt not found, installing..."
_FORGEJO="http://192.168.0.108:3030"
_OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
_ARCH="$(uname -m)"; case "$_ARCH" in x86_64) _ARCH="amd64";; aarch64) _ARCH="arm64";; esac
_URL="$_FORGEJO/agent-skills/auth-runtime/releases/download/latest/auth-rt-${_OS}-${_ARCH}"
mkdir -p "$HOME/.local/bin"
if curl -fsSL "$_URL" -o "$HOME/.local/bin/auth-rt" 2>/dev/null; then
chmod +x "$HOME/.local/bin/auth-rt"
echo "auth-rt installed (downloaded)"
else
echo "Download failed, building from source..."
_SRC="$HOME/.local/share/auth-runtime"
if [ -d "$_SRC/.git" ]; then git -C "$_SRC" pull --ff-only
else git clone --depth 1 "$_FORGEJO/agent-skills/auth-runtime.git" "$_SRC"
fi
bash "$_SRC/install.sh"
fi
fi
npm install

View File

@ -18,7 +18,6 @@
},
"dependencies": {
"@aws-sdk/client-s3": "^3.1004.0",
"@clawd/auth-runtime": "git+http://192.168.0.108:3030/agent-skills/auth-runtime.git",
"@clawd/r2-upload": "git+http://192.168.0.108:3030/agent-skills/r2-upload.git"
}
}

11
sender-profile.json Normal file
View File

@ -0,0 +1,11 @@
{
"company_name": "Your Company Name",
"website": "https://yourcompany.com",
"product_category": "e.g., industrial packaging supplies",
"product_highlights": ["Key benefit 1", "Key benefit 2"],
"value_proposition": "One sentence why businesses should use your products",
"contact_name": "Sales Rep Name",
"contact_title": "Business Development Manager",
"contact_email": "sales@yourcompany.com",
"contact_phone": "+1-555-0100"
}

119
src/auth-cli.ts Normal file
View File

@ -0,0 +1,119 @@
/**
* Thin CLI wrapper for auth-runtime.
*
* Copy this file into your skill's src/ directory. It calls the
* `auth-rt` binary (a standalone Go executable), so the skill has
* zero npm/runtime dependency on auth-runtime.
*
* Prerequisites:
* `auth-rt` must be in PATH or at ~/.local/bin/auth-rt
* (install.sh handles this automatically)
*
* Usage:
* import { createSkillClient } from './auth-cli.ts';
* const client = createSkillClient();
* const res = await client.post('/ecom/tasks/scrape', { url: '...' });
*/
import { spawnSync } from 'child_process';
import * as path from 'path';
import * as os from 'os';
const home = process.env.HOME || os.homedir();
const AUTH_RT_BIN = process.env.AUTH_RT_BIN
|| (() => {
// Check if auth-rt is in PATH
const which = spawnSync('which', ['auth-rt'], { encoding: 'utf-8' });
if (which.status === 0 && which.stdout.trim()) {
return which.stdout.trim();
}
return path.join(home, '.local', 'bin', 'auth-rt');
})();
export interface ApiResponse {
status: number;
body: string;
}
export interface SessionResponse {
accessToken: string;
expiresIn: number;
ownerSessionToken?: string;
hookUrl?: string;
hookToken?: string;
}
export interface SkillClientOptions {
apiBase?: string;
dryRun?: boolean;
}
function runCli(...args: string[]): string {
const result = spawnSync(AUTH_RT_BIN, args, {
encoding: 'utf-8',
timeout: 60_000,
});
if (result.error) {
throw new Error(`auth-rt spawn failed: ${result.error.message}`);
}
if (result.status !== 0) {
throw new Error(`auth-rt failed (exit ${result.status}): ${(result.stderr || '').trim()}`);
}
return (result.stdout || '').trim();
}
export class SkillClient {
private readonly apiBase?: string;
private readonly dryRun: boolean;
constructor(options: SkillClientOptions = {}) {
this.apiBase = options.apiBase;
this.dryRun = options.dryRun ?? false;
}
async session(): Promise<SessionResponse> {
if (this.dryRun) {
return { accessToken: '<dry-run-token>', expiresIn: 900 };
}
return JSON.parse(runCli('session'));
}
async get(urlPath: string): Promise<ApiResponse> {
return this.request('GET', urlPath);
}
async post(urlPath: string, body?: unknown): Promise<ApiResponse> {
return this.request('POST', urlPath, body);
}
async put(urlPath: string, body?: unknown): Promise<ApiResponse> {
return this.request('PUT', urlPath, body);
}
async patch(urlPath: string, body?: unknown): Promise<ApiResponse> {
return this.request('PATCH', urlPath, body);
}
async delete(urlPath: string, body?: unknown): Promise<ApiResponse> {
return this.request('DELETE', urlPath, body);
}
private async request(method: string, urlPath: string, body?: unknown): Promise<ApiResponse> {
if (this.dryRun) {
return { status: 200, body: JSON.stringify({ dryRun: true, method, path: urlPath }) };
}
const args = ['request', method, urlPath];
if (body != null) {
args.push('--body', JSON.stringify(body));
}
if (this.apiBase) {
args.push('--api-base', this.apiBase);
}
return JSON.parse(runCli(...args));
}
}
export function createSkillClient(options?: SkillClientOptions): SkillClient {
return new SkillClient(options);
}

View File

@ -1,5 +1,5 @@
import type { EmailDraft, ExportResult, ExportedFile, FetchResult } from './types.js';
import { createSkillClient } from '@clawd/auth-runtime';
import { createSkillClient } from './auth-cli.ts';
import { fetchLeadDataset } from './lead-dataset.js';
import { draftToEml, emlFilename } from './eml.js';
import { loadR2Config, uploadToR2 } from '@clawd/r2-upload';

View File

@ -1,5 +1,5 @@
import type { LeadDatasetResponse } from './types.js';
import type { SkillClient } from '@clawd/auth-runtime';
import type { SkillClient } from './auth-cli.ts';
/**
* Fetch lead-dataset from a completed cold-outreach workflow.