Skip to content

docs: スキル間ワークフロー(audit → pin → upgrade)のドキュメント整備 #19

@yk-lab

Description

@yk-lab

背景

ActVer には audit-actions / pin-actions / upgrade-actions の3スキルがあり、各 SKILL.md の Notes に cross-skill ハンドオフの記載はある。しかし:

  • 3スキルの関係性を俯瞰できるドキュメントがない
  • エージェント定義(actver.md)に MCP ツールとスキルの使い分けが明記されていない
  • 新規ユーザーが「どのスキルから始めるべきか」が分かりにくい

対応

  • エージェント定義(plugins/actver/agents/actver.md)にスキルとの使い分けガイダンスを追加
    • MCP ツール → バージョン確認
    • スキル → ワークフロー変更作業(audit → pin → upgrade の流れ)
  • README or エージェント定義内にデシジョンツリーを追加
    • 「ワークフローのセキュリティが心配」→ audit-actions
    • 「アクションを SHA ピン留めしたい」→ pin-actions
    • 「アクションを最新版にしたい」→ upgrade-actions

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions