AgentSkillsCN

openspec-new-change

通过 OPSX 工作流工件，开启一项新的变更。当用户希望以结构化的步骤，逐步创建新功能、修复缺陷，或进行修改时，可使用此技能。

SKILL.md
--- frontmatter
name: openspec-new-change
description: Bắt đầu một thay đổi mới bằng workflow artifact thử nghiệm (OPSX). Sử dụng khi người dùng muốn tạo một tính năng mới, bản sửa lỗi, hoặc chỉnh sửa bằng cách tiếp cận từng bước có cấu trúc.
license: MIT
compatibility: Yêu cầu openspec CLI.
metadata:
  author: openspec
  version: "1.0"
  generatedBy: "1.0.2"

Bắt đầu một thay đổi mới bằng cách tiếp cận dựa trên artifact thử nghiệm.

Đầu vào: Yêu cầu của người dùng nên bao gồm tên thay đổi (kebab-case) HOẶC bản mô tả về những gì họ muốn xây dựng.

Các bước

  1. •

    Nếu không có đầu vào rõ ràng, hãy hỏi họ muốn xây dựng điều gì

    Sử dụng công cụ AskUserQuestion (câu hỏi mở, không có tùy chọn sẵn) để hỏi:

    "Bạn muốn làm việc trên thay đổi nào? Hãy mô tả những gì bạn muốn xây dựng hoặc sửa chữa."

    Từ bản mô tả của họ, suy ra một cái tên định dạng kebab-case (ví dụ: "add user authentication" → add-user-auth).

    QUAN TRỌNG: KHÔNG được tiếp tục nếu chưa hiểu rõ người dùng muốn xây dựng điều gì.

  2. •

    Xác định workflow schema

    Sử dụng schema mặc định (bỏ qua --schema) trừ khi người dùng yêu cầu rõ ràng một workflow khác.

    Chỉ sử dụng một schema khác nếu người dùng đề cập:

    • •Một tên schema cụ thể → sử dụng --schema <name>
    • •"hiển thị các workflow" (show workflows) hoặc "có những workflow nào" (what workflows) → chạy lệnh openspec schemas --json và để họ chọn.

    Nếu không: Bỏ qua --schema để sử dụng mặc định.

  3. •

    Tạo thư mục thay đổi

    bash
    openspec new change "<name>"

    Thêm --schema <name> chỉ khi người dùng yêu cầu một workflow cụ thể. Lệnh này tạo ra một khung thay đổi tại openspec/changes/<name>/ với schema đã chọn.

  4. •

    Hiển thị trạng thái artifact

    bash
    openspec status --change "<name>"

    Lệnh này hiển thị những artifact nào cần được tạo và những cái nào đã sẵn sàng (các phụ thuộc đã được đáp ứng).

  5. •

    Lấy hướng dẫn cho artifact đầu tiên Artifact đầu tiên phụ thuộc vào schema (ví dụ: proposal cho spec-driven). Kiểm tra đầu ra của trạng thái để tìm artifact đầu tiên có trạng thái "ready".

    bash
    openspec instructions <first-artifact-id> --change "<name>"

    Lệnh này đưa ra template và ngữ cảnh để tạo artifact đầu tiên.

  6. •

    DỪNG LẠI và chờ chỉ dẫn của người dùng

Đầu ra

Sau khi hoàn thành các bước, hãy tóm tắt:

  • •Tên thay đổi và vị trí lưu trữ.
  • •Schema/workflow đang được sử dụng và trình tự artifact của nó.
  • •Trạng thái hiện tại (hoàn thành 0/N artifact).
  • •Template cho artifact đầu tiên.
  • •Gợi ý: "Đã sẵn sàng tạo artifact đầu tiên chưa? Bạn chỉ cần mô tả nội dung của thay đổi này và tôi sẽ phác thảo nó, hoặc yêu cầu tôi tiếp tục."

Nguyên tắc an toàn (Guardrails)

  • •CHƯA tạo bất kỳ artifact nào - chỉ hiển thị hướng dẫn.
  • •KHÔNG đi xa hơn việc hiển thị template artifact đầu tiên.
  • •Nếu tên không hợp lệ (không phải kebab-case), hãy yêu cầu một cái tên hợp lệ.
  • •Nếu một thay đổi trùng tên đã tồn tại, hãy đề xuất tiếp tục thay đổi đó.
  • •Cần truyền --schema nếu sử dụng workflow không phải mặc định.