ws-spec-kit 0.1.0-beta.0

package/resources/workflows/feature-delivery/workflow.yaml

@@ -0,0 +1,150 @@
+version: 1
+workflow:
+  id: feature-delivery
+  version: 1
+inputs:
+  requirement:
+    accepts: [user.prompt, local.file, github.issue, gitlab.issue, feishu.document]
+steps:
+  - id: intake
+    uses: connector.execute
+    action: requirement.capture
+    inputs: [requirement-source]
+    outputs: [requirement-source]
+  - id: explore
+    uses: agent.execute
+    needs: [intake]
+    inputs: [requirement-source]
+    objective: 探索代码并提取需求相关约束
+    skills:
+      - ref: builtin://skills/requirement-exploration
+        required: true
+    outputs: [exploration-report]
+  - id: clarify
+    uses: agent.execute
+    needs: [explore]
+    inputs: [exploration-report]
+    objective: 澄清需求并生成可验收规格
+    skills:
+      - ref: builtin://skills/requirement-exploration
+        required: true
+    outputs: [specification]
+    approval: required
+  - id: design
+    uses: agent.execute
+    needs: [clarify]
+    inputs: [specification]
+    objective: 形成可实施的技术方案
+    skills:
+      - ref: builtin://skills/solution-design
+        required: true
+    outputs: [design]
+    approval: required
+  - id: plan
+    uses: agent.execute
+    needs: [clarify, design]
+    objective: 将设计拆分为可验证任务
+    skills:
+      - ref: builtin://skills/task-planning
+        required: true
+    outputs: [tasks]
+    inputs:
+      - outputId: specification
+        required: true
+      - outputId: design
+        required: false
+  - id: write-tests
+    uses: agent.execute
+    needs: [plan]
+    inputs: [tasks]
+    objective: 根据当前任务先编写能够因缺少功能而失败的测试
+    skills:
+      - ref: builtin://skills/tdd-implementation
+        required: true
+    outputs: [red-test-result]
+  - id: verify-red
+    uses: command.execute
+    action: quality.test
+    expectedOutcome: test-failure
+    needs: [write-tests]
+    inputs: [red-test-result]
+    outputs: [red-evidence]
+  - id: implement
+    uses: agent.execute
+    actorRole: implementation
+    needs: [verify-red]
+    inputs: [tasks]
+    objective: 在保留 Red 测试的前提下完成最小实现
+    skills:
+      - ref: builtin://skills/tdd-implementation
+        required: true
+    outputs: [implementation-result]
+  - id: verify-green
+    uses: command.execute
+    action: quality.test
+    expectedOutcome: success
+    needs: [implement]
+    inputs: [red-evidence]
+    outputs: [tdd-evidence]
+  - id: review-fix
+    uses: control.loop
+    needs: [verify-green]
+    until: ${artifacts.review-result.approved}
+    maxIterations: 5
+    steps:
+      - id: review
+        uses: agent.execute
+        actorRole: review
+        skills:
+          - ref: builtin://skills/code-review
+            required: true
+        outputs: [review-result]
+      - id: fix
+        uses: agent.execute
+        actorRole: fix
+        when: ${artifacts.review-result.approved == false}
+        skills:
+          - ref: builtin://skills/bug-fixing
+            required: true
+      - id: verify
+        uses: command.execute
+        action: quality.verify
+  - id: commit
+    uses: connector.execute
+    action: git.commit
+    needs: [review-fix]
+    approval: required
+  - id: update-issue
+    uses: connector.execute
+    action: issue.update
+    needs: [commit]
+    inputs: [implementation-result]
+    when: ${bindings.issue.exists}
+  - id: update-wiki
+    uses: connector.execute
+    action: knowledge.publish
+    needs: [update-issue]
+    inputs: [implementation-result]
+    when: ${bindings.knowledge.exists}
+  - id: close-issue
+    uses: connector.execute
+    action: issue.close
+    needs: [update-wiki]
+    when: ${bindings.issue.exists}
+    approval: required
+  - id: close
+    uses: control.close
+    needs: [close-issue]
+gates:
+  - id: test
+    evidence: trusted
+    command: [wspec, gate, test]
+  - id: verify-red
+    evidence: trusted
+    command: [wspec, gate, test, --expect-failure]
+  - id: verify-green
+    evidence: trusted
+    command: [wspec, gate, test]
+changePolicy:
+  kind: feature
+  allowedPaths: ["**"]

package/schemas/builtin-agent-action-v1.schema.json

@@ -0,0 +1,509 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "builtin.agent-action.v1",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "workPackage"
+      ],
+      "properties": {
+        "action": {
+          "const": "execute"
+        },
+        "workPackage": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "version",
+            "workItemId",
+            "stepId",
+            "attemptId",
+            "lease",
+            "objective",
+            "skills",
+            "artifacts",
+            "constraints",
+            "requiredOutputs",
+            "gates",
+            "resultSchema"
+          ],
+          "properties": {
+            "version": {
+              "const": 1
+            },
+            "workItemId": {
+              "type": "string",
+              "pattern": "^WSS-[A-Za-z0-9-]+$"
+            },
+            "stepId": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9-]{0,62}(?::[1-9][0-9]*:[a-z][a-z0-9-]{0,62})?$"
+            },
+            "attemptId": {
+              "type": "string",
+              "pattern": "^attempt-.+$"
+            },
+            "lease": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "token",
+                "expiresAt"
+              ],
+              "properties": {
+                "token": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "expiresAt": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              }
+            },
+            "objective": {
+              "type": "string",
+              "minLength": 1
+            },
+            "artifactLevel": {
+              "type": "string",
+              "minLength": 1
+            },
+            "skills": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "ref",
+                  "version",
+                  "digest",
+                  "description"
+                ],
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "version": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^sha256:.+$"
+                  },
+                  "description": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            },
+            "artifacts": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "artifactType",
+                  "schemaVersion"
+                ],
+                "properties": {
+                  "artifactType": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]{0,62}$"
+                  },
+                  "outputId": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]{0,62}$"
+                  },
+                  "artifactId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128
+                  },
+                  "schemaVersion": {
+                    "type": "integer",
+                    "minimum": 1
+                  },
+                  "path": {
+                    "type": "string"
+                  },
+                  "revision": {
+                    "type": "integer",
+                    "minimum": 1
+                  },
+                  "contentHash": {
+                    "type": "string",
+                    "pattern": "^sha256:.+$"
+                  },
+                  "mediaType": {
+                    "type": "string"
+                  },
+                  "contentLevel": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            },
+            "constraints": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "allowedPaths",
+                "forbiddenActions"
+              ],
+              "properties": {
+                "allowedPaths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "uniqueItems": true
+                },
+                "forbiddenActions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "uniqueItems": true
+                }
+              }
+            },
+            "requiredOutputs": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "artifactType",
+                  "schemaVersion"
+                ],
+                "properties": {
+                  "artifactType": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]{0,62}$"
+                  },
+                  "outputId": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]{0,62}$"
+                  },
+                  "schemaVersion": {
+                    "type": "integer",
+                    "minimum": 1
+                  },
+                  "contentLevel": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            },
+            "artifactAuthoring": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "version",
+                "maxContentBytes",
+                "draftRoots"
+              ],
+              "properties": {
+                "version": {
+                  "const": 1
+                },
+                "maxContentBytes": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 1048576
+                },
+                "draftRoots": {
+                  "type": "array",
+                  "minItems": 1,
+                  "uniqueItems": true,
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            },
+            "gates": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "id",
+                  "evidence",
+                  "required"
+                ],
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9.-]{0,62}$"
+                  },
+                  "evidence": {
+                    "enum": [
+                      "trusted",
+                      "attested",
+                      "reported"
+                    ]
+                  },
+                  "required": {
+                    "type": "boolean"
+                  }
+                }
+              }
+            },
+            "resultSchema": {
+              "const": "builtin.submit-result.v1"
+            }
+          }
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "approval"
+      ],
+      "properties": {
+        "action": {
+          "const": "await_approval"
+        },
+        "approval": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "kind",
+                "requestId",
+                "workItemId",
+                "title",
+                "digest"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "step"
+                },
+                "requestId": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "workItemId": {
+                  "type": "string",
+                  "pattern": "^WSS-[A-Za-z0-9-]+$"
+                },
+                "title": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest": {
+                  "type": "string",
+                  "pattern": "^sha256:.+$"
+                }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "kind",
+                "requestId",
+                "workItemId",
+                "title",
+                "digest"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "workflow_trust"
+                },
+                "requestId": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "workItemId": {
+                  "type": "string",
+                  "pattern": "^WSS-[A-Za-z0-9-]+$"
+                },
+                "title": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest": {
+                  "type": "string",
+                  "pattern": "^sha256:.+$"
+                }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "kind",
+                "requestId",
+                "workItemId",
+                "title",
+                "digest",
+                "provider",
+                "action",
+                "target",
+                "sideEffects"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "external_action"
+                },
+                "requestId": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "workItemId": {
+                  "type": "string",
+                  "pattern": "^WSS-[A-Za-z0-9-]+$"
+                },
+                "title": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest": {
+                  "type": "string",
+                  "pattern": "^sha256:.+$"
+                },
+                "provider": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9-]{0,62}$"
+                },
+                "action": {
+                  "enum": [
+                    "git.commit",
+                    "issue.update",
+                    "knowledge.publish",
+                    "issue.close"
+                  ]
+                },
+                "target": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "kind",
+                    "stableId"
+                  ],
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "repository",
+                        "issue",
+                        "knowledge"
+                      ]
+                    },
+                    "stableId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 4096
+                    }
+                  }
+                },
+                "sideEffects": {
+                  "type": "array",
+                  "minItems": 1,
+                  "uniqueItems": true,
+                  "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 256
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "problems"
+      ],
+      "properties": {
+        "action": {
+          "const": "blocked"
+        },
+        "problems": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "code",
+              "message",
+              "retryable"
+            ],
+            "properties": {
+              "code": {
+                "type": "string",
+                "pattern": "^WSSPEC_[A-Z0-9_]+$"
+              },
+              "message": {
+                "type": "string",
+                "minLength": 1
+              },
+              "retryable": {
+                "type": "boolean"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "summary"
+      ],
+      "properties": {
+        "action": {
+          "const": "completed"
+        },
+        "summary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "workItemId",
+            "status",
+            "message"
+          ],
+          "properties": {
+            "workItemId": {
+              "type": "string",
+              "pattern": "^WSS-[A-Za-z0-9-]+$"
+            },
+            "status": {
+              "enum": [
+                "closed",
+                "cancelled"
+              ]
+            },
+            "message": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/schemas/builtin-application-acquire-input-v1.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "builtin.application-acquire-input.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "root",
+    "workItemId",
+    "actor"
+  ],
+  "properties": {
+    "root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workItemId": {
+      "type": "string",
+      "pattern": "^WSS-[A-Za-z0-9-]+$"
+    },
+    "actor": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}