Agent Skills
› Drakkar-Software/OctoBot
› node-journal
node-journal
GitHub定义 node_journal 模块的使用规范，规定外部仅能通过 record_* 追加事件日志，禁止读取或依赖其作为业务状态源。内部负责导出与总结逻辑，确保日志仅用于诊断和分享，维持应用边界清晰。
触发场景
需要记录用户行为或系统事件用于诊断分析时
在 node_journal 包内实现事件导出或旅程摘要功能时
安装
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)
版本历史
- 3.0.0-beta3 当前 2026-10-19 02:08
