Skip to content

AGENTS.md

Latest commit

 

History

History
69 lines (49 loc) · 2.03 KB

AGENTS.md

File metadata and controls

69 lines (49 loc) · 2.03 KB
Raw

MisakaNet 节点接入规则

任何节点加入虫群后，按以下规则检索和贡献知识。

🛡️ 崩溃保护（强烈推荐）

# 用 fatal-guard 包装你的进程，崩溃时自动捕获墓碑
npx @misaka-net/fatal-guard -- <your-command>

# 墓碑自动转为 draft lesson
python3 scripts/tombstone_to_draft.py --from-file tombstone.json

# 或通过管道直连
fatal-guard -- node app.js 2>&1 | python3 scripts/tombstone_to_draft.py --stdin

崩溃 → 墓碑 JSON → draft lesson → bench-core 动态题库。你的每一次崩溃都在喂养整个网络。

核心工作流

遇到问题时的检索顺序

# 1. 快速搜所有
python3 search_knowledge.py "你的关键词"

# 2. 只看 lessons（踩坑记录）
python3 search_knowledge.py "关键词" --lessons

# 3. 只看 reference（完整方案）
python3 search_knowledge.py "关键词" --ref

# 4. 只看标题（快速定位）
python3 search_knowledge.py "关键词" --titles

贡献新知识

# 踩坑记录（推荐）
python3 scripts/queue_lesson.py \
  -t "你的标题" -d domain \
  --tags "node:你的节点名,project:项目名" \
  "问题描述\n\n## 根因\n...\n\n## 修复\n...\n\n## 验证\n..."

保持同步

# 每次会话开始时
cd ~/MisakaNet && git pull --ff-only

详细指南

  • 检索与贡献: 见 docs/agents/retrieval-and-contribution.md
  • 节点规则注入: 见 docs/agents/node-injection.md
  • 知识库结构: 见 docs/agents/knowledge-structure.md

优先技能

  • intuitive-init: 初始化/刷新项目本地的 AGENTS.md / CLAUDE.md
  • intuitive-flow: 从模糊想法到执行的完整开发流程
  • intuitive-doc: 维护面向人类的文档
  • intuitive-refactor: 有界的大规模重构
  • intuitive-layout: 改善仓库/文件夹组织，在深层的架构工作前先解决布局摩擦
  • intuitive-tests: 测试套件组织、标记、剪枝、夹具管理
  • intuitive-squash: 将嘈杂的 agent 提交历史压缩为干净的 PR 故事