AgentSkillsCN

obsidian-ops

Obsidian 项目的运维管理、同步机制、版本控制与发布流程。在执行构建、同步引用、版本升级,或为正式发布做准备时,加载这些工具与流程。

SKILL.md
--- frontmatter
name: obsidian-ops
description: Operations, syncing, versioning, and release management for Obsidian projects. Load when running builds, syncing references, bumping versions, or preparing for release.

Obsidian Operations Skill

This skill covers the operational aspects of maintaining an Obsidian project, including build workflows, sync procedures, and release management.

Purpose

To ensure reliable builds, consistent reference materials, and safe release processes while strictly following project policies.

When to Use

Load this skill when:

  • Running build or lint commands.
  • Syncing reference documentation from external sources.
  • Bumping project versions or preparing releases.
  • Troubleshooting build or environment issues.

Core Rules

  • NEVER perform automatic git operations: AI agents must never execute git commit, git push, or any command that automatically stages or commits changes without explicit user approval for each step.
  • Verify Build: Always run a build/lint after significant changes to ensure compatibility.
  • Sync Status: Keep sync-status.json updated when updating reference materials.

Bundled Resources

  • references/build-workflow.md: Standard build and development commands.
  • references/release-readiness.md: Checklist for ensuring a project is ready for release.
  • references/sync-procedure.md: How to pull updates from reference repositories.
  • references/versioning-releases.md: Workflow for versioning and GitHub releases.
  • references/troubleshooting.md: Common issues and their resolutions.
  • references/quick-reference.md: One-page cheat sheet for common operations.