修正 api-doc 技能 SKILL.md frontmatter 的 YAML 純量語法 #24
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-review",
|
||||
"version": "0.1.1",
|
||||
"version": "0.1.2",
|
||||
"description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組",
|
||||
"skills": "./skills",
|
||||
"author": {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-review",
|
||||
"version": "0.1.1",
|
||||
"version": "0.1.2",
|
||||
"description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組",
|
||||
"skills": "./skills",
|
||||
"jsc": {
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-review",
|
||||
"version": "0.1.1",
|
||||
"version": "0.1.2",
|
||||
"description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組",
|
||||
"skills": "./skills/",
|
||||
"jsc": {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: api-doc
|
||||
description: Audit an API project's Swagger/OpenAPI documentation: every returnable HTTP status code declares a response type, every input and output carries a description, and a real data example sits on scalar members only — a data-model member takes a description and hands the example duty down to its own properties, recursively to the innermost scalar. Run after controller work or an implementation is complete, e.g. from jsc-sdlc implement, next to jsc-review:code-review. Detection runs first via tools/swagger-detect.sh; without both the Swagger package and its wiring, report unsupported and stop. The source comment contract belongs to jsc-review:code-review group 5; this skill covers Swagger document attributes only. Findings carry file:line, severity, and the fix; this skill never modifies code.
|
||||
description: 'Audit an API project''s Swagger/OpenAPI documentation: every returnable HTTP status code declares a response type, every input and output carries a description, and a real data example sits on scalar members only — a data-model member takes a description and hands the example duty down to its own properties, recursively to the innermost scalar. Run after controller work or an implementation is complete, e.g. from jsc-sdlc implement, next to jsc-review:code-review. Detection runs first via tools/swagger-detect.sh; without both the Swagger package and its wiring, report unsupported and stop. The source comment contract belongs to jsc-review:code-review group 5; this skill covers Swagger document attributes only. Findings carry file:line, severity, and the fix; this skill never modifies code.'
|
||||
---
|
||||
|
||||
# api-doc
|
||||
|
||||
Reference in New Issue
Block a user