@optima-chat/optima-agent 0.8.98 → 0.8.99

package/.claude/settings.local.json

@@ -0,0 +1,166 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh api:*)",
+      "WebFetch(domain:platform.claude.com)",
+      "Bash(git init:*)",
+      "Bash(mkdir:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(npm view:*)",
+      "WebSearch",
+      "Bash(commerce --help)",
+      "Bash(done)",
+      "Bash(commerce product:*)",
+      "Bash(commerce order:*)",
+      "Bash(commerce i18n:*)",
+      "Bash(google-ads:*)",
+      "Bash(scout --help:*)",
+      "Bash(tree:*)",
+      "Bash(cloc:*)",
+      "Bash(npm run build:*)",
+      "Bash(git restore:*)",
+      "Bash(gh repo view:*)",
+      "Bash(mv:*)",
+      "Bash(rmdir:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push)",
+      "Bash(timeout 5 npm run optima:*)",
+      "Bash(npm install:*)",
+      "Bash(cat:*)",
+      "Bash(gh issue create:*)",
+      "Bash(npx tsx:*)",
+      "Bash(timeout 30 npx tsx:*)",
+      "Bash(git push origin feature/ask-user-question)",
+      "Bash(node:*)",
+      "Bash(npm version:*)",
+      "Bash(git push:*)",
+      "Bash(npm publish:*)",
+      "Bash(pkill:*)",
+      "Bash(git -C /Users/verypro/optima-agent log --oneline --all -- \".claude/\")",
+      "Bash(wc:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(commerce collection --help:*)",
+      "Bash(commerce collection update --help:*)",
+      "Bash(commerce collection set-cover:*)",
+      "Bash(commerce collection get --help:*)",
+      "Bash(commerce collection list --help:*)",
+      "Bash(commerce collection create --help:*)",
+      "Bash(commerce collection remove-products:*)",
+      "Bash(commerce collection list-products:*)",
+      "Bash(commerce --version:*)",
+      "Bash(bi-cli --version:*)",
+      "Bash(commerce homepage create --help:*)",
+      "Bash(commerce homepage reorder --help:*)",
+      "Bash(commerce homepage delete --help:*)",
+      "Bash(commerce homepage update-images:*)",
+      "Bash(commerce homepage update-collections:*)",
+      "Bash(commerce homepage update-target:*)",
+      "Bash(commerce homepage switch-template:*)",
+      "Bash(commerce inventory:*)",
+      "Bash(commerce merchant:*)",
+      "Bash(commerce review:*)",
+      "Bash(commerce product-page:*)",
+      "Bash(bi-cli:*)",
+      "Bash(comfy:*)",
+      "Bash(scout search:*)",
+      "Bash(scout product:*)",
+      "Bash(commerce homepage create-collections:*)",
+      "Bash(commerce homepage create-featured:*)",
+      "Bash(commerce homepage create-collection-products:*)",
+      "Bash(commerce homepage create-banner:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')",
+      "Bash(ls:*)",
+      "Bash(gh issue view:*)",
+      "Bash(npx markdownlint-cli:*)",
+      "Bash(chmod:*)",
+      "Bash(npm whoami:*)",
+      "Bash(tsx test-scripts/test-headless-progress.ts:*)",
+      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)",
+      "Bash(git describe:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(./scripts/test-headless.sh:*)",
+      "Bash(./scripts/test-headless-simple.sh:*)",
+      "Bash(env)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(optima --version:*)",
+      "Bash(optima agent headless:*)",
+      "Bash(optima headless:*)",
+      "Bash(/Users/verypro/optima-agent/scripts/test-headless.sh:*)",
+      "Bash(/Users/verypro/optima-agent/scripts/test-headless-simple.sh:*)",
+      "Bash(tee:*)",
+      "Bash(CONV_ID=\"conv-1\":*)",
+      "Bash(echo:*)",
+      "Bash(scout tiktok trending --help:*)",
+      "Bash(scout tiktok trending:*)",
+      "Bash(git checkout:*)",
+      "Bash(npm test:*)",
+      "Bash(git tag:*)",
+      "Bash(/private/tmp/claude/-Users-verypro-optima-agent/68a9ac2c-def2-44e1-b42b-e53bd9022ab6/scratchpad/test-canUseTool.sh)",
+      "Bash(optima --help:*)",
+      "Bash(npx @optima-chat/ads-cli:*)",
+      "Bash(head:*)",
+      "Bash(git pull:*)",
+      "Bash(pnpm build:*)",
+      "Skill(read-code)",
+      "Bash(npm run cli:*)",
+      "Bash(scout:*)",
+      "WebFetch(domain:docs.scrapecreators.com)",
+      "WebFetch(domain:scrapecreators.com)",
+      "Bash(gh auth status:*)",
+      "Bash(optima-agent:*)",
+      "Bash(python3:*)",
+      "Bash(python3 -c \" import sys content = sys.stdin.read\\(\\) # Find flushMessageQueueSync idx = content.find\\(''flushMessageQueueSync''\\) # Get context around it lines = content.split\\(''\\\\n''\\) for i, line in enumerate\\(lines\\): if ''flushMessageQueueSync'' in line and ''private'' in line: for j in range\\(i, min\\(i+20, len\\(lines\\)\\)\\): print\\(f''{j+1}: {lines[j]}''\\) break \")",
+      "Bash(optima:*)",
+      "WebFetch(domain:www.npmjs.com)",
+      "WebFetch(domain:registry.npmjs.org)",
+      "WebFetch(domain:zod.dev)",
+      "Bash(npm ls:*)",
+      "Bash(NODE_DEBUG=child_process npx tsx:*)",
+      "Bash(DEBUG_CLAUDE_AGENT_SDK=1 npx tsx:*)",
+      "Bash(CLAUDECODE= npx tsx:*)",
+      "Bash(env:*)",
+      "Bash(gh release:*)",
+      "Bash(npm info:*)",
+      "Bash(gh run:*)",
+      "Bash(gtimeout 90:*)",
+      "Bash(sentinel:*)",
+      "Bash(gh pr:*)",
+      "Bash(git fetch:*)",
+      "Bash(git log:*)",
+      "Bash(npm bin:*)",
+      "Bash(git status:*)",
+      "Bash(browser-cli --version && browser-cli --help)",
+      "Bash(browser-cli status:*)",
+      "Bash(browser-cli launch:*)",
+      "Bash(browser-cli screenshot:*)",
+      "Bash(browser-cli --version)",
+      "Bash(browser-cli close:*)",
+      "Bash(npm update:*)",
+      "Bash(node -e \"console.log\\(require\\('./node_modules/@optima-chat/browser-cli/package.json'\\).version\\)\")",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(aws ecs:*)",
+      "Bash(aws ecr:*)",
+      "Bash(gh search:*)",
+      "Bash(npx tsc:*)",
+      "Bash(find /Users/verypro/optima-agent -path */node_modules -prune -o -type f \\\\\\(-name *comfy* -o -name *gen* \\\\\\) -print)",
+      "Bash(export PATH=\"/usr/local/bin:$PATH\")",
+      "Bash(pnpm add:*)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/max-rounds-hit)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/budget-almost-spent)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/two-active-campaigns)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/brand-only)",
+      "Bash(pnpm vitest:*)",
+      "Bash(pnpm test:*)",
+      "Bash(pnpm --filter @optima-scout/backend test --reporter=verbose backend/src/routes/outreach/__tests__/lock.test.ts backend/src/routes/outreach/__tests__/inbound.test.ts)",
+      "Bash(npx vitest:*)",
+      "Bash(DATABASE_URL=postgres://optima_scout:optima_scout_dev@localhost:7293/optima_scout pnpm --filter @optima-scout/backend test)",
+      "Bash(pnpm --filter @optima-scout/backend exec vitest run src/routes/outreach/__tests__/inbound.test.ts)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.claude/skills/.kb-skills-managed.json

@@ -0,0 +1,9 @@
+{
+  "skills": [
+    "ingesting-sources",
+    "initializing-kb",
+    "linting-the-wiki",
+    "querying-the-wiki",
+    "updating-related-pages"
+  ]
+}

package/.claude/skills/ingesting-sources/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: ingesting-sources
+description: Use when new source material needs to be incorporated into a maintained knowledge base.
+---
+
+# Ingesting Sources
+
+这个 skill 负责把原始材料做第一次落库，进入持续维护的 wiki 结构。它的产物不只是摘要，而是一页来源页，以及一份清晰的“还有哪些页面需要随之更新”的映射。
+
+## 职责
+
+- 从 `raw/` 读取新来源
+- 在 `wiki/sources/` 中创建或更新对应页面
+- 抽取关键事实、实体和主题
+- 标出 wiki 其他位置中受影响的页面
+
+## 不负责
+
+- 全量维护性清理
+- 泛化问答
+
+## 工作规则
+
+来源页不仅要说明来源说了什么，还要说明它会如何影响 wiki 的其他部分。
+
+## 流程
+
+使用这个 skill 时，按以下顺序进行：
+
+1. 在 `raw/` 中定位来源文件
+2. 仔细阅读来源，提取主要论点、证据、实体和开放问题
+3. 在 `wiki/sources/` 中创建或更新对应页面
+4. 列出哪些 entity、overview 和 analysis 页面受到影响
+5. 如果任务范围包含来源页之外的更新，就交给 `updating-related-pages` 的行为处理，或执行一次有边界的相关页更新
+6. 如果这个来源是首次进入 wiki，则更新 `index.md` 和 `log.md`
+
+## 来源页内容
+
+除非仓库已经有更强的既有格式，否则来源页应至少包含：
+
+- 来源标题
+- 简短摘要
+- 关键论点
+- 关键证据或观察
+- 相关实体、主题或概念
+- 对既有理解产生的冲突、修正或压力
+- 指向受影响页面的链接
+
+## 抽取规则
+
+在 ingest 过程中：
+
+- 将来源明确表达的内容与你自己的综合推断区分开
+- 不要把大段原文直接复制进 wiki
+- 优先写成简洁、可链接、之后可更新的陈述
+- 当来源含混或不完整时，显式记录不确定性
+- 遇到冲突要记录，不要静默抹平
+
+## 何时创建相关页面
+
+在 ingest 过程中，出现下列情况时应建议新建页面：
+
+- 某个人、组织、产品或概念很重要，但还没有稳定页面
+- 来源引入了一个新的 recurring topic
+- 来源实质性改变了某个既有 overview
+- 形成的综合结果已经明显值得进入 `wiki/analyses/`
+
+## 最小交付标准
+
+一次成功的 ingest 至少应留下：
+
+- 一页可用的 `wiki/sources/` 页面
+- 一份清晰的受影响页面列表
+- 足够明确的结构，使下一步 update 很自然
+
+如果 ingest 最终只留下了一段模糊摘要，而没有连到 wiki 的其他部分，那它就是不完整的。

package/.claude/skills/initializing-kb/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: initializing-kb
+description: Use when creating a new markdown-based knowledge base, or when an existing repository needs to be turned into a structured knowledge base with clear page types and maintenance rules.
+---
+
+# Initializing KB
+
+这个 skill 用来定义一个基于 Markdown 的知识库的运行契约。它的主要产物是一份可用的 `AGENTS.md`，以及少量与之匹配的模板调整，使仓库真正可维护。
+
+## 职责
+
+- 定义页面类型
+- 定义命名约定
+- 定义 ingest、query 和 lint 工作流
+- 创建或更新 `AGENTS.md`
+
+## 不负责
+
+- ingest 具体来源
+- 大范围 wiki 维护
+
+## 工作规则
+
+优先使用少量、边界清晰的页面类型，而不是难以维护的深层目录体系。
+
+## 流程
+
+使用这个 skill 时，按以下顺序进行：
+
+1. 检查当前仓库布局
+2. 确认 `raw/`、`wiki/`、`index.md`、`log.md` 和 `AGENTS.md` 是否已经存在
+3. 判断现有结构是可小修复用，还是需要更强约束的重整
+4. 定义这个仓库所需的最小页面类型集合
+5. 编写或更新 `AGENTS.md`
+6. 做少量与规则匹配的模板调整，保证仓库布局和规则一致
+
+除非知识库规模和内容已经明确需要，否则不要发明庞大的分类体系。
+
+## 默认结构
+
+除非仓库已经有更成熟的既有结构，否则优先采用这个默认形态：
+
+```text
+raw/
+wiki/
+  overview/
+  entities/
+  sources/
+  analyses/
+index.md
+log.md
+AGENTS.md
+```
+
+## 页面模型
+
+默认页面职责如下：
+
+- `wiki/sources/`：每个来源一页
+- `wiki/entities/`：每个跨多个来源反复出现的稳定实体或概念一页
+- `wiki/overview/`：每个主题或认知领域一页
+- `wiki/analyses/`：长期有效的答案、比较、综合或决策记录
+
+避免混淆这些角色。来源页不应同时承担某个概念的长期实体页职责，分析页也不应取代主题综述页。
+
+## 命名规则
+
+优先使用可预测的命名：
+
+- 来源页：`YYYY-MM-DD-short-source-name.md`
+- 分析页：`YYYY-MM-DD-short-analysis-name.md`
+- 实体页：`kebab-case-entity-name.md`
+- 综述页：`kebab-case-topic-name.md`
+
+统一优先使用 ISO 日期和 kebab-case。
+
+## `AGENTS.md` 必须定义什么
+
+至少应包含：
+
+- 仓库目标
+- `raw/` 的 source-of-truth 规则
+- 页面类型及其职责
+- ingest 工作流
+- query 工作流
+- lint 工作流
+- 编辑规则
+- 命名约定
+- 何时应新建页面，而不是继续扩写旧页
+- agent 修改后的输出要求
+
+## 好的结果
+
+一个好的 schema 应该让这些决策变得容易：
+
+- 新来源应该落到哪里
+- 一个概念什么时候值得拥有独立实体页
+- 一个高价值答案应该写回哪里
+- 冲突信息应如何呈现
+- 之后如何再次找到这些页面
+
+如果更新完 `AGENTS.md` 之后这些决策仍然模糊，说明 schema 还没有完成。