siluzan-tso-cli 1.1.1-beta.2 → 1.1.1-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -20,7 +20,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
20
20
  siluzan-tso init --force # 强制覆盖已存在文件
21
21
  ```
22
22
 
23
- > **注意**:当前为测试版(1.1.1-beta.2),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
23
+ > **注意**:当前为测试版(1.1.1-beta.3),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
24
24
 
25
25
  | 助手 | 建议 `--ai` |
26
26
  |------|-------------|
@@ -50,16 +50,21 @@ description: 当判断用户可能需要以下功能时可以使用siluzan-tso
50
50
  -
51
51
  ## AI 行为规范
52
52
  ### 如何更好的使用本skill执行任务
53
- 遵循计划,确认,执行,验证
53
+ 遵循计划,确认,执行,验证,推测用户下一步意图
54
54
  1. 计划阶段:
55
55
  - 根据功能以及对应文档读取对应references
56
- - 根据references文件中的内容,通过命令行 -h参数,来确认命令行的正确调用方式
56
+ - 根据references文件中的内容配合命令行工具提供的-h参数,来确认命令行的正确调用方式
57
57
  - 不暴露cli执行细节的前提下,输出一份计划
58
58
  2. 确认阶段:在不暴露执行命令行的前提下,与用户确认关键信息
59
59
  3. 执行阶段:按计划执行
60
- 4. 验证阶段:一般情况下,读/写的命令都是成对的
61
- 5. 对话历史验证:如果任务前面有计划,你需要确认每个步骤都已经按计划中的内容执行完毕
62
- 6. 与用户确认输出结果是否满意
60
+ 4. 验证阶段:
61
+ - 一般情况下,读取/写入的命令都是成对的。通过这两种命令的配合来进行结果验证
62
+ - 如果是异步任务,需要你轮询读取命令,每5s一次查看任务状态,直到确认所有异步任务都有一个结果
63
+ - 如果失败则可以查看失败具体原因,或者结合现有命令行使用其他方式进行重试,尽量让任务执行完成,而不是告诉用户任务失败就结束了。
64
+ 5. 对话历史验证:
65
+ - 如果任务前面有计划,你需要确认每个步骤都已经按计划中的内容执行完毕
66
+ 6. 推测用户下一步意图
67
+ - 结合命令行工具与references文件中的说明,对用户下一步的操作进行合理预测
63
68
 
64
69
  ### 硬规范
65
70
  - **不确定时读文档**:遇到不熟悉的命令,先读对应 references 文件或使用-h查看命令帮助,不要猜参数。
@@ -74,7 +79,7 @@ description: 当判断用户可能需要以下功能时可以使用siluzan-tso
74
79
  ### 必须一定要遵守的规范,如不遵守,会导致skill无法使用
75
80
  - 在使用本skill输出的任何内容中,包括但不限于报告,计划,总结,严禁让用户执行本skill提供的命令行。(setup.md)中的命令除外
76
81
  - 使用skill时,你要检查skill文件版本是否与siluzan-tso cli版本一致,如不一致,优先更新siluzan-tso cli再通过cli命令或cli npm包中携带的skill来更新你当前的skill文件(详情请读取`references/setup.md`)
77
-
82
+ - 所有使用本skill获取的数据输出的报告,总结,分析性的内容,都需要通过skill中内置模板的格式来输出
78
83
 
79
84
  ## 一些tips
80
85
 
@@ -93,4 +98,7 @@ Kwai: act_1716030xxx734076
93
98
 
94
99
  - 401 Unauthorized
95
100
  注意是平台方返回的还是我们自己返回的401,通常,平台方(google,bing, yandex,tiktok,kwai)返回的需要用户重新授权
96
- 如果是我们自己的接口返回的,则可以让用户 重新打开命令行执行 `siluzan-tso login`(详情请读取`references/setup.md`)
101
+ 如果是我们自己的接口返回的,则可以让用户 重新打开命令行执行 `siluzan-tso login`(详情请读取`references/setup.md`)
102
+
103
+ - 500
104
+ 大概率是服务可能正在部署或升级,可以让用户提交给Silizan相关人员
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.1-beta.2",
4
- "publishedAt": 1775101272658
3
+ "version": "1.1.1-beta.3",
4
+ "publishedAt": 1775112694285
5
5
  }
@@ -13,6 +13,7 @@
13
13
  3. 根据默认模板:`report-templates/report-template.html` 为样式基准来生成html 然后将html转为pdf交付
14
14
  4. 输出 HTML 时:**默认**以 `report-templates/report-template.html` 为样式基准(适用于一切总结性、报告性、汇总性成稿);若场景更适合作正式件、深色、单页等,再从 `report-templates/report-template*.html` 中选或询问用户,并对照 `report-templates/README.md`
15
15
  5. 注意最终交付的是用html生成的PDF
16
+ 6. 使用浏览器或能够打开html/pdf的插件帮用户打开报告
16
17
 
17
18
  用于按账户维度拉取 Google Ads 报表、结构类数据。
18
19
 
@@ -2,7 +2,7 @@
2
2
  > 所属 skill:`siluzan-tso`。
3
3
  ---
4
4
 
5
- ## 广告优化/修改/新建广告系列的流程
5
+ ## 新建广告系列的流程
6
6
 
7
7
  > **强制流程总览(AI 必须严格遵守)**
8
8
  > 1)先完整阅读所有规则文档 → 2)向用户补齐关键信息提问 → 3)在规则约束下设计广告计划 → 4)按模板输出方案并获得用户「明确确认」 → 5)**仅在已确认的前提下**执行任何结构性改动。
@@ -51,13 +51,26 @@
51
51
 
52
52
  > **AI Agent 额外要求**:即使用户强烈要求「不用看方案、直接创建」,也必须先按上述模板输出一次完整 Markdown 投放方案,并在对话中列出**已参考的规则文档列表**(`google-ads.md` 与 `references/google-ads-rules/` 目录下的文件),让用户有机会发现问题后再执行,防止误投和配置错误。
53
53
 
54
- Google 广告管理的典型工作流:
54
+ ## 修改
55
55
 
56
- ```
57
- 查广告系列列表 查广告组列表 → 查广告/关键词
58
- ↓ ↓ ↓
59
- 启停/删除 创建/启停/删除 创建/删除
60
- ```
56
+ - 对用户提出的修改内容进行评估与拓展评估标准基于(references/googles-ads-rules/*.md)中的对应的文件来确认
57
+ - 确认修改方案按照
58
+ - 读取`references/google-ads-rules/google-ads-launch-plan-template.md` 中关于计划模板的描述,节选用户需要修改的部分来按格式输出给用户确认
59
+ - 使用对应命令来进行修改
60
+ - 使用ad -h 来查询有哪些修改命令
61
+ - 使用对应的获取命令进行校验
62
+
63
+ ## 新增
64
+
65
+ 参考修改的流程,将修改的命令改为新增
66
+
67
+ ## 优化
68
+
69
+ 参考修改的流程,优化的部分需要有新旧对照的表格,其他与修改流程一致
70
+
71
+
72
+
73
+ ## 下面是相关命令的示例,参考就行
61
74
 
62
75
  **ID 来源说明:**
63
76
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.1.1-beta.2",
3
+ "version": "1.1.1-beta.3",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据,管理绑定关系与充值。",
5
5
  "type": "module",
6
6
  "bin": {