Skip to content

Commit 2ee9e24

Browse files
author
zxhwolfe
committed
feat: consolidate Topic Intelligence into one Skill
1 parent 5e9c141 commit 2ee9e24

39 files changed

Lines changed: 1863 additions & 1063 deletions

‎.github/workflows/ci.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ jobs:
2626
- name: Compile Python sources
2727
run: python -m compileall -q scripts skills
2828
- name: Validate Host Eval suites
29-
run: python scripts/run_host_evals.py --suite v0.2.1 --dry-run
29+
run: python scripts/run_host_evals.py --suite v0.2.1 --dry-run && python scripts/run_host_evals.py --suite v0.3.0 --dry-run
3030
- name: Validate real Host Eval gate implementation
3131
run: python -m unittest tests.test_host_eval_runner tests.test_topic_radar_client -q
3232
- name: Build release archives

‎.github/workflows/release.yml‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,12 @@ jobs:
3232
- name: Run offline tests
3333
run: python3 -m unittest discover -s tests -v
3434

35-
- name: Verify bundled runtime and v0.2.1 eval contract
35+
- name: Verify bundled runtime and current eval contract
3636
run: |
3737
python3 scripts/sync_skill_runtime.py --check
38-
python3 scripts/run_host_evals.py --suite v0.2.1 --dry-run
38+
VERSION="$(cat VERSION)"
39+
if [ "$VERSION" = "0.2.2" ]; then SUITE="v0.2.1"; else SUITE="v0.3.0"; fi
40+
python3 scripts/run_host_evals.py --suite "$SUITE" --dry-run
3941
4042
- name: Verify persistent live Host Eval RC evidence for new releases
4143
if: ${{ github.ref_name != 'v0.2.1' }}

‎CHANGELOG.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,21 @@ All notable public changes to AI Workstation Topic Intelligence are recorded her
44

55
The project follows Semantic Versioning for distributable Skill releases.
66

7+
## [0.3.0] - Unreleased
8+
9+
The v0.3.0 product line consolidates the public experience into one
10+
`topic-intelligence` Skill and one install archive. It automatically recognizes
11+
selection-only, supplied-topic brief, and selection-followed-by-brief requests.
12+
13+
### Changed
14+
15+
- Fixed helper execution to `python3` with deterministic argument ordering and bounded Radar scans.
16+
- Added strict operation-specific runtime/evidence grading and isolated Skill fixtures with neutral Host workspaces.
17+
- Preserved Radar facts, Host editorial analysis, and unknowns as separate layers; public usage does not consume AI Workstation server-side LLM quota.
18+
- Added persistent live Host Eval evidence as the release gate for the unified Skill package.
19+
20+
The v0.2.0 line remains the last version with manual ChatGPT Web ZIP upload evidence. v0.2.1 and v0.2.2 Host Eval records do not claim ChatGPT Web UI validation.
21+
722
## [0.2.2] - 2026-08-11
823

924
v0.2.2 introduces a persistent live Host Eval evidence gate for release validation.

‎README.md‎

Lines changed: 35 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -4,27 +4,21 @@
44

55
[简体中文](README.zh-CN.md)
66

7-
Current package version: **v0.2.2**
7+
Current package version: **v0.3.0**
88

9-
v0.2.0 proved that the standalone Skills can upload/run in ChatGPT, execute their bundled runtime, reach the live AI Workstation Topic Radar, and compose Creator → Brief. v0.2.2 keeps that workflow and adds deterministic `python3` helper invocation, bounded Radar scans, strict runtime/evidence grading, isolated Skill fixtures and neutral Host workspaces, and persistent release evidence. **Normal public Skill usage must not consume AI Workstation server-side LLM quota.**
9+
v0.2.0 proved the original standalone packages could upload/run in ChatGPT and reach the live Radar. v0.3.0 presents that capability as one public Skill and one install package with three intent-driven modes. It keeps deterministic `python3` helper invocation, bounded Radar scans, strict runtime/evidence grading, isolated Skill fixtures and neutral Host workspaces, and persistent release evidence. **Normal public Skill usage must not consume AI Workstation server-side LLM quota.**
1010

1111
Topic Intelligence sits on top of the existing AI Workstation Global Topic Radar. It does not build another crawler, score, database, or persistence layer.
1212

13-
## What can I use it for?
13+
## One Skill, three automatic modes
1414

1515
### 1. What is worth researching today?
1616

1717
```text
1818
今天有哪些 AI 题材值得我继续研究或做内容?先检查 Radar 是否足够新,再给我最值得看的 3 个。
1919
```
2020

21-
Expected Skill:
22-
23-
```text
24-
creator-topic-opportunity-research
25-
```
26-
27-
The Skill reads live Radar evidence, checks freshness/source coverage, and uses the **host model** to explain which candidates may be worth researching.
21+
The `topic-intelligence` Skill reads live Radar evidence, checks freshness/source coverage, and uses the **host model** to explain which candidates may be worth researching. It stops at the requested shortlist and does not add an unsolicited brief.
2822

2923
### 2. Is there a cross-market early opportunity?
3024

@@ -40,21 +34,19 @@ Cross-market timing or audience saturation remain hypotheses unless the current
4034
从当前 AI 热点里挑一个适合 2–3 分钟解释型内容的题材,给我受众收益、最强角度、前三秒、叙事结构、必须核验的事实、不能乱说的内容和素材建议。
4135
```
4236

43-
Preferred workflow when both Skills are installed:
37+
The same Skill automatically selects the smallest workflow:
4438

4539
```text
46-
creator-topic-opportunity-research
47-
-> ati.topic-opportunity-handoff.v1
48-
-> evidence-backed-content-brief
40+
selection only
41+
supplied current topic -> brief
42+
one bounded selection -> brief for the same finalist
4943
```
5044

51-
The Creator Skill selects one finalist and preserves the exact live `id`. The Brief Skill continues from that handoff without selecting the topic again.
52-
53-
If only the Brief Skill is installed, it can run one bounded live selection pass (normally no more than 5 candidates), select at most one, optionally inspect its history, and then use the **current ChatGPT/Codex/agent model** to produce the brief.
45+
The combined mode performs one bounded feed, preserves the exact live `id`, and does not reselect while writing the brief.
5446

55-
## Public Skill cost boundary — v0.2.2
47+
## Public Skill cost boundary — v0.3.0
5648

57-
The distributable public Skills are designed to spread without silently spending the publisher's model budget.
49+
The distributable public Skill is designed to spread without silently spending the publisher's model budget.
5850

5951
### Public bundled runtime
6052

@@ -92,24 +84,13 @@ AI Workstation may still provide server-generated Topic Insight as a paid/accoun
9284

9385
For example, a future AI Workstation App/Plugin/OAuth connection could expose Premium Insight. The public bundled helper is intentionally **not** that authentication layer.
9486

95-
No authenticated Premium connection is required to use the public Skills. The host model completes the brief itself.
87+
No authenticated Premium connection is required to use the public Skill. The host model completes the brief itself.
9688

97-
## The two Skills
89+
## The public Skill
9890

99-
### `creator-topic-opportunity-research`
91+
### `topic-intelligence`
10092

101-
Compare and prioritize live Radar candidates for creator/editorial decisions, including:
102-
103-
- rising/early opportunities;
104-
- freshness and source coverage;
105-
- platform/region differences;
106-
- evidence breadth;
107-
- cross-market hypotheses;
108-
- one structured handoff to Brief.
109-
110-
### `evidence-backed-content-brief`
111-
112-
Turn a current Radar topic into a practical, evidence-bounded content plan with:
93+
Compare and prioritize live Radar candidates, or turn one current Radar topic into a practical, evidence-bounded content plan with:
11394

11495
- recommendation and audience payoff;
11596
- strongest angle;
@@ -119,13 +100,14 @@ Turn a current Radar topic into a practical, evidence-bounded content plan with:
119100
- `must_verify`;
120101
- `avoid_claims`;
121102
- visual/material needs;
122-
- known unknowns and risks.
103+
- known unknowns and risks;
104+
- a single current-task selection-to-brief workflow when both are requested.
123105

124106
In normal public mode these editorial fields are produced by the **host model**, not by an AI Workstation server model.
125107

126108
## Query-quality rules
127109

128-
v0.2.2 also hardens real issues found in ChatGPT smoke testing and Host Eval:
110+
v0.3.0 carries forward the hardening from v0.2.2 and makes it the default public package:
129111

130112
- content format/duration/language/audience are **not** Radar platform/source filters;
131113
- explicit topic scope must be preserved from the first query (`AI` should not first expand to generic technology);
@@ -138,23 +120,24 @@ Canonical rule set:
138120
references/topic-intelligence-quality-contract.md
139121
```
140122

141-
Each Skill carries the same contract at:
123+
The package carries the same contract at:
142124

143125
```text
144126
references/quality-contract.md
145127
```
146128

147129
## Standalone runtime
148130

149-
Each Skill release archive is self-contained:
131+
The single Skill release archive is self-contained:
150132

151133
```text
152-
skill-name/
134+
topic-intelligence/
153135
SKILL.md
154136
agents/openai.yaml
155137
scripts/topic_radar_client.py
156-
references/handoff-contract.md
157138
references/quality-contract.md
139+
references/selection-workflow.md
140+
references/brief-workflow.md
158141
LICENSE
159142
```
160143

@@ -185,9 +168,9 @@ See [`docs/distribution.md`](docs/distribution.md).
185168

186169
### ChatGPT
187170

188-
The published v0.2.0 ZIPs were manually tested in ChatGPT web in Creator-only, Brief-only, and both-Skills shapes. Package upload, Skill discovery, bundled runtime execution, live Radar access, and behavioral composition passed.
171+
The published v0.2.0 ZIPs were manually tested in ChatGPT web in Creator-only, Brief-only, and both-Skills shapes. v0.3.0 consolidates those user-facing workflows into one package; its Codex/Host Eval evidence does not claim a new ChatGPT Web upload test.
189172

190-
The v0.2.1 and v0.2.2 Host/Codex Eval results are separate host/runtime acceptance, not claims that the corresponding ChatGPT Web ZIP upload UI was re-tested. The latest v0.2.2 evidence additionally persists the complete live suite, manual review, and verifier output.
173+
The v0.2.1 and v0.2.2 Host/Codex Eval results remain historical acceptance records, not claims that their ChatGPT Web ZIP upload UI was re-tested. v0.3.0 will carry its own Host Eval evidence before publication.
191174

192175
See:
193176

@@ -225,9 +208,9 @@ AI Workstation Global Topic Radar
225208
|
226209
| public read API
227210
v
228-
AI Workstation Topic Intelligence public Skills
229-
evidence checks -> creator decision -> handoff
230-
-> host-model content brief
211+
AI Workstation Topic Intelligence public Skill
212+
evidence checks -> automatic selection / supplied-topic brief
213+
-> same-finalist host-model content brief when requested
231214
232215
Future optional Premium connection
233216
authenticated user -> membership/quota enforcement
@@ -236,6 +219,8 @@ Future optional Premium connection
236219

237220
The public Skill repository intentionally does not duplicate crawlers, clustering, score, persistence, billing, authentication, or the server model backend.
238221

222+
For operating guidance, examples, the official download path, and anonymous metrics/privacy boundaries, see [`docs/topic-intelligence-operations.md`](docs/topic-intelligence-operations.md).
223+
239224
## Validation
240225

241226
```bash
@@ -249,14 +234,14 @@ The suite covers:
249234
- portable helper/reference parity;
250235
- deterministic standalone archives;
251236
- extracted ZIP execution outside the repository;
252-
- handoff identity rules;
253-
- bounded Brief fallback;
237+
- unified selection/brief mode rules;
238+
- bounded scan and no-reselection rules;
254239
- ChatGPT-derived v0.2.1 query/provenance/cost cases;
255240
- proof that the public helper exposes no `insight` command and emits only GET requests.
256241

257242
Useful evidence:
258243

259-
- [`evals/v0.2.1-skill-quality.json`](evals/v0.2.1-skill-quality.json)
244+
- [`evals/v0.3.0-skill-quality.json`](evals/v0.3.0-skill-quality.json)
260245
- [`evals/host-capabilities.json`](evals/host-capabilities.json)
261246
- [`docs/m3.1-final-acceptance-2026-08-09.md`](docs/m3.1-final-acceptance-2026-08-09.md)
262247
- [`docs/chatgpt-v0.2.0-smoke-result-2026-08-09.md`](docs/chatgpt-v0.2.0-smoke-result-2026-08-09.md)
@@ -271,6 +256,7 @@ Useful evidence:
271256

272257
## Status
273258

274-
- **v0.2.2:** current package version; public mode uses host reasoning, deterministic bounded helper calls, isolated Host execution, and persistent live evidence without spending AI Workstation server-side LLM quota.
259+
- **v0.3.0:** current package line; one public Skill and one ZIP expose three intent-driven modes, with deterministic helper calls, isolated Host execution, and persistent live evidence.
260+
- **v0.2.2:** immutable two-Skill historical package line with persistent Host Eval evidence.
275261
- **v0.2.1:** prior immutable Host-validated package line; its Codex/Host Eval does not represent ChatGPT Web UI validation.
276262
- **v0.2.0:** previous immutable release and the most recent version manually uploaded in ChatGPT web.

0 commit comments

Comments
 (0)