riksdagsmonitor：AI Agent 工具实践指南

实际看riksdagsmonitor，先要确认它的用途：riksdagsmonitor 瑞典公共事务情报平台 — 民主透明度、基于证据的分析和 AI- 生成的公共事务新闻，由官方开放数据和完全自主的代理新闻编辑室提供支持。数据与知识处理里，数据结构、更新策略和可追溯性会决定结果是否可信。我会用一份规模可控且答案已知的数据集试跑，检查模式兼容、增量更新、查询结果和来源追踪。它适合需要保留数据来路与变更记录的使用者；采用前仍要看维护状态和试跑结果。

riksdagsmonitor

瑞典公共事务情报平台 — 民主透明度、基于证据的分析和 AI- 生成的公共事务新闻，由官方开放数据和完全自主的代理新闻编辑室提供支持。

使命

通过系统透明度加强瑞典民主。

riksdagsmonitor 的存在是为了将严格的、基于证据的公共事务情报交到每个公民、记者、研究人员和正策制定者手中。我们结合：

• 结构化情报交易 — ACH、SWOT、PESTLE、STRIDE、公共事务风险评分、OSINT/INTOP 方法、ICD-203 关键判断
• 民主透明度 — 每项主张都可追溯到主要来源（dok_id，投票计数，名为 MP，正府文件），否则不会发布
• AI-生成公共事务新闻 - 一个完全自主的新闻编辑室，每天将开放数据转化为 14 种语言的分析文章
• 50 多年的历史证据 — 来自 公民情报局 (CIA) 平台的 1971-2024 年投票记录、文档语料库和政党演变分析
• ⚖ 中立性和 GDPR 设计 - 平等对待所有 8 个议会政党、仅公开数据、设计隐私架构、明确的民主保障

该平台是无党派、开源（Apache-2.0），并在 Hack23 ISMS 下运行，具有完整的 ISO 27001:2022 / NIST CSF 2.0 / CIS 控制 v8.1 对齐。它不收集用户数据，不投放广告，不推送叙事，其架构设计使其无法成为党派影响力的武器。

探索平台

公共网站有五个旗舰页面。每个都是多语言（14 种语言），WCAG 2.1 AA 可访问，SEO- 已优化，具有 JSON-LD 结构化数据和 hreflang 替代数据，以及 CSP- 硬化，具有每个 CDN 资产的子资源完整性 (SRI)。

支持14种语言： 英语·瑞典语·丹麦语·挪威语·芬兰语·德语·法语·西班牙语·荷兰语·阿拉伯语（RTL）·希伯来语（RTL）·日语·韩语·中文。

AI-生成的公共事务情报新闻

“虽然传统新闻编辑室还在争论 AI 是否会取代记者，但 riksdagsmonitor 已经运营着一个完全自主的公共事务情报新闻编辑室——14 种代理工作流程、14 种语言、零人工编辑，以及一个会让任何试图跟上的传统媒体破产的出版时间表。”

是什么让它与众不同

传统的 AI- 生成的新闻很肤浅——它重写了新闻稿。 riksdagsmonitor 的管道在撰写文章的单个句子之前执行深入的公共事务情报分析：

• 来源验证 — 每项声明都通过 riksdag-regering MCP 服务器（32+ 工具）追溯到官方 Riksdag/Regering 数据
• ⚖ 多党平衡 — 所有 8 个议会政党的算法公平，不可能存在编辑偏见
• 定量严谨性 — 投票凝聚力指标、出勤评分、立法生产力指数、ICD-203 关键判断、45 条规则透明度评分
• 14 种语言覆盖 — 文化适应的公共事务分析，支持 RTL（阿拉伯语/希伯来语），而不是机器翻译
• GDPR- 兼容 OSINT — 仅公开议会数据；公共事务意见根据 GDPR Art 进行处理。 9(2)(e)（明显公开）/ 9(2)(g)（重大公共利益）
• 前瞻性报道 — 周/月/季度/年/选举周期范围，具有注册表驱动的范围分层（请参阅 analysis/article-types.json）
• 硬分析门 - 每个新闻工作流程 MUST 在文章生成之前都会在磁盘上生成 9 个（单一类型）或 14 个（C 层）分析工件； .github/prompts/05-analysis-gate.md 的登机口是不可协商的
• 质量门 — HTMLHint 验证、链接检查、可访问性 (WCAG 2.1 AA) 以及发布前 CI 中的翻译对等

端到端管道

flowchart LR
  A[ MCP + CIA + SCB + IMF
data download] --> B[ Apply methodology
analysis/methodologies]
  B --> C[ Populate templates
analysis/templates]
  C --> D[ Write 9 or 14 artifacts
analysis/daily/$DATE/$SUBFOLDER]
  D --> E{ Analysis Gate
prompts/05}
  E -- pass --> F[ Aggregate → article.md
scripts/aggregate-analysis.ts]
  E -- fail --> C
  F --> G[ Sanitised HTML
scripts/render-articles.ts]
  G --> H[ Translate into
12 other languages]
  H --> I[ One PR per article type
S3 + CloudFront deploy]
  style A fill:#0a0e27,stroke:#00d9ff,color:#e0e0e0
  style E fill:#dc3545,stroke:#b02a37,color:#fff
  style I fill:#1a1e3d,stroke:#ffbe0b,color:#e0e0e0

在 analysis/daily/$DATE/$SUB/ 下的任何位置编写的新 .md 工件足以在下一个 CI 构建上发布英语 + 瑞典语 HTML 文章 - 没有手动脚手架，没有模板填充，也没有每个类型的生成器类。然后，专用的 news-translate 工作流程会传播到带外的其余 12 种语言。有关完整的代理工作流合同，请参阅 Article-Generation.md。

自主出版时间表

.github/workflows/news-*.lock.yml 中定义的权威计划 — 请参阅 .github/workflows/README.md 了解完整清单。

结果： 每周发布 14 种语言的数十篇文章 — 每月数百种本地化情报产品，在零编辑干预的情况下自主生成，每一篇都可审计到其来源 dok_id。

公共事务情报方法论

平台上的每项分析均由明确的版本控制方法控制。完整的库可在 https://riksdagsmonitor.com/political-intelligence.html 上浏览；规范来源位于 analysis/。

证据标准

每项声明都必须与：dok_id 引用、指定演员、计票数或主要来源 URL。没有证据的通用陈述会被分析门拒绝。 AI 是一个加速方案——绝不是浅输出的借口。

AI-FIRST质量原则

每次分析至少2次完整迭代。第 1 遍产生工件；第 2 遍回顾所有内容并改进每个部分（更有力的证据、更深入的分析严谨性、更广泛的利益相关者覆盖范围、量化的风险）。在分配时间的 75% 以下完成的工作流程将被视为失败。请参见 AGENTS.md §AI-FIRST。

交互式智能仪表板

https://riksdagsmonitor.com/ 上的五个旗舰 Chart.js / D3.js 仪表板（以及合并的 CIA 智能仪表板）：

仪表板属性 — 本地优先数据加载，具有 1 小时缓存； WCAG 2.1 AA 可访问（键盘、屏幕阅读器、4.5:1 对比度）； 14种语言；响应式 320 像素 → 1440 像素+； CSP- 与所有 CDN 资源上的 SRI 哈希 (sha384) 兼容。

透明度统计

实时号码（每天 03:00 CET 通过 update-cia-csv-data.yml 更新）：

数据来源： extraction_summary_report.csv · 缓存在cia-data/production-stats.json（24小时新鲜度）。

权威数据源

riksdagsmonitor 使用提供商分层数据架构，每个提供商根据其优势领域进行选择。

为何进行这种划分 — IMF 在各个国家/地区使用统一的 SNA 2008 / GFSM 2014 / BPM6 方法（对于跨国比较至关重要），发布 T+5 预测（对于前瞻工作流程至关重要），以及拥有比世界银彳经济指标更新的数据。世界银彳对于 IMF 未发布的类（WGI 治理、环境）仍然是规范的。 SCB 是瑞典特定的地面实况层。 禁用短语（e.g。“世界银彳报告瑞典 GDP 增长...”）和复古纪律（数据 > 6 个月前→需要注释）由 CI 根据 .github/aw/ECONOMIC_DATA_CONTRACT.md 强制执行 v2.1。

技术架构

完整的系统架构（C4上下文/容器/组件/动态视图）位于ARCHITECTURE.md (v2.2)。

堆栈

• 前端 — 静态 HTML5 / CSS3 与 TypeScript-built Chart.js / D3.js 仪表板（无 SPA 框架、移动优先、赛博朋克主题）
• 语言 — TypeScript 6.0.2 兼容性包 (typescript) 加上 TypeScript 7.0.1-rc (typescript-7) 在迁移过程中并行运行
• 构建 — Vite 8.1.3（ES 模块、代码分割、SRI 通过 vite-plugin-sri-gen）
• 可视化 — Chart.js 4.5.1 + D3.js 7.9.0，本地托管在 CloudFront 上
• 测试 — Vitest 4.1.10（2,890 个单元测试，100% 通过率，70% 线路覆盖率）+ Cypress 15.18.1 (E2E)
• 托管 — AWS CloudFront + S3 双区域（us-east-1 主库、eu-west-1 副本）通过 OIDC； GitHub 页面作为 DR 后备
• CI/CD — 50 个 GitHub Actions 工作流程文件（22 个标准 .yml + 14 个代理 .md 源 + 14 个已编译的 .lock.yml）； SHA-固定，step-security/harden-runner无处不在
• 数据平台 — 公民情报局 (CIA) Java/Spring 启动后端 + 15 个 CIA 子系统
• 运行时 — Node.js 26.x

架构文档组合

安全、隐私和 ISMS 合规性

SECURITY_ARCHITECTURE.md 中的完全控制 · THREAT_MODEL.md 中的威胁模型 · CRA 中的一致性CRA-ASSESSMENT.md。

分类（根据 Hack23 分类框架）

合规框架

• ISO 27001:2022 — 实施 7 个附件 A 控制措施 · NIST CSF 2.0 — 6 个功能一致 · CIS 控制措施 v8.1 — 实施 6 个控制措施
• GDPR — 公共官方数据的公共利益/合法利益依据；根据艺术的公共事务观点。 9(2)(e)/(g)
• EU CRA — CRA-ASSESSMENT.md 中的自我评估
• OpenSSF 最佳实践 — 项目#12069

纵深防御亮点

• HTTPS-only — TLS 1.3、HSTS、CSP、X 框架选项、X 内容类型选项
• 五层代理工作流安全性 — 只读代理令牌、代理上下文中的零秘密、容器化 + Squid/iptables 出口防火墙、安全输出验证、AI 威胁检测扫描
• SHA-固定操作 + step-security/harden-runner + Dependabot + CodeQL + 秘密扫描 + 依赖项审查 + OIDC-only AWS 部署
• 对齐 ISMS 策略 — 信息安全策略 · 安全开发策略 · 威胁建模 · AI 正策 · 漏洞管理 · 变更管理 · 事件响应计划 · 开源正策

npm 包

该平台的可重用共享实用程序发布为 riksdagsmonitor，其构建来源为 SLSA。

npm install riksdagsmonitor

包括 — 主题系统（赛博朋克、WCAG AA）·图表工厂（Chart.js，带响应断点+键盘导航）·弹性数据加载器（重试、缓存、CSV/JSON）·DOM实用程序·完整TypeScript 类型 · 12 个仪表板模块 · CIA 智能模块。

import { getActiveThemeColors, BREAKPOINTS, getPartyColor } from 'riksdagsmonitor';
import { loadJSON, loadCSV, createDataSource } from 'riksdagsmonitor';
import { showLoadingState, formatNumber, debounce } from 'riksdagsmonitor';
import { createChart, initDashboardSection } from 'riksdagsmonitor/shared/chart-factory';
import { CIADataLoader } from 'riksdagsmonitor/cia/data-loader';
import { CIADashboardRenderer } from 'riksdagsmonitor/cia/visualizations';

对等依赖关系 — chart.js d3 papaparse（仪表板必需）； chartjs-plugin-annotation（可选，有条件加载）。

发展

先决条件

Node.js ≥ 26 · npm ≥ 10 · 使用 GPG 签名的 Git · GitHub MFA + SSH 密钥。

快速启动

git clone [email protected]:Hack23/riksdagsmonitor.git
cd riksdagsmonitor
npm install
npm run dev          # Vite dev server with hot reload → http://localhost:8080

# Tests
npm test                 # Vitest unit (2,890 tests)
npm run test:coverage    # with coverage
npm run cypress:open     # E2E interactive
npm run e2e              # full E2E (build + preview + Cypress)

# Quality
npm run htmlhint         # HTML5 validation
npm run linkcheck        # link integrity (linkinator)

# Production
npm run build            # Vite production build → dist/
npm run preview          # http://localhost:4173

CI/CD

• HTMLHint 验证 · Linkinator · Vitest（2,890 次测试） · Cypress · Vite 构建 · 依赖审查 · CodeQL · 秘密扫描 · 翻译验证
• 发布 —workflow_dispatch 或 v*.*.* 标签 → SBOM (SPDX) + SHA-256 + SLSA 构建来源证明 + 双重部署（S3/CloudFront 主、 GitHub 页数 DR)
• gh attestation verify riksdagsmonitor-vX.Y.Z.zip -R Hack23/riksdagsmonitor

请参阅 WORKFLOWS.md 和 RELEASE_PROCESS.md 作为规范参考。

GitHub Copilot — 代理、技能和代理工作流程

riksdagsmonitor 使用 GitHub Copilot 角色、技能和代理工作流程 作为一流的自动化。目录 READMEs 是唯一的事实来源； AGENTS.md 和 SKILLS.md 是长格式目录。

14 个角色代理（可通过 assign_copilot_to_issue 分配）： security-architect · documentation-architect · quality-engineer · frontend-specialist · isms-compliance-manager · deployment-specialist · devops-engineer · intelligence-operative · news-journalist · content-generator · data-pipeline-specialist · data-visualization-specialist · task-agent · ui-enhancement-specialist.

9 个工作流专家代理（.agent.md，从工作流调用）： agentic-workflows · ci-cleaner · contribution-checker · create-safe-output-type · custom-engine-implementation · grumpy-reviewer · interactive-agent-designer · technical-doc-writer · w3c-specification-writer.

文档索引

项目文档

• Article-Generation.md — 规范代理新闻编辑室合约（数据 → 分析 → 文章 → HTML → S3）
• AGENTS.md · SKILLS.md — 副驾驶角色和技能目录
• WORKFLOWS.md — 端到端 CI/CD 参考 (v7.2)
• RELEASE_PROCESS.md — 带有证明和文档即代码的发布
• TRANSLATION_GUIDE.md — 14 种语言标准和术语表
• SECURITY.md · CONTRIBUTING.md · CODE_OF_CONDUCT.md · LICENSE

未来规划

• FUTURE_WORKFLOWS.md · FUTURE_MINDMAP.md · FUTURE_ARCHITECTURE.md · FUTURE_SECURITY_ARCHITECTURE.md · FUTURE_SWOT.md

外部

• API 文档 (JSDoc) · 测试覆盖率 · 赛普拉斯 E2E 报告
• CIA 平台 · CIA JSON 出口规格
• Hack23 ISMS-PUBLIC · Hack23 博客

未来路线图（2026 → 2037）

从代理新闻生成到 AGI- 支持的民主情报——11 年的演变。

详细规划：FUTURE_WORKFLOWS.md · FUTURE_MINDMAP.md · FUTURE_ARCHITECTURE.md

%%{init: {"theme": "dark", "themeVariables": {"primaryColor": "#00d9ff", "primaryTextColor": "#e0e0e0", "primaryBorderColor": "#ff006e", "lineColor": "#ffbe0b", "secondaryColor": "#1a1e3d", "tertiaryColor": "#0a0e27"}}}%%
timeline
    title Riksdagsmonitor Evolution — 2026 → 2037
    section Phase 3 — Foundation (2026)
        Q1-Q2 : ✅ TypeScript migration · 14 agentic news workflows
              : ✅ 14 languages · S3 + GitHub Pages dual deploy
        Q3-Q4 :  CIA pipeline integration · predictive dashboards
    section Phase 4 — Predictive Intelligence (2027–2029)
        2027 : Real-time streams · ML election models · Nordic expansion (DK · NO · FI)
        2028 : Multi-modal (audio/video) · AI editorial board · self-healing pipelines
        2029 : Fully autonomous · expert-level analysis · API platform launch
    section Phase 5 — Scale (2030–2033)
        2030-2031 : EU-wide coverage (27 + EP) · sovereign-AI evaluation
        2032-2033 : Global parliamentary watch (100+ democracies) · every UN language · pre-AGI
    section Phase 6 — AGI Era (2034–2037)
        2034-2035 : AGI-enhanced intelligence · 195 parliaments · predictive governance
        2036-2037 : Transformative democracy platform · democratic safeguards architecture

版本号仅供参考——实际产品和范式转变（量子 AI，神经形态计算）会有所不同。架构旨在实现优雅的适应，同时保留民主保障：无论 AI 能力如何，都维持人类监督，通过设计反武器化，在平台架构中编码宪法对齐。

关于 Hack23

Hack23 AB (Org.nr 559534-7807) — 瑞典网络安全和开源情报咨询公司。

• www.hack23.com · 博客
• LinkedIn — Hack23
• 创始人：James Pether Sörling、CISSP、CISM
• 公众 ISMS · CIA 平台