soia-pkm-clip-x-profile 是一个面向公开 X 账号的有限范围检索与研究技能。
用途
研究公开 X 账号的有限帖子窗口：先采集，再按范围和条件检索，最后输出摘要、分类清单或下游处理输入。已知账号使用脚本；未知账号先做候选发现，再进入账号研究。
主要能力
可在指定时间或条数范围内采集账号帖子；支持按关键词、主题、分类、媒体存在与否（--has-media/--has-alt）等条件筛选；输出账号概览、时间段总结、主题分析与可审计结果；可将明确选定的结果交给下游技能继续处理。
使用方式
使用前先确认四项：账号/候选博主、时间或最新条数、关键词/主题/证据条件、产物类型。默认只做研究摘要，不自动生成图片；自然语言“最近一周/一个月”应先换成明确的 CST 日期。
常用脚本入口：
python3 scripts/profile_x.py https://x.com/<handle>
--limit <N> --since <YYYY-MM-DD> --until <YYYY-MM-DD>
--query <term> --output-mode summary --output <run-dir>
重复 --query 默认 OR，需同时命中时加 --query-mode all；--topic 是别名。完整参数和输出字段见研究契约，可复用命令见查询配方。
依赖与安装
依赖：Python 3 标准库；网络模式访问 api.fxtwitter.com，离线模式使用 --source-json。不读取 X Cookie、登录态或私密内容。image 不是默认依赖；只有明确选择 image-prompts/all 才进入下游 image 技能。
装整个域（Claude Code 与 Codex 共用同一份域插件）：
claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-pkm-vault@soia
只装这一个技能：
npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-clip-x-profile -y
WorkBuddy 的装载单位是角色化专家而不是插件，npx skills add -a '*' 覆盖不到它，需要单独安装，见 docs/install/workbuddy.md。
渐进式执行
L0 范围：确认账号/候选、窗口、筛选条件和产物；信息不足先回显假设。 L1 采集：有限分页，先 --dry-run，记录 fetched、分页和停止原因。 L2 研究：写 summary.md、filtered.json、classification.yml，保留帖子 URL、时间和证据。 L3 下游：客户明确需要时才写 image-prompts.yml/prompts/，再交给 soia-media-generate-article-image 做位图和视觉验收。
路由原则
账号总结：只选 summary，不编译 Prompt。时间/主题检索：用 --since/--until、--query/--topic、--category、--has-media/--has-alt 组合。模型/提示词研究：先输出研究结果；只有明确下游转换时才用 --output-mode image-prompts。未知博主发现：先用 X 搜索或 Web 搜索找候选账号/帖子，记录来源和入选理由，再对候选账号运行本技能；本脚本不冒充全网搜索。
适用场景
公开 X 账号的账号概览、时间段总结、主题分析；按时间、关键词、主题、媒体或内容条件的检索；模型与提示词线索研究；未知博主的候选发现。
限制与边界
latest-window 不等于账号历史全量；all 也受 --max-pages 限制。Prompt Deck 不是位图验收，GPT2 只是来源模型线索，不是新 preset。输出目录、证据保留、失败回执和 image 导入字段见研究契约与 soia-open-media-content-skills/skills/soia-media-generate-article-image/references/prompt-x-profile-import.md。
日志与完成回执
每页输出 page / received / added / total。回执必须包含账号/候选、范围、条件、fetched、selected、分类、GPT2/ALT、覆盖完整性、分页上限和产物路径；不得把“Prompt 已编译”写成“图片生成通过”。
私密信息与中间数据
run bundle 放在客户指定的临时或正式输出目录，不放入仓库、vault 根或 ~/.codex/generated_images。公共仓库只提交脚本、契约和离线测试，不提交真实账号抓取结果、ALT、provider 缓存或生成图片。
前向测试
三个真实场景和验收标准见三场景前向测试；xiaoxiaodong01 只是其中一个回归样例，不是默认账号。