Agent Skills › PC2005-cloud/dsh-pet › dsh-pet-dev

dsh-pet-dev

GitHub

作为dsh-pet插件开发总则，负责编排代码修改、注释生成与提交流程。通过调用子技能规范边界、标准与提交，确保从编码到验证的完整执行链。

.agents/skills/dsh-pet-dev/SKILL.md PC2005-cloud/dsh-pet

触发场景

需要修改插件源码或接口时需要生成或改写Git提交信息时用户明确点名触发开发流程时

安装

npx skills add PC2005-cloud/dsh-pet --skill dsh-pet-dev -g -y

更多选项

非标准路径

npx skills add https://github.com/PC2005-cloud/dsh-pet/tree/main/.agents/skills/dsh-pet-dev -g -y

不安装直接使用

npx skills use PC2005-cloud/dsh-pet@dsh-pet-dev

指定 Agent (Claude Code)

npx skills add PC2005-cloud/dsh-pet --skill dsh-pet-dev -a claude-code -g -y

安装 repo 全部 skill

npx skills add PC2005-cloud/dsh-pet --all -g -y

预览 repo 内 skill

npx skills add PC2005-cloud/dsh-pet --list

SKILL.md

Frontmatter

{
    "name": "dsh-pet-dev",
    "metadata": {
        "category": "development",
        "language": "zh"
    },
    "whenToUse": "在本仓库改动任何代码、注释、文档或准备提交时使用：用户说“改这个”“加个功能”“修一下”“提交推送”，或用户手动调用 dsh-pet-dev 时。",
    "description": "本仓库（dsh-pet 宠物插件）的开发总则：把任务边界、插件代码规范、注释规范与提交规范串成一条执行链，一次调用覆盖从改代码到提交的全过程。",
    "user-invocable": true,
    "disable-model-invocation": true
}

dsh-pet 开发总则（dsh-pet-dev）

目标

本仓库唯一的入口 skill。它不重复四条规范的内容，只回答一件事：这次请求该调用哪几个子 skill、按什么顺序执行。

四个子 skill 是权威正文；本文件是索引与顺序表。二者冲突时以子 skill 为准。

四个子 skill

子 skill	什么时候必须调用
`task-guardrails`	每个请求的第一步，任何工具调用之前
`dsh-plugin-standards`	要动 host/client 源码、加删文件、改接口、补测试
`dsh-plugin-comment-spec`	和 `dsh-plugin-standards` 一起调：写代码就要写注释
`git-commit`	要提交、要写或改写提交信息

四个子 skill 都已注册，直接按名字交给 skill 工具，不需要去找文件，也不需要读文件。门禁命令在 dsh-pet/ 子目录下执行。

执行链

按顺序走，不要跳步，也不要一次全部调用。

判类型（task-guardrails）：纯对话 / 只读调查 / 需要变更。判定不清时往更保守的一类靠。
先开口再动工具：说出理解与打算看什么；只读也要先开口。
写操作前停住：说清「改什么、达到什么效果、怎么验证」，然后用弹窗等回复。预告不等于获批。
动代码前一起调 dsh-plugin-standards 与 dsh-plugin-comment-spec：前者定插件类型、文件规模、目录归属、导出面、测试位置，后者定模块头分档、导出符号一行摘要、只写 why。写代码必然带注释，不拆成两步。
收尾跑门禁（在 dsh-pet/）：npm run typecheck、npm run lint、npm run format:check、npm run check:cycles、npm run check:runtime、npm run check:openapi、npm test、npm run build。没跑过的不要说「已验证」。
提交时调 git-commit：从实际 diff 推断 type(scope)，正文写实现方式、行为变化与涉及文件；推送必须有明确指令。

调用方式

按需调用，别一次全调：纯问答一个都不调；只读调查只调 task-guardrails；改代码把 task-guardrails、dsh-plugin-standards、dsh-plugin-comment-spec 三个一起调；提交调 git-commit。
同一子 skill 在一次任务里调一次即可，不要重复调用，也不要凭记忆复述它的规则。
本 skill 只由用户点名触发；四个子 skill 由 AI 按需调用，用户也可以直接点名。

冲突与优先级

边界优先：task-guardrails 决定「能不能动」，dsh-plugin-standards / dsh-plugin-comment-spec 决定「怎么写」，git-commit 决定「怎么记录」。规范与边界冲突时，先满足边界。
规范与代码不一致时报告，不擅自改：发现规范里的说法与仓库现状冲突，先说明再问，不直接改规范。