feat(ticket-management): Gitea 工单「人读+机读」管理技能(标签零新增 · 标题【问题域】前缀 · 正文首行机读 · 正文自包含 · 末尾机读引用块)+ bin/ticket.mjs(labels/milestones/list/verify/create/rename,含六项断言与建单自检)
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
# agents-skills
|
||||
|
||||
> 可复用的 **agent 技能库**(执行方法,不含项目结论)。每个技能一个**顶层目录** + `SKILL.md`,因此本仓**可以直接作为技能根**(如 junction 到 `<项目>/.dsh/skills` 后由 DSH 发现)。
|
||||
|
||||
## 技能清单
|
||||
|
||||
| 技能 | 覆盖 | 主要文件 |
|
||||
|---|---|---|
|
||||
| `ticket-management` | Gitea 工单的「人读 + 机读」双面管理(标签零新增 · 标题问题域前缀 · 正文首行机读 · 正文自包含 · 来源只进末尾机读引用块) | `SKILL.md` · `bin/ticket.mjs` · `templates/issue.md` |
|
||||
|
||||
## 约定
|
||||
|
||||
1. **目录式技能**:`<name>/SKILL.md`(**顶层,不嵌套**)—— 嵌套的 `SKILL.md` 不会被技能提供方发现。
|
||||
2. **frontmatter 必须有 `name` 与 `description`**;`description` 里写清「什么时候用」,那是唯一发现入口。
|
||||
3. **只放「换一个项目还能用吗?能」的东西** —— 项目结论 / 事实不进本仓。
|
||||
4. **工具要能自检**:脚本必须能在自己的仓里跑通一条最小用例。
|
||||
5. **令牌不落盘**:脚本从 `GITEA_TOKEN` 或 `--token-file` 读,**绝不把令牌写进仓库、URL 或提交**。
|
||||
|
||||
## 使用(把本仓接到项目)
|
||||
|
||||
```powershell
|
||||
# 方式一:作为技能根之一(Windows 目录 junction)
|
||||
New-Item -ItemType Junction -Path '<项目>/.dsh/skills/agents-skills' -Target '<本仓路径>'
|
||||
# 方式二:只取一个技能
|
||||
Copy-Item -Recurse '<本仓>/ticket-management' '<项目>/.dsh/skills/'
|
||||
```
|
||||
Reference in New Issue
Block a user