ai-project-manage-cli 2.0.26 → 3.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +500 -20
- package/package.json +27 -25
- package/template/apm.config.json +5 -0
- package/template/deploy/README.md +3 -0
- package/template/skills/apm-review/SKILL.md +38 -0
- package/template/skills/apm-review/apm-review-reference.md +89 -0
- package/template/workitems/README.md +19 -0
- package/README.md +0 -171
- package/dist/api/cli.d.ts +0 -228
- package/dist/api/cli.d.ts.map +0 -1
- package/dist/api/cli.js +0 -3
- package/dist/api/cli.js.map +0 -1
- package/dist/api/client.d.ts +0 -5
- package/dist/api/client.d.ts.map +0 -1
- package/dist/api/client.js +0 -30
- package/dist/api/client.js.map +0 -1
- package/dist/api/http.d.ts +0 -21
- package/dist/api/http.d.ts.map +0 -1
- package/dist/api/http.js +0 -108
- package/dist/api/http.js.map +0 -1
- package/dist/api/index.d.ts +0 -6
- package/dist/api/index.d.ts.map +0 -1
- package/dist/api/index.js +0 -13
- package/dist/api/index.js.map +0 -1
- package/dist/api/request-config.d.ts +0 -25
- package/dist/api/request-config.d.ts.map +0 -1
- package/dist/api/request-config.js +0 -73
- package/dist/api/request-config.js.map +0 -1
- package/dist/api/requirement.d.ts +0 -1
- package/dist/api/requirement.d.ts.map +0 -1
- package/dist/api/requirement.js +0 -2
- package/dist/api/requirement.js.map +0 -1
- package/dist/apm-dotenv.d.ts +0 -8
- package/dist/apm-dotenv.d.ts.map +0 -1
- package/dist/apm-dotenv.js +0 -73
- package/dist/apm-dotenv.js.map +0 -1
- package/dist/cli/agent-stream-log.d.ts +0 -41
- package/dist/cli/agent-stream-log.d.ts.map +0 -1
- package/dist/cli/agent-stream-log.js +0 -364
- package/dist/cli/agent-stream-log.js.map +0 -1
- package/dist/cli/commands/auth.d.ts +0 -3
- package/dist/cli/commands/auth.d.ts.map +0 -1
- package/dist/cli/commands/auth.js +0 -51
- package/dist/cli/commands/auth.js.map +0 -1
- package/dist/cli/commands/chat.d.ts +0 -3
- package/dist/cli/commands/chat.d.ts.map +0 -1
- package/dist/cli/commands/chat.js +0 -32
- package/dist/cli/commands/chat.js.map +0 -1
- package/dist/cli/commands/comment.d.ts +0 -3
- package/dist/cli/commands/comment.d.ts.map +0 -1
- package/dist/cli/commands/comment.js +0 -66
- package/dist/cli/commands/comment.js.map +0 -1
- package/dist/cli/commands/config.d.ts +0 -3
- package/dist/cli/commands/config.d.ts.map +0 -1
- package/dist/cli/commands/config.js +0 -39
- package/dist/cli/commands/config.js.map +0 -1
- package/dist/cli/commands/deploy-backend.d.ts +0 -7
- package/dist/cli/commands/deploy-backend.d.ts.map +0 -1
- package/dist/cli/commands/deploy-backend.js +0 -77
- package/dist/cli/commands/deploy-backend.js.map +0 -1
- package/dist/cli/commands/deploy-frontend.d.ts +0 -3
- package/dist/cli/commands/deploy-frontend.d.ts.map +0 -1
- package/dist/cli/commands/deploy-frontend.js +0 -167
- package/dist/cli/commands/deploy-frontend.js.map +0 -1
- package/dist/cli/commands/get.d.ts +0 -3
- package/dist/cli/commands/get.d.ts.map +0 -1
- package/dist/cli/commands/get.js +0 -145
- package/dist/cli/commands/get.js.map +0 -1
- package/dist/cli/commands/init.d.ts +0 -3
- package/dist/cli/commands/init.d.ts.map +0 -1
- package/dist/cli/commands/init.js +0 -179
- package/dist/cli/commands/init.js.map +0 -1
- package/dist/cli/commands/minio.d.ts +0 -3
- package/dist/cli/commands/minio.d.ts.map +0 -1
- package/dist/cli/commands/minio.js +0 -65
- package/dist/cli/commands/minio.js.map +0 -1
- package/dist/cli/commands/publish.d.ts +0 -3
- package/dist/cli/commands/publish.d.ts.map +0 -1
- package/dist/cli/commands/publish.js +0 -130
- package/dist/cli/commands/publish.js.map +0 -1
- package/dist/cli/commands/release.d.ts +0 -3
- package/dist/cli/commands/release.d.ts.map +0 -1
- package/dist/cli/commands/release.js +0 -37
- package/dist/cli/commands/release.js.map +0 -1
- package/dist/cli/commands/requirement.d.ts +0 -3
- package/dist/cli/commands/requirement.d.ts.map +0 -1
- package/dist/cli/commands/requirement.js +0 -169
- package/dist/cli/commands/requirement.js.map +0 -1
- package/dist/cli/commands/set.d.ts +0 -3
- package/dist/cli/commands/set.d.ts.map +0 -1
- package/dist/cli/commands/set.js +0 -103
- package/dist/cli/commands/set.js.map +0 -1
- package/dist/cli/commands/status.d.ts +0 -3
- package/dist/cli/commands/status.d.ts.map +0 -1
- package/dist/cli/commands/status.js +0 -42
- package/dist/cli/commands/status.js.map +0 -1
- package/dist/cli/commands/update.d.ts +0 -3
- package/dist/cli/commands/update.d.ts.map +0 -1
- package/dist/cli/commands/update.js +0 -36
- package/dist/cli/commands/update.js.map +0 -1
- package/dist/cli/commands/ws.d.ts +0 -3
- package/dist/cli/commands/ws.d.ts.map +0 -1
- package/dist/cli/commands/ws.js +0 -25
- package/dist/cli/commands/ws.js.map +0 -1
- package/dist/cli/credentials.d.ts +0 -30
- package/dist/cli/credentials.d.ts.map +0 -1
- package/dist/cli/credentials.js +0 -52
- package/dist/cli/credentials.js.map +0 -1
- package/dist/cli/exit-api-error.d.ts +0 -2
- package/dist/cli/exit-api-error.d.ts.map +0 -1
- package/dist/cli/exit-api-error.js +0 -18
- package/dist/cli/exit-api-error.js.map +0 -1
- package/dist/cli/instruction-log-stream-sink.d.ts +0 -31
- package/dist/cli/instruction-log-stream-sink.d.ts.map +0 -1
- package/dist/cli/instruction-log-stream-sink.js +0 -59
- package/dist/cli/instruction-log-stream-sink.js.map +0 -1
- package/dist/cli/session.d.ts +0 -26
- package/dist/cli/session.d.ts.map +0 -1
- package/dist/cli/session.js +0 -41
- package/dist/cli/session.js.map +0 -1
- package/dist/cli/utils/parse.d.ts +0 -2
- package/dist/cli/utils/parse.d.ts.map +0 -1
- package/dist/cli/utils/parse.js +0 -12
- package/dist/cli/utils/parse.js.map +0 -1
- package/dist/cli/ws-run-command.d.ts +0 -13
- package/dist/cli/ws-run-command.d.ts.map +0 -1
- package/dist/cli/ws-run-command.js +0 -330
- package/dist/cli/ws-run-command.js.map +0 -1
- package/dist/cli-version.d.ts +0 -9
- package/dist/cli-version.d.ts.map +0 -1
- package/dist/cli-version.js +0 -61
- package/dist/cli-version.js.map +0 -1
- package/dist/cli.d.ts +0 -3
- package/dist/cli.d.ts.map +0 -1
- package/dist/cli.js +0 -36
- package/dist/cli.js.map +0 -1
- package/dist/config-store.d.ts +0 -38
- package/dist/config-store.d.ts.map +0 -1
- package/dist/config-store.js +0 -131
- package/dist/config-store.js.map +0 -1
- package/dist/core/apm-config.d.ts +0 -81
- package/dist/core/apm-config.d.ts.map +0 -1
- package/dist/core/apm-config.js +0 -147
- package/dist/core/apm-config.js.map +0 -1
- package/dist/core/backend-deploy/backend-deploy-workflow.d.ts +0 -20
- package/dist/core/backend-deploy/backend-deploy-workflow.d.ts.map +0 -1
- package/dist/core/backend-deploy/backend-deploy-workflow.js +0 -86
- package/dist/core/backend-deploy/backend-deploy-workflow.js.map +0 -1
- package/dist/core/backend-deploy/command-runner.d.ts +0 -11
- package/dist/core/backend-deploy/command-runner.d.ts.map +0 -1
- package/dist/core/backend-deploy/command-runner.js +0 -47
- package/dist/core/backend-deploy/command-runner.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/client.d.ts +0 -18
- package/dist/core/backend-deploy/dockerode-client/client.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/client.js +0 -114
- package/dist/core/backend-deploy/dockerode-client/client.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/connection-options.d.ts +0 -6
- package/dist/core/backend-deploy/dockerode-client/connection-options.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/connection-options.js +0 -62
- package/dist/core/backend-deploy/dockerode-client/connection-options.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/container-inspect-format.d.ts +0 -3
- package/dist/core/backend-deploy/dockerode-client/container-inspect-format.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/container-inspect-format.js +0 -23
- package/dist/core/backend-deploy/dockerode-client/container-inspect-format.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/container-options.d.ts +0 -4
- package/dist/core/backend-deploy/dockerode-client/container-options.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/container-options.js +0 -44
- package/dist/core/backend-deploy/dockerode-client/container-options.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/env.d.ts +0 -3
- package/dist/core/backend-deploy/dockerode-client/env.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/env.js +0 -40
- package/dist/core/backend-deploy/dockerode-client/env.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/index.d.ts +0 -8
- package/dist/core/backend-deploy/dockerode-client/index.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/index.js +0 -17
- package/dist/core/backend-deploy/dockerode-client/index.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/ports.d.ts +0 -9
- package/dist/core/backend-deploy/dockerode-client/ports.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/ports.js +0 -35
- package/dist/core/backend-deploy/dockerode-client/ports.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/runtime.d.ts +0 -7
- package/dist/core/backend-deploy/dockerode-client/runtime.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/runtime.js +0 -26
- package/dist/core/backend-deploy/dockerode-client/runtime.js.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/types.d.ts +0 -64
- package/dist/core/backend-deploy/dockerode-client/types.d.ts.map +0 -1
- package/dist/core/backend-deploy/dockerode-client/types.js +0 -3
- package/dist/core/backend-deploy/dockerode-client/types.js.map +0 -1
- package/dist/core/backend-deploy/image-tag.d.ts +0 -2
- package/dist/core/backend-deploy/image-tag.d.ts.map +0 -1
- package/dist/core/backend-deploy/image-tag.js +0 -15
- package/dist/core/backend-deploy/image-tag.js.map +0 -1
- package/dist/core/backend-deploy/index.d.ts +0 -3
- package/dist/core/backend-deploy/index.d.ts.map +0 -1
- package/dist/core/backend-deploy/index.js +0 -6
- package/dist/core/backend-deploy/index.js.map +0 -1
- package/dist/core/backend-deploy/local-docker-build.d.ts +0 -8
- package/dist/core/backend-deploy/local-docker-build.d.ts.map +0 -1
- package/dist/core/backend-deploy/local-docker-build.js +0 -25
- package/dist/core/backend-deploy/local-docker-build.js.map +0 -1
- package/dist/core/backend-deploy/logger.d.ts +0 -10
- package/dist/core/backend-deploy/logger.d.ts.map +0 -1
- package/dist/core/backend-deploy/logger.js +0 -22
- package/dist/core/backend-deploy/logger.js.map +0 -1
- package/dist/core/backend-deploy/registry-login-push.d.ts +0 -24
- package/dist/core/backend-deploy/registry-login-push.d.ts.map +0 -1
- package/dist/core/backend-deploy/registry-login-push.js +0 -37
- package/dist/core/backend-deploy/registry-login-push.js.map +0 -1
- package/dist/core/backend-deploy/remote-docker-client.d.ts +0 -11
- package/dist/core/backend-deploy/remote-docker-client.d.ts.map +0 -1
- package/dist/core/backend-deploy/remote-docker-client.js +0 -34
- package/dist/core/backend-deploy/remote-docker-client.js.map +0 -1
- package/dist/core/backend-deploy/remote-pull-image.d.ts +0 -9
- package/dist/core/backend-deploy/remote-pull-image.d.ts.map +0 -1
- package/dist/core/backend-deploy/remote-pull-image.js +0 -39
- package/dist/core/backend-deploy/remote-pull-image.js.map +0 -1
- package/dist/core/backend-deploy/resolve-dockerfile.d.ts +0 -7
- package/dist/core/backend-deploy/resolve-dockerfile.d.ts.map +0 -1
- package/dist/core/backend-deploy/resolve-dockerfile.js +0 -24
- package/dist/core/backend-deploy/resolve-dockerfile.js.map +0 -1
- package/dist/core/backend-deploy/run-docker-cli.d.ts +0 -9
- package/dist/core/backend-deploy/run-docker-cli.d.ts.map +0 -1
- package/dist/core/backend-deploy/run-docker-cli.js +0 -14
- package/dist/core/backend-deploy/run-docker-cli.js.map +0 -1
- package/dist/core/backend-deploy/types.d.ts +0 -23
- package/dist/core/backend-deploy/types.d.ts.map +0 -1
- package/dist/core/backend-deploy/types.js +0 -3
- package/dist/core/backend-deploy/types.js.map +0 -1
- package/dist/core/branch-name.d.ts +0 -8
- package/dist/core/branch-name.d.ts.map +0 -1
- package/dist/core/branch-name.js +0 -37
- package/dist/core/branch-name.js.map +0 -1
- package/dist/core/constants.d.ts +0 -4
- package/dist/core/constants.d.ts.map +0 -1
- package/dist/core/constants.js +0 -16
- package/dist/core/constants.js.map +0 -1
- package/dist/core/cursor-cmd.d.ts +0 -30
- package/dist/core/cursor-cmd.d.ts.map +0 -1
- package/dist/core/cursor-cmd.js +0 -193
- package/dist/core/cursor-cmd.js.map +0 -1
- package/dist/core/minio.d.ts +0 -37
- package/dist/core/minio.d.ts.map +0 -1
- package/dist/core/minio.js +0 -159
- package/dist/core/minio.js.map +0 -1
- package/dist/core/parse-testcase-md.d.ts +0 -17
- package/dist/core/parse-testcase-md.d.ts.map +0 -1
- package/dist/core/parse-testcase-md.js +0 -79
- package/dist/core/parse-testcase-md.js.map +0 -1
- package/dist/core/std-event-handler.d.ts +0 -25
- package/dist/core/std-event-handler.d.ts.map +0 -1
- package/dist/core/std-event-handler.js +0 -90
- package/dist/core/std-event-handler.js.map +0 -1
- package/dist/core/utils.d.ts +0 -19
- package/dist/core/utils.d.ts.map +0 -1
- package/dist/core/utils.js +0 -71
- package/dist/core/utils.js.map +0 -1
- package/dist/core/ws-client.d.ts +0 -29
- package/dist/core/ws-client.d.ts.map +0 -1
- package/dist/core/ws-client.js +0 -81
- package/dist/core/ws-client.js.map +0 -1
- package/dist/employee-ws-client.d.ts +0 -42
- package/dist/employee-ws-client.d.ts.map +0 -1
- package/dist/employee-ws-client.js +0 -99
- package/dist/employee-ws-client.js.map +0 -1
- package/dist/index.d.ts +0 -6
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/templates/commands/apm-auto-dev.md +0 -6
- package/templates/commands/apm-fixbug.md +0 -6
- package/templates/commands/apm-prd-review.md +0 -6
- package/templates/commands/apm-prd-sync.md +0 -6
- package/templates/skills/apm-apply-change/SKILL.md +0 -191
- package/templates/skills/apm-auto-dev/SKILL.md +0 -170
- package/templates/skills/apm-fixbug/SKILL.md +0 -97
- package/templates/skills/apm-propose/SKILL.md +0 -123
- package/templates/skills/apm-propose/design-instruction.md +0 -94
- package/templates/skills/apm-propose/propose-instruction.md +0 -81
- package/templates/skills/apm-propose/specs-instruction.md +0 -114
- package/templates/skills/apm-propose/tasks-instruction.md +0 -90
- package/templates/skills/apm-release/SKILL.md +0 -87
- package/templates/skills/code-change-summary/SKILL.md +0 -84
- package/templates/skills/code-change-summary/summary-template.md +0 -55
- package/templates/skills/code-deploy/SKILL.md +0 -39
- package/templates/skills/prd-review/SKILL.md +0 -48
- package/templates/skills/prd-review/output-template.md +0 -47
- package/templates/skills/prd-sync/SKILL.md +0 -74
- package/templates/skills/prd-sync/updated-requirement-template.md +0 -39
- package/templates/skills/prd-testcase/SKILL.md +0 -82
- package/templates/skills/prd-testcase/reference.md +0 -44
- package/templates/skills/product-capability-inventory/SKILL.md +0 -131
- package/templates/skills/product-capability-inventory/template.md +0 -80
- package/templates/skills/product-capability-inventory//344/275/277/347/224/250/350/257/264/346/230/216/344/271/246.md +0 -36
- package/templates/skills/product-capability-inventory//347/233/256/345/275/225/350/247/204/350/214/203.md +0 -58
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 员工 CLI WebSocket:与后端 `AppWebSocketGateway` 一致,
|
|
3
|
-
* 使用 URL 查询参数 `token`(`Employee.cliToken`),路径 `/ws`;
|
|
4
|
-
* 端口优先 `apm config set ws-port`,否则回退 {@link FALLBACK_EMPLOYEE_WS_PORT}。
|
|
5
|
-
*/
|
|
6
|
-
import WebSocket from "ws";
|
|
7
|
-
import { FALLBACK_EMPLOYEE_WS_PORT, resolveEmployeeWsPortFromConfig } from "./config-store";
|
|
8
|
-
export { FALLBACK_EMPLOYEE_WS_PORT, resolveEmployeeWsPortFromConfig };
|
|
9
|
-
/** 与 `EmployeeWebsocketPushService.pushToEmployee` 发送格式一致 */
|
|
10
|
-
export type EmployeeWsServerMessage = {
|
|
11
|
-
event: string;
|
|
12
|
-
data: unknown;
|
|
13
|
-
};
|
|
14
|
-
export type BuildEmployeeWebSocketUrlOptions = {
|
|
15
|
-
/** 显式端口;不传则 {@link resolveEmployeeWsPortFromConfig}(配置 → 回退 4000) */
|
|
16
|
-
port?: number;
|
|
17
|
-
};
|
|
18
|
-
/**
|
|
19
|
-
* 由 `baseUrl` 解析主机名(与 HTTP 同源),使用独立 WS 端口构造 `ws(s)://host:port/ws?token=...`。
|
|
20
|
-
*/
|
|
21
|
-
export declare function buildEmployeeWebSocketUrl(baseUrl: string, token: string, options?: BuildEmployeeWebSocketUrlOptions): string;
|
|
22
|
-
export type CreateEmployeeWebSocketOptions = {
|
|
23
|
-
baseUrl: string;
|
|
24
|
-
token: string;
|
|
25
|
-
wsPort?: number;
|
|
26
|
-
/** 服务端推送的 JSON:`{ event, data }`;解析失败时 `parsed` 为 `null` */
|
|
27
|
-
onMessage?: (raw: string, parsed: EmployeeWsServerMessage | null) => void;
|
|
28
|
-
onOpen?: () => void;
|
|
29
|
-
onClose?: (code: number, reason: Buffer) => void;
|
|
30
|
-
onError?: (err: Error) => void;
|
|
31
|
-
};
|
|
32
|
-
/**
|
|
33
|
-
* 使用员工 token 建立 WebSocket,连接成功后可在 `onMessage` 中接收服务端推送。
|
|
34
|
-
*/
|
|
35
|
-
export declare function createEmployeeWebSocket(options: CreateEmployeeWebSocketOptions): WebSocket;
|
|
36
|
-
/**
|
|
37
|
-
* 连接并等待服务端消息,直到连接关闭或 `signal` 中止。
|
|
38
|
-
*/
|
|
39
|
-
export declare function connectEmployeeWebSocketAndWait(options: CreateEmployeeWebSocketOptions & {
|
|
40
|
-
signal?: AbortSignal;
|
|
41
|
-
}): Promise<WebSocket>;
|
|
42
|
-
//# sourceMappingURL=employee-ws-client.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"employee-ws-client.d.ts","sourceRoot":"","sources":["../src/employee-ws-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EACL,yBAAyB,EAEzB,+BAA+B,EAChC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,CAAC;AAEtE,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gCAAgC,GACzC,MAAM,CAaR;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,SAAS,CA2BX;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,8BAA8B,GAAG;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,SAAS,CAAC,CA8BpB"}
|
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
-
};
|
|
5
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.resolveEmployeeWsPortFromConfig = exports.FALLBACK_EMPLOYEE_WS_PORT = void 0;
|
|
7
|
-
exports.buildEmployeeWebSocketUrl = buildEmployeeWebSocketUrl;
|
|
8
|
-
exports.createEmployeeWebSocket = createEmployeeWebSocket;
|
|
9
|
-
exports.connectEmployeeWebSocketAndWait = connectEmployeeWebSocketAndWait;
|
|
10
|
-
/**
|
|
11
|
-
* 员工 CLI WebSocket:与后端 `AppWebSocketGateway` 一致,
|
|
12
|
-
* 使用 URL 查询参数 `token`(`Employee.cliToken`),路径 `/ws`;
|
|
13
|
-
* 端口优先 `apm config set ws-port`,否则回退 {@link FALLBACK_EMPLOYEE_WS_PORT}。
|
|
14
|
-
*/
|
|
15
|
-
const ws_1 = __importDefault(require("ws"));
|
|
16
|
-
const config_store_1 = require("./config-store");
|
|
17
|
-
Object.defineProperty(exports, "FALLBACK_EMPLOYEE_WS_PORT", { enumerable: true, get: function () { return config_store_1.FALLBACK_EMPLOYEE_WS_PORT; } });
|
|
18
|
-
Object.defineProperty(exports, "resolveEmployeeWsPortFromConfig", { enumerable: true, get: function () { return config_store_1.resolveEmployeeWsPortFromConfig; } });
|
|
19
|
-
/**
|
|
20
|
-
* 由 `baseUrl` 解析主机名(与 HTTP 同源),使用独立 WS 端口构造 `ws(s)://host:port/ws?token=...`。
|
|
21
|
-
*/
|
|
22
|
-
function buildEmployeeWebSocketUrl(baseUrl, token, options) {
|
|
23
|
-
const u = new URL((0, config_store_1.normalizeBaseUrl)(baseUrl));
|
|
24
|
-
const explicit = options?.port;
|
|
25
|
-
const port = explicit != null &&
|
|
26
|
-
Number.isFinite(explicit) &&
|
|
27
|
-
explicit >= 1 &&
|
|
28
|
-
explicit <= 65535
|
|
29
|
-
? Math.floor(explicit)
|
|
30
|
-
: (0, config_store_1.resolveEmployeeWsPortFromConfig)();
|
|
31
|
-
const wsProto = u.protocol === "https:" ? "wss:" : "ws:";
|
|
32
|
-
const params = new URLSearchParams({ token: token.trim() });
|
|
33
|
-
return `${wsProto}//${u.hostname}:${port}/ws?${params.toString()}`;
|
|
34
|
-
}
|
|
35
|
-
/**
|
|
36
|
-
* 使用员工 token 建立 WebSocket,连接成功后可在 `onMessage` 中接收服务端推送。
|
|
37
|
-
*/
|
|
38
|
-
function createEmployeeWebSocket(options) {
|
|
39
|
-
const url = buildEmployeeWebSocketUrl(options.baseUrl, options.token, {
|
|
40
|
-
port: options.wsPort,
|
|
41
|
-
});
|
|
42
|
-
const ws = new ws_1.default(url);
|
|
43
|
-
ws.on("open", () => options.onOpen?.());
|
|
44
|
-
ws.on("close", (code, reason) => options.onClose?.(code, reason));
|
|
45
|
-
ws.on("error", (err) => options.onError?.(err));
|
|
46
|
-
ws.on("message", (data) => {
|
|
47
|
-
const raw = Buffer.isBuffer(data) ? data.toString("utf8") : String(data);
|
|
48
|
-
let parsed = null;
|
|
49
|
-
try {
|
|
50
|
-
const j = JSON.parse(raw);
|
|
51
|
-
if (j &&
|
|
52
|
-
typeof j === "object" &&
|
|
53
|
-
"event" in j &&
|
|
54
|
-
typeof j.event === "string") {
|
|
55
|
-
parsed = j;
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
catch {
|
|
59
|
-
/* 非 JSON 时 parsed 保持 null */
|
|
60
|
-
}
|
|
61
|
-
options.onMessage?.(raw, parsed);
|
|
62
|
-
});
|
|
63
|
-
return ws;
|
|
64
|
-
}
|
|
65
|
-
/**
|
|
66
|
-
* 连接并等待服务端消息,直到连接关闭或 `signal` 中止。
|
|
67
|
-
*/
|
|
68
|
-
function connectEmployeeWebSocketAndWait(options) {
|
|
69
|
-
return new Promise((resolve, reject) => {
|
|
70
|
-
const ws = createEmployeeWebSocket({
|
|
71
|
-
...options,
|
|
72
|
-
onOpen: () => {
|
|
73
|
-
options.onOpen?.();
|
|
74
|
-
resolve(ws);
|
|
75
|
-
},
|
|
76
|
-
onError: (err) => {
|
|
77
|
-
options.onError?.(err);
|
|
78
|
-
reject(err);
|
|
79
|
-
},
|
|
80
|
-
});
|
|
81
|
-
const onAbort = () => {
|
|
82
|
-
try {
|
|
83
|
-
ws.close();
|
|
84
|
-
}
|
|
85
|
-
catch {
|
|
86
|
-
/* ignore */
|
|
87
|
-
}
|
|
88
|
-
};
|
|
89
|
-
if (options.signal) {
|
|
90
|
-
if (options.signal.aborted) {
|
|
91
|
-
onAbort();
|
|
92
|
-
reject(new Error("aborted"));
|
|
93
|
-
return;
|
|
94
|
-
}
|
|
95
|
-
options.signal.addEventListener("abort", onAbort, { once: true });
|
|
96
|
-
}
|
|
97
|
-
});
|
|
98
|
-
}
|
|
99
|
-
//# sourceMappingURL=employee-ws-client.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"employee-ws-client.js","sourceRoot":"","sources":["../src/employee-ws-client.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
DELETED
package/dist/index.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}
|
package/dist/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,8CAA4B;AAC5B,uDAAqC"}
|
|
@@ -1,191 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apm-apply-change
|
|
3
|
-
description: 在 .apm/workitems/<requirementId>/ 按 tasks.md 逐项实现、勾选;一项任务一个 commit。遇事实性阻塞(如规划与代码严重不符)须停止执行,仅陈述事实与需用户提供的材料,不替用户决策或列方案。/opsx:apply 同此技能。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# APM 工作项:按任务实现
|
|
7
|
-
|
|
8
|
-
根据工作项目录下的 **`tasks.md`** 驱动实现:**读规划 → 做代码 → 对账元数据 → 勾选 → 单独 commit**,直至全部完成或遇硬阻塞;上下文以 **`.apm/workitems/<requirementId>/`** 内文件为准。
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## 输入
|
|
13
|
-
|
|
14
|
-
| 字段 | 规则 |
|
|
15
|
-
| --- | --- |
|
|
16
|
-
| **`requirementId`** | **推荐显式提供**(与 `.apm/workitems/<requirementId>/` 目录名一致)。 |
|
|
17
|
-
|
|
18
|
-
若本轮未提供 `requirementId`:
|
|
19
|
-
|
|
20
|
-
1. 若对话中已能**唯一**确定工作项目录名,则用之。
|
|
21
|
-
2. 否则查看 **`.apm/workitems/`** 下子目录:若**仅有一个**,自动采用;若**多个**,**按目录名字典序取第一个**作为本次工作项,并在回复中列出当时可见的候选名,声明 **使用工作项:`<requirementId>`** 及如何覆盖(例如下次显式给出 id)。**不要**调用 AskUserQuestion,**不要**停下来让用户当场选择。
|
|
22
|
-
|
|
23
|
-
**不要**为澄清需求而反问用户。若执行中发现**无法在无决策前提下继续**的事实性问题(见上文 **「停止执行」**),**不要**用推断顶过去。
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 停止执行(优先于继续推进)
|
|
28
|
-
|
|
29
|
-
若在实施过程中**发现**任一情况,**立即停止**本技能所驱动的后续实现与勾选(不再继续下一项任务),仅在会话中输出:
|
|
30
|
-
|
|
31
|
-
1. **客观事实**:已读到的文件/路径、与代码或任务条目的**具体矛盾点**(可摘引,避免主观评价)。
|
|
32
|
-
2. **当前进度**:处理到 `tasks.md` 的哪一条、仓库是否已有未提交改动(若有,说明范围)。
|
|
33
|
-
3. **需要用户提供什么**:为继续推进所**缺的信息或决策**(例如:以何者为准、是否接受某类改动、需确认的业务口径)。用**清单**列出,**一句一项**。
|
|
34
|
-
|
|
35
|
-
**禁止**:给出「建议你先改 A / 再改 B」「可选方案 1/2/3」「宜采用…」等**替用户决策**或**行动建议**;不指导用户如何改文档、不预设优先级。
|
|
36
|
-
|
|
37
|
-
**允许**:描述「若不补充某信息则无法继续」的**逻辑关系**(仍不展开成方案)。
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
|
-
## 工作项路径与必备文件
|
|
42
|
-
|
|
43
|
-
- **根路径**:**`.apm/workitems/<requirementId>/`**
|
|
44
|
-
- **必备**:**`tasks.md`**(含 `- [ ]` / `- [x]` 待办)。若不存在或无可执行条目:**阻塞**,说明须先完成 **apm-propose**(或手工补齐 `tasks.md`)。
|
|
45
|
-
- **强烈建议读**:**`prd.md`**(范围与验收);实现时按需 **Read** **`proposal.md`**、**`design.md`**、**`specs/`**(与 **`tasks-instruction.md`** 中每条任务的元数据一致)。
|
|
46
|
-
- **进度**:仅由 **`tasks.md`** 中复选框统计「已完成 / 总数」。
|
|
47
|
-
|
|
48
|
-
### 单会话读取(可选减负)
|
|
49
|
-
|
|
50
|
-
同一轮连续执行多项任务时:**`prd.md` / `design.md` / 各 spec** 若已在会话内读过且无疑虑,不必每个任务重复全文 Read;以**当前任务行**及元数据指向的 spec/设计段落为准,必要时对文件 **Read(偏移)** 或再读全文。
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
## Steps
|
|
55
|
-
|
|
56
|
-
### 1. 锚定工作项
|
|
57
|
-
|
|
58
|
-
确定 **`requirementId`** 与工作项根路径;声明 **使用工作项:`<requirementId>`**(若依上节规则自动选定,须说明如何覆盖)。
|
|
59
|
-
|
|
60
|
-
### 2. 读取 `tasks.md` 并判断状态
|
|
61
|
-
|
|
62
|
-
- **Read** **`.apm/workitems/<requirementId>/tasks.md`**。
|
|
63
|
-
- 若文件缺失、为空、或无任何 `- [ ]`:**停止**,提示先具备可执行 `tasks`(规划阶段)。
|
|
64
|
-
- 若全部已为 `- [x]`:**可**直接汇报「已全部完成」(仅作事实陈述,不建议是否提交或发 MR)。
|
|
65
|
-
|
|
66
|
-
### 3. 读取实现上下文(按任务需要)
|
|
67
|
-
|
|
68
|
-
开始**第一个**未勾选任务前,至少 **Read**:
|
|
69
|
-
|
|
70
|
-
- **`prd.md`**(若存在;与验收相关条款)
|
|
71
|
-
- 与任务相关的 **`design.md`** 片段、**`specs/`** 下对应文件(见任务条目的 **需求编号** / 描述)
|
|
72
|
-
|
|
73
|
-
不要求每次任务都重读全部规划文件;以 **`tasks.md` 当前项** + **缺口再 Read** 为准。
|
|
74
|
-
|
|
75
|
-
### 4. 展示当前进度
|
|
76
|
-
|
|
77
|
-
在对话中简要展示:
|
|
78
|
-
|
|
79
|
-
- **工作项**:`requirementId`
|
|
80
|
-
- **进度**:「N/M 个任务已完成」(由 `tasks.md` 勾选统计)
|
|
81
|
-
- **当前将处理**:下一条 `- [ ]` 的摘要(含组号/编号如 `2.1`)
|
|
82
|
-
|
|
83
|
-
### 5. 实现任务(循环直至完成或阻塞)
|
|
84
|
-
|
|
85
|
-
对每一条 **未勾选** 任务(建议按 `tasks.md` 自上而下顺序):
|
|
86
|
-
|
|
87
|
-
1. **说明**正在处理哪一项(编号 + 简述)。
|
|
88
|
-
2. **实现**所需代码/配置/迁移等;改动保持**最小**、与该项描述一致。
|
|
89
|
-
3. **标记完成前**在回复或备注中收集依据(与 **`tasks-instruction.md`** 子列表字段对齐即可):
|
|
90
|
-
- **需求编号**:本实现对应 specs / tasks 中的哪条需求或场景。
|
|
91
|
-
- **预期改动路径** 与 **实际改动文件**:若有合理偏差,简要说明原因。
|
|
92
|
-
- **验证用例编号**(若任务中有)。
|
|
93
|
-
- **验证结果** / **完成标准**:如何确认本项已达成(可简短)。
|
|
94
|
-
4. 仅在依据已齐、且自洽通过后,将 **`tasks.md`** 中对应行 **`- [ ]` 改为 `- [x]`**。
|
|
95
|
-
5. **Git**:本待办对应的**实现 + 勾选**等改动,**单独 `git commit` 一次**(**一项待办 = 一个 commit**;勿把多项待办混在同一 commit)。提交信息建议包含 `requirementId` 与任务编号或简述。
|
|
96
|
-
|
|
97
|
-
**何时停止(不继续下一项)**——与上文 **「停止执行」** 一致:
|
|
98
|
-
|
|
99
|
-
- **`design` / `specs` / `tasks` 与当前代码或彼此严重不一致**,以致无法按任务字面含义在**不臆造**的前提下完成 → **按「停止执行」输出**(事实 + 需用户提供的材料),**不**建议先改哪份文档、不改哪些。
|
|
100
|
-
- 命令失败、环境错误、权限等**硬阻塞** → 说明原因、失败点、已执行步骤;**不**给排障步骤或替代命令建议(除非任务本身要求执行某命令且该命令已写在任务/文档中)。
|
|
101
|
-
- 用户中断。
|
|
102
|
-
|
|
103
|
-
**何时仍可继续**(仅当满足):任务表述略含糊,但可在 **prd / design / specs / tasks** 已有文字内**自洽**完成;若有**假设**,在回复中写清**假设**(仍不反问)。一旦假设会触及「以谁为准」的**产品/架构决策**,转 **「停止执行」**。
|
|
104
|
-
|
|
105
|
-
### 6. 完成或暂停时展示状态
|
|
106
|
-
|
|
107
|
-
- **本会话**完成了哪些任务(可列勾选项摘要)。
|
|
108
|
-
- **总体进度**:「N/M 个任务已完成」。
|
|
109
|
-
- 若**全部完成**:仅陈述事实(进度与勾选状态),**不**建议后续流程(MR/发布/归档等)。
|
|
110
|
-
- 若**暂停**:按 **「停止执行」** 或硬阻塞格式输出,**无**「可选后续」或方案建议。
|
|
111
|
-
|
|
112
|
-
---
|
|
113
|
-
|
|
114
|
-
## 实现过程中的输出(示例)
|
|
115
|
-
|
|
116
|
-
```
|
|
117
|
-
## 正在实施:<requirementId>
|
|
118
|
-
|
|
119
|
-
处理任务 3/7:2.1 实现导出接口
|
|
120
|
-
[...实现过程...]
|
|
121
|
-
✓ 任务完成 · commit <short-sha> <subject>
|
|
122
|
-
|
|
123
|
-
处理任务 4/7:2.2 …
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
---
|
|
127
|
-
|
|
128
|
-
## 全部完成时的输出(示例)
|
|
129
|
-
|
|
130
|
-
```
|
|
131
|
-
## 实现完成
|
|
132
|
-
|
|
133
|
-
**工作项:** <requirementId>
|
|
134
|
-
**进度:** 7/7 个任务已完成 ✓
|
|
135
|
-
|
|
136
|
-
### 本会话已完成
|
|
137
|
-
- [x] …
|
|
138
|
-
- [x] …
|
|
139
|
-
|
|
140
|
-
(每项待办均已对应独立 commit。)
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
---
|
|
144
|
-
|
|
145
|
-
## 暂停时的输出(示例)
|
|
146
|
-
|
|
147
|
-
```
|
|
148
|
-
## 实现已暂停
|
|
149
|
-
|
|
150
|
-
**工作项:** <requirementId>
|
|
151
|
-
**进度:** 4/7 个任务已完成
|
|
152
|
-
|
|
153
|
-
### 事实与原因
|
|
154
|
-
<客观描述:文件/行/与任务或代码的矛盾点>
|
|
155
|
-
|
|
156
|
-
### 需要用户提供(或决策)
|
|
157
|
-
- …
|
|
158
|
-
- …
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
(无方案列表、无「建议」;用户补充信息后可再次运行本技能。)
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
165
|
-
## 约束
|
|
166
|
-
|
|
167
|
-
- 持续执行待办直至完成、**停止执行**或硬阻塞。
|
|
168
|
-
- 开始前须已能对照 **`tasks.md`** 与 **`prd.md`**(及任务所需的 design/spec);**不要**在未读清当前任务依赖时盲改。
|
|
169
|
-
- 任务表述有歧义时,仅在**无需用户决策**的前提下依据 **specs / design / prd** 推断;一旦涉及**以谁为准**或**严重不一致**,**停止执行**(见上文)。
|
|
170
|
-
- **不**因「发现规划与代码不符」而**主动建议**修改 `design.md` / `specs/` / `tasks.md`;**停止**并说明事实与需用户提供的材料即可。
|
|
171
|
-
- 代码改动保持最小、与**当前任务**范围一致。
|
|
172
|
-
- 未完成需求/验证对账前,**不要**将任务勾为完成。
|
|
173
|
-
- 验证失败或依据不足时,保持 **`- [ ]`**,并明确写出缺口。
|
|
174
|
-
- 若任务元数据缺失(需求编号、预期改动路径、完成标准等),在可能范围内于实现前**补全或按 tasks 模板推断**,并在说明中注明。
|
|
175
|
-
- 每完成一项任务并记录依据后,**立即**更新勾选并**随即**单独 `git commit`。
|
|
176
|
-
- 遇硬阻塞时暂停并说明原因(**不**给出替代命令或排查建议,除非任务/文档已写明);
|
|
177
|
-
- 需求不清且无法自洽推断时,**停止执行**并列出需用户提供的材料;**不反问用户**。
|
|
178
|
-
|
|
179
|
-
---
|
|
180
|
-
|
|
181
|
-
## 与规划流程的衔接
|
|
182
|
-
|
|
183
|
-
- **`tasks.md`** 须由 **apm-propose**(或等价流程)生成并符合 **`tasks-instruction.md`** 格式(`- [ ]`、元数据子列表等),否则本技能无法可靠追踪。
|
|
184
|
-
- 若执行中发现 **`design` / `specs` 与代码严重不一致**:**停止执行**,按上文输出事实与**需用户提供**的决策/信息;**不**建议先改哪类工件、不代用户排优先级。
|
|
185
|
-
|
|
186
|
-
---
|
|
187
|
-
|
|
188
|
-
## 流动工作流
|
|
189
|
-
|
|
190
|
-
- **可分段调用**:可在部分任务完成后结束会话,下次同一工作项继续。
|
|
191
|
-
- **规划修订**:由用户在**流程外**修订 `design.md` / `specs/` / `tasks.md` 后,再触发本技能;本技能执行中**不因发现不符**而主动改规划文件或提出修改方案。
|
|
@@ -1,170 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apm-auto-dev
|
|
3
|
-
description: 从创建分支到需求的开发的完整流程,当用户明确声明使用本技能时触发。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# APM 全自动开发
|
|
7
|
-
|
|
8
|
-
**角色**:主 Agent 只做参数传递、**串行**启动子 Agent、校验上一步产物、失败则停止并汇总(**例外见步骤 8/9**);**禁止**在同一对话里自己执行完整 **apm-propose + apm-apply-change** 长流程而不用子 Agent。流程结束须输出**步骤结果汇总表**(见文末「主 Agent 汇总输出」)。
|
|
9
|
-
|
|
10
|
-
**输入(必填)** requirementId:需求 id
|
|
11
|
-
|
|
12
|
-
## 触发条件
|
|
13
|
-
|
|
14
|
-
用户**明确声明**使用本技能(例如在对话中 @ 本 SKILL)
|
|
15
|
-
|
|
16
|
-
## 输入
|
|
17
|
-
|
|
18
|
-
- **`requirementId`(必须)**:需求 ID。
|
|
19
|
-
- **`baseBranchName`(可选)**: 基线分支名称,如果用户没给,那么不是 master 就是 main
|
|
20
|
-
|
|
21
|
-
## 子 Agent 强制隔离
|
|
22
|
-
|
|
23
|
-
- 步骤 **1 ~ 2** 各对应一次 **Task 子 Agent**;**步骤 2 之后**主 Agent 判定 **Quick / Spec**(二选一,见下节),再启动 **仅一条**开发路径:
|
|
24
|
-
- **Quick**:一步子 Agent 完成「步骤 3(Quick)」后,直接进入步骤 6(生成修改摘要)。
|
|
25
|
-
- **Spec**:**步骤 4(Spec)— apm-propose** 与 **步骤 5(Spec)— apm-apply-change**(产物均在 `.apm/workitems/<requirementId>/`)各一次子 Agent,再进入步骤 6(生成修改摘要)。
|
|
26
|
-
- 步骤 **6 ~ 9** 各对应一次子 Agent,**严格串行**:仅当上一步子 Agent **明确结束**且主 Agent **已校验产物**后,再启动下一步(**步骤 8 发布失败时仍须启动步骤 9**,见步骤 8 说明)。
|
|
27
|
-
- **禁止**并行启动多个子 Agent 执行本流程中的步骤;**禁止**同一次流程中既走 Quick 又走 Spec。
|
|
28
|
-
- 子 Agent 需执行完毕:读 SKILL、跑命令、写文件、回报结构化结果(路径、变更名、成功/失败)。
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
## 步骤 1 — 子 Agent:Git 分支与未提交处理
|
|
33
|
-
|
|
34
|
-
在仓库根目录执行(仅读写 git,逻辑如下)。
|
|
35
|
-
|
|
36
|
-
1. `git fetch origin`(确保能拿到远程分支)。
|
|
37
|
-
2. 记 `TARGET=<用户分支名>`,`CURRENT=$(git branch --show-current)`。
|
|
38
|
-
3. 判断是否脏:`git status --porcelain` 非空即为脏。
|
|
39
|
-
4. 若 `CURRENT != TARGET` 且脏 → `git stash push -u -m "apm-auto-dev: wip before checkout ${TARGET}"`,再检出目标分支。
|
|
40
|
-
5. 若 `CURRENT == TARGET` 且脏 → **不 stash**:根据当前 diff 生成提交说明并提交(例如用 `git diff --stat` 与关键文件摘要凑成一句 subject + 可选 body;或 `git commit -am` 等价操作),**不得**无消息提交。
|
|
41
|
-
6. 检出 `TARGET`(本地无则跟踪远程,例如 `git switch -c "$TARGET" "origin/$TARGET"` 或 `git checkout --track "origin/$TARGET"`,以当前 git 版本可用命令为准)。
|
|
42
|
-
7. 若第 4 步曾 stash,检出成功后 **不要** 自动 pop(避免与后续自动化冲突);在最终结果中提醒用户稍后自行 `git stash pop` 如需取回。
|
|
43
|
-
|
|
44
|
-
**完成判定**:`git branch --show-current` 等于 `TARGET`;第 4/5 步语义已执行。
|
|
45
|
-
|
|
46
|
-
---
|
|
47
|
-
|
|
48
|
-
## 步骤 2 — 子 Agent:开发前准备
|
|
49
|
-
|
|
50
|
-
1. 获取需求内容:执行 `apm get requirement <requirementId>`
|
|
51
|
-
2. 基于分支命名规范创建一个分支,并切换到这个分支,基线分支为 <baseBranchName>
|
|
52
|
-
3. 信息回传到远程:执行 `apm set branchName <branchName>`
|
|
53
|
-
|
|
54
|
-
**完成判定**:命令成功返回(退出码 0),且无错误输出。
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## 开发模式判定(主 Agent,紧接步骤 2 之后)
|
|
59
|
-
|
|
60
|
-
在启动任何「步骤 3(Quick)/ 步骤 4(Spec)」子 Agent 之前,主 Agent 根据 **`.apm/workitems/<requirementId>/prd.md`**(或步骤 2 回报摘要)判断本次采用 **Quick** 还是 **Spec**,**二者必选其一、互斥**:
|
|
61
|
-
|
|
62
|
-
| 倾向 Quick | 倾向 Spec |
|
|
63
|
-
| ---------------------------------------- | ------------------------------------------- |
|
|
64
|
-
| 逻辑面少、改动范围小、对现有行为影响面低 | 涉及多模块、协议/数据模型/权限等契约变化 |
|
|
65
|
-
| 多为文案、样式、单点配置、小函数修补 | 需要可追溯规格与任务拆解、跨文件协调 |
|
|
66
|
-
| 回归路径清晰、不易引入隐蔽 BUG | 歧义多或易出边界 BUG,需 propose/tasks 约束 |
|
|
67
|
-
|
|
68
|
-
**规则**:若同时满足表中「倾向 Quick」的典型特征且不满足必须走 Spec 的红线,选 **Quick**;否则选 **Spec**。判定结果须写入最终汇总表(含一句简要理由)。
|
|
69
|
-
|
|
70
|
-
- 选 **Quick** → 只执行 **步骤 3(Quick)**,**跳过** apm-propose 与 apm-apply-change(步骤 4/5 Spec)。
|
|
71
|
-
- 选 **Spec** → **跳过**步骤 3(Quick),依次执行 **步骤 4(Spec)**、**步骤 5(Spec)**。
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
75
|
-
## 步骤 3(Quick)— 子 Agent:直接实现(与 Spec 二选一)
|
|
76
|
-
|
|
77
|
-
**前置**:开发模式判定为 **Quick**;本步与「步骤 4(Spec)+ 步骤 5(Spec)」**不得**同跑。
|
|
78
|
-
|
|
79
|
-
1. 读取 **`.apm/workitems/<requirementId>/prd.md` 全文**,按 PRD 在仓库内**直接完成实现**(改代码、配置、测试等以项目惯例为准),**不**写入本流程 Spec 模式下的 `proposal.md` / `design.md` / `tasks.md` 等规划工件(除非为修复所必需),**不**调用 apm-propose / apm-apply-change。
|
|
80
|
-
2. 改动应可审阅:子 Agent 回报主要修改文件路径列表、自测结论(若有);**不要**向用户追问需求细节,歧义按合理假设处理。
|
|
81
|
-
3. 主 Agent 校验:工作区存在与 PRD 对应的实质变更(或子 Agent 明确说明无需改文件的合法情况)。
|
|
82
|
-
|
|
83
|
-
**完成判定**:PRD 要点已在代码库中落实;无未完成的中途阻塞。
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
## 步骤 4(Spec)— 子 Agent:apm-propose(与 Quick 二选一)
|
|
88
|
-
|
|
89
|
-
**前置**:开发模式判定为 **Spec**;若已走 Quick,**不得**执行本节。
|
|
90
|
-
|
|
91
|
-
1. 读取并遵循:`.apm/skills/apm-propose/SKILL.md`。
|
|
92
|
-
2. **输入(必须)**:**`requirementId`**;**`.apm/workitems/<requirementId>/prd.md`** 须 Read 全文。**不要**追问。
|
|
93
|
-
3. **输出**:回报 **`.apm/workitems/<requirementId>/`**,并确认已写入 `proposal.md`、`design.md`、`tasks.md` 与 `specs/`(按 SKILL)。
|
|
94
|
-
|
|
95
|
-
**完成判定**:上述文件存在且非空;`prd.md` 要点已反映在各工件中。
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
99
|
-
## 步骤 5(Spec)— 子 Agent:apm-apply-change
|
|
100
|
-
|
|
101
|
-
**前置**:仅 **Spec** 模式;步骤 4(Spec)已成功。
|
|
102
|
-
|
|
103
|
-
1. 读取并遵循:`.apm/skills/apm-apply-change/SKILL.md`。
|
|
104
|
-
2. **输入(必须)**:**`requirementId`**(与步骤 4 同源);主 Agent 传入步骤 4 的结构化结果。
|
|
105
|
-
3. 按 `tasks.md` 执行直至完成或硬阻塞。
|
|
106
|
-
|
|
107
|
-
**完成判定**:与 apm-apply-change SKILL 一致。
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## 步骤 6 — 子 Agent:生成修改摘要
|
|
112
|
-
|
|
113
|
-
**执行步骤**:调用技能 `code-change-summary`,这个技能需要两个参数:对比的基线分支名称(可选)和需求ID(必选)
|
|
114
|
-
**完成判定**:`change.md` 存在。
|
|
115
|
-
---
|
|
116
|
-
|
|
117
|
-
## 步骤 7 — 子 Agent:全量提交并推送代码
|
|
118
|
-
|
|
119
|
-
1. `git status`:若有未跟踪或已修改文件,则 `git add -A`。
|
|
120
|
-
2. 若有暂存变更:生成提交说明——**Spec** 模式可写「全自动交付 + PRD/MR 文档 + 工作项 tasks 实现」;**Quick** 模式写「全自动交付 + PRD/MR 文档 + 直接实现」(可附 requirement id、version-seq)。
|
|
121
|
-
3. **必须** `git push -u origin "<TARGET>"`(或当前分支已设 upstream 则 `git push`);推送失败则回报 stderr,全流程标记失败。
|
|
122
|
-
|
|
123
|
-
**完成判定**:推送成功;工作区干净或仅剩用户需自理的 stash 提示。
|
|
124
|
-
|
|
125
|
-
---
|
|
126
|
-
|
|
127
|
-
## 步骤 8 — 子 Agent:部署&同步状态
|
|
128
|
-
|
|
129
|
-
1. 调用**Read**工具阅读 `.apm/skills/code-deploy/SKILL.md`,严格按照其要求将项目部署到测试环境
|
|
130
|
-
2. 执行CLI命令更新需求状态 `apm status requirement <需求ID>`
|
|
131
|
-
---
|
|
132
|
-
|
|
133
|
-
## 主 Agent 汇总输出
|
|
134
|
-
|
|
135
|
-
主 Agent 在流程末尾**必须**给出两部分:**(1)步骤结果汇总表**、**(2)补充说明**。
|
|
136
|
-
|
|
137
|
-
### (1)步骤结果汇总表(必填)
|
|
138
|
-
|
|
139
|
-
用 Markdown 表格列出**本流程实际执行的每一步**及结果(未执行的步骤标为「跳过」并简述原因)。列建议:`步骤` | `说明` | `结果` | `备注`。
|
|
140
|
-
|
|
141
|
-
示例结构(主 Agent 按实况填行,不得留空表;**未执行**的步骤在「结果」标 **跳过** 并简述原因):
|
|
142
|
-
|
|
143
|
-
| 步骤 | 说明 | 结果 | 备注 |
|
|
144
|
-
| --- | --- | --- | --- |
|
|
145
|
-
| 1 | Git 分支与未提交处理(`git fetch`、检出 `TARGET`、脏工作区 stash/提交) | 成功/失败/跳过 | stash 提醒等 |
|
|
146
|
-
| 2 | 开发前准备(`apm get requirement`、`apm set branchName`、基于 `baseBranchName` 建分支并切换) | 成功/失败 | `requirementId`、分支名 |
|
|
147
|
-
| — | **开发模式判定**(Quick **或** Spec) | 已判定 | 一句理由(见上文判定表) |
|
|
148
|
-
| 3 | **Quick开发模式编码**:步骤 3 直接按 PRD 实现;**Spec**:本步跳过 | 成功/失败/跳过 | 与步骤 4~5 互斥 |
|
|
149
|
-
| 4 | 生成Spec文件;**Quick**:跳过 | 成功/失败/跳过 | 产物目录 `.apm/workitems/<requirementId>/` |
|
|
150
|
-
| 5 | Spec开发模式编码;**Quick**:跳过 | 成功/失败/跳过 | 与步骤 4 同源 `requirementId` |
|
|
151
|
-
| 6 | 生成修改摘要 | 成功/失败 | `baseBranchName`(可选) |
|
|
152
|
-
| 7 | 提交代码 | 成功/失败 | `git push` |
|
|
153
|
-
| 8 | 部署 & 同步需求状态 | 成功/失败 | |
|
|
154
|
-
|
|
155
|
-
### (2)补充说明
|
|
156
|
-
|
|
157
|
-
在表后以精简列表补充:
|
|
158
|
-
|
|
159
|
-
- 分支名、`.apm/workitems/<requirementId>/` 路径;**Spec** 时写明同目录下已生成并使用的 `proposal.md` / `design.md` / `tasks.md` / `specs/`,**Quick** 时写明「未生成工作项规划工件(或未改 tasks)」。
|
|
160
|
-
- 步骤 8 测试环境部署结果(成功或失败原因;失败不阻断步骤 9)。
|
|
161
|
-
- 最终 commit SHA(若有)、远程推送结果。
|
|
162
|
-
- 若有 stash:提醒用户在其他分支上 `git stash pop` 时注意冲突。
|
|
163
|
-
|
|
164
|
-
---
|
|
165
|
-
|
|
166
|
-
## 护栏
|
|
167
|
-
|
|
168
|
-
- 任一步子 Agent 失败:**不要**静默跳过;停止后续步骤,输出失败步骤与可复现命令。
|
|
169
|
-
- 全程**不向用户追问**澄清需求;歧义按 **apm-propose / apm-apply-change** 中的「合理假设、不反问」处理;**Quick** 路径同样适用。
|
|
170
|
-
- **全流程交付完成**以步骤 8 结束为准;步骤 8 发布失败仅作为告警项写入汇总,**不**单独阻断「交付完成」判定。
|