Agent Skills
› Drakkar-Software/OctoBot
› node-journal
node-journal
GitHub定义 node_journal 模块的使用规范，明确其为仅追加的事件日志，用于诊断和导出。规定外部调用者仅使用 record_* 接口，禁止依赖日志内容做业务逻辑判断或存储复用数据。
Trigger Scenarios
编辑 node_journal 模块代码
在 node_journal 外部添加记录事件调用
Install
npx skills add Drakkar-Software/OctoBot --skill node-journal -g -y
SKILL.md
Frontmatter
{
"name": "node-journal",
"paths": [
"octobot\/community\/node_journal\/**"
],
"description": "Node journal (octobot.community.node_journal): record-only from outside the package; reads only for export inside node_journal; not a source of truth. Apply when editing node_journal or adding\/changing record_* calls elsewhere."
}
Node journal
Full rules: octobot/community/node_journal/AGENTS.md.
Purpose
Append-only event log for diagnostics, journey analytics, and export/sharing (upload envelope). Not authoritative application state.
Integrators (outside node_journal/)
- Import
octobot.community.node_journaland call Tier-1record_*/recordonly. - Do not call
read_events, read journal files on disk, or branch product logic on journal contents. - Do not store data in journal payloads to reuse later for non-journal features. Use config, DB, sync collections, or domain stores as source of truth.
Inside octobot/community/node_journal/
read_events,build_journey_summary, andbuild_upload_envelopebelong to the export pipeline (plus unit tests).- Event and wire literals: extend
events.py,constants.py,enums.py; do not inline strings in recording code. - Respect import tiers in package
__init__.py; feature code must not reach intostore/stateexcept via the public API.
Related
- Core app boundaries:
octobot/AGENTS.md - Python conventions (shared literals, imports): CONTRIBUTING-agent.md — Python conventions (agents)
Version History
- 3.0.0-beta3 Current 2026-10-19 02:08
