AgentSkillsCN

updating-openspec-instructions

更新项目中的 OpenSpec 指导文件。适用于 OpenSpec 已经初始化,但相关指导需要刷新,或 CLI 已经更新时使用。

SKILL.md
--- frontmatter
name: updating-openspec-instructions
description: Updates OpenSpec instruction files in a project. Use when OpenSpec is already initialized but instructions need refreshing or the CLI was updated.

Updating OpenSpec Instructions

Purpose

Ensures that the AI agent's instruction files (e.g., .cursorrules, claude.json) are up-to-date with the latest OpenSpec standards and project configuration.

1. Safety & Verification

  1. Check Help: Run cd docs && npx @fission-ai/openspec@latest update --help.
  2. Verify Initialization: Ensure OpenSpec has already been initialized in the project (check for docs/openspec/ directory).

2. Common Workflows

Workflow: Refresh Instructions

  1. Run cd docs && npx @fission-ai/openspec@latest update.
  2. Use --force to overwrite existing instructions even if they appear up-to-date.

3. Error Handling

  • If the command fails because OpenSpec is not initialized: Run initializing-openspec first.

4. Examples

Example: Force Update Instructions

Command: cd docs && npx @fission-ai/openspec@latest update --force Expected Output: Updated instruction files in the project root or .cursor/ directory.