graph-write
Write, propose, commit, repair, and nudge Potpie Context Graph records safely.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- graph-write
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Write, propose, commit, repair, and nudge Potpie Context Graph records safely.
- disable-model-invocation
- true
02 资源文件 2
- 参考文档references/troubleshooting.md3.1 KB
- 参考文档references/workflow.md3.9 KB
03 SKILL.md 正文
Potpie graph write
Use this sub-skill when the task is about adding durable memory, proposing graph mutations, committing plans, handling inbox items, running graph quality checks, or nudging agents from graph evidence.
Read this when
- The user asks about
potpie record,potpie graph propose,potpie graph commit,potpie graph mutate,potpie graph mutation-template,potpie graph bulk apply,potpie graph import,potpie graph repair,potpie graph history,potpie graph inbox,potpie graph quality, orpotpie graph nudge. - A write fails because a mutation payload is malformed, a plan needs review, a plan expired, or verification did not pass.
- You need to distinguish the canonical propose/commit flow from the legacy
graph mutatewrapper.
Do not use this for
- Discovery-only reads: read
../graph-read/SKILL.md. - Pot/source setup or default binding: read
../workspace-boundaries/SKILL.md. - Runtime/daemon startup: read
../runtime/SKILL.md. - Credential acquisition: read
../auth-integrations/SKILL.md.
Operating procedure
- Prefer the canonical plan door:
graph proposeto validate and stage, thengraph commitwith explicit approval and verification as needed. - Use
graph mutation-templatebefore authoring payloads when the DSL or entity label is uncertain. - Keep mutations flat and retrieval-grade: durable descriptions, explicit scopes, source references, and no nested legacy wrappers unless the CLI specifically emits them.
- Use
graph inbox,graph quality,graph history, andgraph inspectto review pending, stale, or questionable graph state before applying more writes. - Treat
recordas a convenient durable-memory write path andgraph nudgeas a bridge from graph evidence to agent guidance.
References
references/workflow.md— write command matrix, flat mutation DSL, approval/verification, inbox, quality, bulk, and nudge flows.references/troubleshooting.md— malformed payloads, review gates, expired plans, bulk failures, inbox states, and quality repairs.
Verification notes
- Safe native candidates include graph CLI contract, graph workbench plan/inbox/quality tests, nudge service, apply-once, semantic mutation validation, semantic mutations, graph-plan compatibility, and graph-workbench ontology tests.
- No accelerator backend is required for write-side CLI/contract verification.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.