SKILL.md - Weekly-Monthly Reporter
A professional report generation tool that transforms raw work content into structured weekly/monthly reports using AI.
Trigger Phrases
- "生成周报" / "周报生成" / "写周报"
- "生成月报" / "月报生成" / "写月报"
- "工作汇报" / "工作总结"
- "report generation" / "weekly report" / "monthly report"
- "续写周报" / "继续上次写"
Capabilities
Input Methods
| Input Type | Free | Std | Pro | Max |
|---|---|---|---|---|
| Text paste | ✅ | ✅ | ✅ | ✅ |
| File upload (TXT/MD) | ❌ | ✅ | ✅ | ✅ |
| Feishu tasks | ❌ | ❌ | ✅ | ✅ |
Output Formats
| Format | Free | Std | Pro | Max |
|---|---|---|---|---|
| Markdown | ✅ | ✅ | ✅ | ✅ |
| Word (.docx) | ❌ | ✅ | ✅ | ✅ |
| ❌ | ❌ | ✅ | ✅ | |
| Feishu card | ❌ | ❌ | ❌ | ✅ |
Generation Limits
| Tier | Monthly Limit | History Retention |
|---|---|---|
| Free | 5 (non-reset) | ❌ |
| Std ¥9.9 | 30 | 30 days |
| Pro ¥29.9 | 100 | 6 months |
| Max ¥99 | Unlimited | 12 months |
Usage
CLI Commands
# Generate a weekly report
python -m scripts.main generate --content "今天完成了XX，明天计划做YY" -k YOUR_API_KEY
# Generate from file
python -m scripts.main generate --file worklog.md -k YOUR_API_KEY
# Generate monthly report in detailed style
python -m scripts.main generate --type monthly --style detailed -c "本月工作..." -k YOUR_API_KEY
# Continue from previous report
python -m scripts.main generate --continue-from REPORT_ID -c "新增工作..." -k YOUR_API_KEY
# Output to Word
python -m scripts.main generate -c "内容..." -k KEY --format word --output report.docx
# View history
python -m scripts.main history -k YOUR_API_KEY
# Check status
python -m scripts.main status -k YOUR_API_KEY
# Validate API key
python -m scripts.main validate -k YOUR_API_KEY
Python API
from scripts.report_generator import ReportGenerator
from scripts.templates import ReportType, ReportStyle
generator = ReportGenerator(api_key="your_llm_key")
result = generator.generate_report(
work_content="今天完成了A项目第一阶段...",
report_type=ReportType.WEEKLY,
style=ReportStyle.CONCISE,
api_key="your_token_key"
)
if result["success"]:
print(result["report"])
Report Styles
- 简洁版: Concise summary, suitable for quick updates
- 详细版: Comprehensive with KPI, improvements, growth sections
- 领导版: Executive-focused with risk analysis and metrics
- 自评版: Self-review style with achievements and improvement areas
API Key Setup
Token Validation Key (Required)
Get your key from YK-Global.com:
- Format: RPT-WEEKLY-* (RPT-WEEKLY-FREE, RPT-WEEKLY-STD, etc.)
- Validates against: https://api.yk-global.com/v1/verify
LLM API Key (For Generation)
Self-configured. Supports OpenAI-compatible APIs:
- OpenAI (GPT-4, GPT-3.5)
- Custom endpoints
File Locations
- History:
~/.weekly_reporter/history/ - Token cache:
~/.weekly_reporter/token_cache.json - Uploads:
~/.weekly_reporter/uploads/
Error Handling
- Network errors to validation server → degrades to FREE tier (doesn't block usage)
- Generation limit reached → returns error with upgrade info
- Invalid API key → returns validation error
Feishu Integration
Reading Tasks (Pro/Max)
Requires Feishu OAuth token with task:task:readonly scope.
Sending Messages (Max only)
Send reports as Feishu interactive cards. Requires bot token.
Dependencies
requests>=2.28.0
python-docx>=0.8.11 # For Word output
reportlab>=4.0.0 # For PDF output
