@pigcloud/skills 1.0.11 → 1.1.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/CHANGELOG.md +25 -20
- package/README.en.md +41 -75
- package/README.md +26 -39
- package/bin/cli.js +260 -151
- package/bin/rules-loader.js +271 -484
- package/codex-commands/README.md +25 -23
- package/codex-commands/commands/analyze.md +21 -22
- package/codex-commands/commands/build.md +22 -22
- package/codex-commands/commands/design.md +21 -22
- package/codex-commands/commands/distill.md +21 -21
- package/codex-commands/commands/doc.md +21 -22
- package/codex-commands/commands/infra.md +21 -21
- package/codex-commands/commands/init.md +20 -20
- package/codex-commands/commands/kb.md +21 -20
- package/codex-commands/commands/perf.md +21 -21
- package/codex-commands/commands/prd.md +21 -22
- package/codex-commands/commands/review.md +21 -22
- package/codex-commands/commands/security.md +21 -22
- package/codex-commands/commands/test.md +21 -21
- package/codex-commands/commands/workflow.md +21 -20
- package/package.json +5 -2
- package/rules/core/index.md +26 -41
- package/rules/delivery/index.md +25 -0
- package/rules/design/index.md +25 -0
- package/rules/discovery/index.md +25 -0
- package/rules/implementation/index.md +25 -0
- package/rules/index.md +24 -39
- package/rules/overlays/index.md +19 -19
- package/rules/overlays/pig-cloud.md +20 -45
- package/rules/shared/index.md +25 -0
- package/rules/skill-stage-map.json +26 -0
- package/rules/stages.json +48 -0
- package/rules/validation/index.md +25 -0
- package/scripts/add-skill-reference-nav.js +3 -0
- package/scripts/bootstrap-skill-specs.js +96 -0
- package/scripts/ci-validator.sh +51 -114
- package/scripts/generate-skill-prompt-library.js +3 -0
- package/scripts/golden-prompt-suite.current.js +211 -0
- package/scripts/migrate-skill-packages.js +309 -0
- package/scripts/run-golden-replays.js +110 -79
- package/scripts/validate-rules.js +128 -125
- package/scripts/validate-skill-replay-signals.js +45 -57
- package/scripts/validate-skill-shapes.js +153 -127
- package/scripts/validate-skill-stop-rules.js +54 -46
- package/skills/01-discovery/ambiguity-detection/SKILL.md +30 -0
- package/skills/01-discovery/ambiguity-detection/assets/golden-prompt-suite.current.js +22 -0
- package/skills/01-discovery/ambiguity-detection/references/README.md +17 -0
- package/skills/01-discovery/ambiguity-detection/references/cases.md +26 -0
- package/skills/01-discovery/ambiguity-detection/references/prompt-template.md +18 -0
- package/skills/01-discovery/ambiguity-detection/skill-spec.json +26 -0
- package/skills/01-discovery/business-analysis/SKILL.md +30 -0
- package/skills/01-discovery/business-analysis/assets/golden-prompt-suite.current.js +22 -0
- package/skills/01-discovery/business-analysis/references/README.md +17 -0
- package/skills/01-discovery/business-analysis/references/cases.md +26 -0
- package/skills/01-discovery/business-analysis/references/prompt-template.md +18 -0
- package/skills/01-discovery/business-analysis/skill-spec.json +26 -0
- package/skills/01-discovery/impact-analysis/SKILL.md +30 -0
- package/skills/01-discovery/impact-analysis/assets/golden-prompt-suite.current.js +22 -0
- package/skills/01-discovery/impact-analysis/references/README.md +17 -0
- package/skills/01-discovery/impact-analysis/references/cases.md +26 -0
- package/skills/01-discovery/impact-analysis/references/prompt-template.md +18 -0
- package/skills/01-discovery/impact-analysis/skill-spec.json +26 -0
- package/skills/01-discovery/requirement-discovery/SKILL.md +30 -0
- package/skills/01-discovery/requirement-discovery/assets/golden-prompt-suite.current.js +24 -0
- package/skills/01-discovery/requirement-discovery/references/README.md +17 -0
- package/skills/01-discovery/requirement-discovery/references/cases.md +28 -0
- package/skills/01-discovery/requirement-discovery/references/prompt-template.md +18 -0
- package/skills/01-discovery/requirement-discovery/skill-spec.json +26 -0
- package/skills/02-design/api-design/SKILL.md +29 -0
- package/skills/02-design/api-design/assets/golden-prompt-suite.current.js +22 -0
- package/skills/02-design/api-design/references/README.md +17 -0
- package/skills/02-design/api-design/references/cases.md +26 -0
- package/skills/02-design/api-design/references/prompt-template.md +18 -0
- package/skills/02-design/api-design/skill-spec.json +25 -0
- package/skills/02-design/architecture-design/SKILL.md +29 -0
- package/skills/02-design/architecture-design/assets/golden-prompt-suite.current.js +22 -0
- package/skills/02-design/architecture-design/references/README.md +17 -0
- package/skills/02-design/architecture-design/references/cases.md +26 -0
- package/skills/02-design/architecture-design/references/prompt-template.md +18 -0
- package/skills/02-design/architecture-design/skill-spec.json +25 -0
- package/skills/02-design/database-design/SKILL.md +29 -0
- package/skills/02-design/database-design/assets/golden-prompt-suite.current.js +22 -0
- package/skills/02-design/database-design/references/README.md +17 -0
- package/skills/02-design/database-design/references/cases.md +26 -0
- package/skills/02-design/database-design/references/prompt-template.md +18 -0
- package/skills/02-design/database-design/skill-spec.json +25 -0
- package/skills/02-design/task-breakdown/SKILL.md +29 -0
- package/skills/02-design/task-breakdown/assets/golden-prompt-suite.current.js +22 -0
- package/skills/02-design/task-breakdown/references/README.md +17 -0
- package/skills/02-design/task-breakdown/references/cases.md +26 -0
- package/skills/02-design/task-breakdown/references/prompt-template.md +18 -0
- package/skills/02-design/task-breakdown/skill-spec.json +25 -0
- package/skills/03-implementation/backend-development/SKILL.md +29 -0
- package/skills/03-implementation/backend-development/assets/golden-prompt-suite.current.js +22 -0
- package/skills/03-implementation/backend-development/references/README.md +17 -0
- package/skills/03-implementation/backend-development/references/cases.md +26 -0
- package/skills/03-implementation/backend-development/references/prompt-template.md +18 -0
- package/skills/03-implementation/backend-development/skill-spec.json +25 -0
- package/skills/03-implementation/bug-fix/SKILL.md +29 -0
- package/skills/03-implementation/bug-fix/assets/golden-prompt-suite.current.js +22 -0
- package/skills/03-implementation/bug-fix/references/README.md +17 -0
- package/skills/03-implementation/bug-fix/references/cases.md +26 -0
- package/skills/03-implementation/bug-fix/references/prompt-template.md +18 -0
- package/skills/03-implementation/bug-fix/skill-spec.json +25 -0
- package/skills/03-implementation/database-change/SKILL.md +29 -0
- package/skills/03-implementation/database-change/assets/golden-prompt-suite.current.js +22 -0
- package/skills/03-implementation/database-change/references/README.md +17 -0
- package/skills/03-implementation/database-change/references/cases.md +26 -0
- package/skills/03-implementation/database-change/references/prompt-template.md +18 -0
- package/skills/03-implementation/database-change/skill-spec.json +25 -0
- package/skills/03-implementation/frontend-development/SKILL.md +29 -0
- package/skills/03-implementation/frontend-development/assets/golden-prompt-suite.current.js +22 -0
- package/skills/03-implementation/frontend-development/references/README.md +17 -0
- package/skills/03-implementation/frontend-development/references/cases.md +26 -0
- package/skills/03-implementation/frontend-development/references/prompt-template.md +18 -0
- package/skills/03-implementation/frontend-development/skill-spec.json +25 -0
- package/skills/04-validation/code-review/SKILL.md +29 -0
- package/skills/04-validation/code-review/assets/golden-prompt-suite.current.js +22 -0
- package/skills/04-validation/code-review/references/README.md +17 -0
- package/skills/04-validation/code-review/references/cases.md +26 -0
- package/skills/04-validation/code-review/references/prompt-template.md +18 -0
- package/skills/04-validation/code-review/skill-spec.json +25 -0
- package/skills/04-validation/performance-review/SKILL.md +29 -0
- package/skills/04-validation/performance-review/assets/golden-prompt-suite.current.js +22 -0
- package/skills/04-validation/performance-review/references/README.md +17 -0
- package/skills/04-validation/performance-review/references/cases.md +26 -0
- package/skills/04-validation/performance-review/references/prompt-template.md +18 -0
- package/skills/04-validation/performance-review/skill-spec.json +25 -0
- package/skills/04-validation/regression-check/SKILL.md +29 -0
- package/skills/04-validation/regression-check/assets/golden-prompt-suite.current.js +22 -0
- package/skills/04-validation/regression-check/references/README.md +17 -0
- package/skills/04-validation/regression-check/references/cases.md +26 -0
- package/skills/04-validation/regression-check/references/prompt-template.md +18 -0
- package/skills/04-validation/regression-check/skill-spec.json +25 -0
- package/skills/04-validation/security-review/SKILL.md +29 -0
- package/skills/04-validation/security-review/assets/golden-prompt-suite.current.js +22 -0
- package/skills/04-validation/security-review/references/README.md +17 -0
- package/skills/04-validation/security-review/references/cases.md +26 -0
- package/skills/04-validation/security-review/references/prompt-template.md +18 -0
- package/skills/04-validation/security-review/skill-spec.json +25 -0
- package/skills/04-validation/unit-test/SKILL.md +29 -0
- package/skills/04-validation/unit-test/assets/golden-prompt-suite.current.js +22 -0
- package/skills/04-validation/unit-test/references/README.md +17 -0
- package/skills/04-validation/unit-test/references/cases.md +26 -0
- package/skills/04-validation/unit-test/references/prompt-template.md +18 -0
- package/skills/04-validation/unit-test/skill-spec.json +25 -0
- package/skills/05-delivery/change-log/SKILL.md +29 -0
- package/skills/05-delivery/change-log/assets/golden-prompt-suite.current.js +22 -0
- package/skills/05-delivery/change-log/references/README.md +17 -0
- package/skills/05-delivery/change-log/references/cases.md +26 -0
- package/skills/05-delivery/change-log/references/prompt-template.md +18 -0
- package/skills/05-delivery/change-log/skill-spec.json +25 -0
- package/skills/05-delivery/deployment-guide/SKILL.md +29 -0
- package/skills/05-delivery/deployment-guide/assets/golden-prompt-suite.current.js +22 -0
- package/skills/05-delivery/deployment-guide/references/README.md +17 -0
- package/skills/05-delivery/deployment-guide/references/cases.md +26 -0
- package/skills/05-delivery/deployment-guide/references/prompt-template.md +18 -0
- package/skills/05-delivery/deployment-guide/skill-spec.json +25 -0
- package/skills/05-delivery/release-check/SKILL.md +29 -0
- package/skills/05-delivery/release-check/assets/golden-prompt-suite.current.js +22 -0
- package/skills/05-delivery/release-check/references/README.md +17 -0
- package/skills/05-delivery/release-check/references/cases.md +26 -0
- package/skills/05-delivery/release-check/references/prompt-template.md +18 -0
- package/skills/05-delivery/release-check/skill-spec.json +25 -0
- package/skills/05-delivery/release-validation/SKILL.md +29 -0
- package/skills/05-delivery/release-validation/assets/golden-prompt-suite.current.js +22 -0
- package/skills/05-delivery/release-validation/references/README.md +17 -0
- package/skills/05-delivery/release-validation/references/cases.md +26 -0
- package/skills/05-delivery/release-validation/references/prompt-template.md +18 -0
- package/skills/05-delivery/release-validation/skill-spec.json +25 -0
- package/skills/shared/codebase-learning/SKILL.md +29 -0
- package/skills/shared/codebase-learning/assets/golden-prompt-suite.current.js +22 -0
- package/skills/shared/codebase-learning/references/README.md +17 -0
- package/skills/shared/codebase-learning/references/cases.md +26 -0
- package/skills/shared/codebase-learning/references/prompt-template.md +18 -0
- package/skills/shared/codebase-learning/skill-spec.json +25 -0
- package/skills/shared/evidence-collector/SKILL.md +29 -0
- package/skills/shared/evidence-collector/assets/golden-prompt-suite.current.js +22 -0
- package/skills/shared/evidence-collector/references/README.md +17 -0
- package/skills/shared/evidence-collector/references/cases.md +26 -0
- package/skills/shared/evidence-collector/references/prompt-template.md +18 -0
- package/skills/shared/evidence-collector/skill-spec.json +25 -0
- package/skills/shared/framework-guide/SKILL.md +28 -0
- package/skills/shared/framework-guide/assets/golden-prompt-suite.current.js +22 -0
- package/skills/shared/framework-guide/references/README.md +17 -0
- package/skills/shared/framework-guide/references/cases.md +26 -0
- package/skills/shared/framework-guide/references/prompt-template.md +18 -0
- package/skills/shared/framework-guide/skill-spec.json +24 -0
- package/rules/bundles.json +0 -358
- package/rules/coding/analysis.md +0 -27
- package/rules/coding/backend/cache-invalidation.md +0 -30
- package/rules/coding/backend/cache-keying.md +0 -30
- package/rules/coding/backend/cache.md +0 -37
- package/rules/coding/backend/database.md +0 -32
- package/rules/coding/backend/feign.md +0 -30
- package/rules/coding/backend/index.md +0 -42
- package/rules/coding/backend/query.md +0 -32
- package/rules/coding/backend/remote.md +0 -33
- package/rules/coding/backend/transaction-boundary.md +0 -30
- package/rules/coding/backend/transaction-rollback.md +0 -30
- package/rules/coding/backend/transaction.md +0 -38
- package/rules/coding/boundary.md +0 -25
- package/rules/coding/implementation.md +0 -26
- package/rules/coding/index.md +0 -38
- package/rules/coding/scaffold.md +0 -28
- package/rules/coding/testing.md +0 -29
- package/rules/coding/validation.md +0 -29
- package/rules/core/code-quality.md +0 -30
- package/rules/core/evidence.md +0 -26
- package/rules/core/interface.md +0 -26
- package/rules/core/iteration.md +0 -26
- package/rules/core/layer-boundary.md +0 -25
- package/rules/core/logging.md +0 -26
- package/rules/core/security.md +0 -26
- package/rules/core/task-boundary.md +0 -27
- package/rules/docs/api.md +0 -34
- package/rules/docs/capture-summary.md +0 -29
- package/rules/docs/capture.md +0 -34
- package/rules/docs/contract.md +0 -30
- package/rules/docs/decision-log.md +0 -32
- package/rules/docs/examples.md +0 -28
- package/rules/docs/index.md +0 -49
- package/rules/docs/reference.md +0 -32
- package/rules/overlays/pig-cloud/controller.md +0 -33
- package/rules/overlays/pig-cloud/dto-vo.md +0 -33
- package/rules/overlays/pig-cloud/entity.md +0 -32
- package/rules/overlays/pig-cloud/exception.md +0 -32
- package/rules/overlays/pig-cloud/layering.md +0 -31
- package/rules/overlays/pig-cloud/mapper.md +0 -32
- package/rules/overlays/pig-cloud/query-style.md +0 -32
- package/rules/overlays/pig-cloud/rest-response.md +0 -33
- package/rules/overlays/pig-cloud/service.md +0 -33
- package/rules/overlays/pig-cloud/transactions.md +0 -32
- package/rules/overlays/pig-cloud/validation.md +0 -33
- package/rules/product/acceptance.md +0 -25
- package/rules/product/briefing.md +0 -27
- package/rules/product/index.md +0 -36
- package/rules/product/intake.md +0 -27
- package/rules/product/modeling.md +0 -25
- package/rules/product/project-context.md +0 -29
- package/rules/review/code.md +0 -35
- package/rules/review/evidence.md +0 -31
- package/rules/review/index.md +0 -50
- package/rules/review/java.md +0 -42
- package/rules/review/performance.md +0 -38
- package/rules/review/rubric.md +0 -28
- package/rules/review/security.md +0 -38
- package/rules/review/ts.md +0 -33
- package/rules/review/vue.md +0 -33
- package/rules/skill-profile-map.json +0 -59
- package/rules/skill-profile-map.md +0 -29
- package/rules/workflow/handoff.md +0 -25
- package/rules/workflow/index.md +0 -37
- package/rules/workflow/refinement.md +0 -29
- package/rules/workflow/router.md +0 -25
- package/rules/workflow/selection.md +0 -25
- package/rules/workflow/stop.md +0 -25
- package/skills/api-contract-docs/SKILL.md +0 -77
- package/skills/business-fact-extraction/SKILL.md +0 -337
- package/skills/business-fact-extraction/scripts/write-knowledge-base.js +0 -228
- package/skills/code-review/SKILL.md +0 -136
- package/skills/code-review/references/findings-template.md +0 -51
- package/skills/code-review/references/performance-checklist.md +0 -213
- package/skills/code-review/references/rubric.md +0 -232
- package/skills/code-review/references/rules.md +0 -32
- package/skills/code-review/references/security-checklist.md +0 -178
- package/skills/code-review/references/stack-notes.md +0 -25
- package/skills/code-review/references/template-review.md +0 -39
- package/skills/code-review/scripts/lint-code-review.mjs +0 -431
- package/skills/domain-modeling/SKILL.md +0 -81
- package/skills/domain-modeling/references/README.md +0 -134
- package/skills/domain-modeling/references/distillation-checklist.md +0 -44
- package/skills/domain-modeling/references/test-cases-template.md +0 -128
- package/skills/environment-deploy/SKILL.md +0 -81
- package/skills/feature-build/SKILL.md +0 -122
- package/skills/feature-build/references/coding-checklist.md +0 -97
- package/skills/feature-build/references/comment-specification.md +0 -89
- package/skills/knowledge-capture/SKILL.md +0 -93
- package/skills/performance-audit/SKILL.md +0 -118
- package/skills/project-bootstrap/SKILL.md +0 -81
- package/skills/references/anti-rationalization.md +0 -144
- package/skills/references/business-fact-extraction.md +0 -415
- package/skills/references/engineering-delivery-method.md +0 -64
- package/skills/references/engineering-delivery-template.md +0 -81
- package/skills/references/golden-prompt-suite.js +0 -436
- package/skills/references/golden-prompt-suite.md +0 -33
- package/skills/references/project-requirement-alignment.md +0 -42
- package/skills/references/rule-loading-map.md +0 -117
- package/skills/references/skill-authoring-standard.md +0 -74
- package/skills/references/skill-boundary-template.md +0 -71
- package/skills/references/skill-enhanced-template.md +0 -103
- package/skills/references/skill-reference-matrix.md +0 -62
- package/skills/security-audit/SKILL.md +0 -119
- package/skills/spec-refinement/SKILL.md +0 -149
- package/skills/technical-design/SKILL.md +0 -106
- package/skills/technical-design/references/solid-checklist.md +0 -199
- package/skills/test-design/SKILL.md +0 -92
- package/skills/workflow-router/SKILL.md +0 -86
package/codex-commands/README.md
CHANGED
|
@@ -1,23 +1,25 @@
|
|
|
1
|
-
# Pig Skills Codex Commands
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- `/
|
|
9
|
-
- `/design` -> `
|
|
10
|
-
- `/build` -> `
|
|
11
|
-
- `/review` -> `code-review`
|
|
12
|
-
- `/security` -> `security-
|
|
13
|
-
- `/perf` -> `performance-
|
|
14
|
-
- `/test` -> `test
|
|
15
|
-
- `/doc` -> `api-
|
|
16
|
-
- `/distill` -> `
|
|
17
|
-
- `/workflow` -> `
|
|
18
|
-
- `/kb` -> `
|
|
19
|
-
- `/init` -> `
|
|
20
|
-
- `/infra` -> `
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
1
|
+
# Pig Skills Codex Commands
|
|
2
|
+
|
|
3
|
+
这个命令包把 Codex 的 `/` 命令映射到当前仓库的 canonical skills,并尽量把每个命令停在正确的阶段。
|
|
4
|
+
|
|
5
|
+
## Commands
|
|
6
|
+
|
|
7
|
+
- `/analyze` -> `requirement-discovery`
|
|
8
|
+
- `/prd` -> `business-analysis`
|
|
9
|
+
- `/design` -> `architecture-design`
|
|
10
|
+
- `/build` -> `backend-development` / `frontend-development` / `database-change` / `bug-fix`
|
|
11
|
+
- `/review` -> `code-review`
|
|
12
|
+
- `/security` -> `security-review`
|
|
13
|
+
- `/perf` -> `performance-review`
|
|
14
|
+
- `/test` -> `unit-test`
|
|
15
|
+
- `/doc` -> `api-design`
|
|
16
|
+
- `/distill` -> `business-analysis`
|
|
17
|
+
- `/workflow` -> `ambiguity-detection`
|
|
18
|
+
- `/kb` -> `evidence-collector`
|
|
19
|
+
- `/init` -> `codebase-learning`
|
|
20
|
+
- `/infra` -> `deployment-guide`
|
|
21
|
+
|
|
22
|
+
## Notes
|
|
23
|
+
|
|
24
|
+
- 单个命令如果覆盖多个阶段,说明里会标出默认 skill 和可替换 skill。
|
|
25
|
+
- 命令包只负责路由,不把领域规则写成另一个规则库。
|
|
@@ -1,22 +1,21 @@
|
|
|
1
|
-
# /analyze
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /analyze
|
|
2
|
+
|
|
3
|
+
把模糊输入收敛成清晰的需求问题,再决定下一步是设计、分析还是继续澄清。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `requirement-discovery`
|
|
8
|
+
- 适用: 需求还不够清楚、信息不完整、边界不明确
|
|
9
|
+
- 不适用: 已经是明确实现任务,或者只是代码修改
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 先讲清楚目标、背景、约束和成功标准。
|
|
14
|
+
2. 标出已知信息、未知信息和必须确认的点。
|
|
15
|
+
3. 只做必要澄清,不提前进入设计或编码。
|
|
16
|
+
4. 如果输入已经足够稳定,再交给 `architecture-design` 或 `business-analysis`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要把模糊问题直接包装成实现计划。
|
|
21
|
+
- 不要跳过边界确认。
|
|
@@ -1,22 +1,22 @@
|
|
|
1
|
-
# /build
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /build
|
|
2
|
+
|
|
3
|
+
把已经确认的变更落成代码,默认面向后端,必要时切到前端、数据库或缺陷修复 skill。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 默认 skill: `backend-development`
|
|
8
|
+
- 可替换 skill: `frontend-development`、`database-change`、`bug-fix`
|
|
9
|
+
- 适用: 进入具体编码、补实现、修 bug
|
|
10
|
+
- 不适用: 需求还没确认,或者仍在做方案选择
|
|
11
|
+
|
|
12
|
+
## Workflow
|
|
13
|
+
|
|
14
|
+
1. 先确认输入来自 `requirement-discovery` 或 `architecture-design`。
|
|
15
|
+
2. 选定单一实现面,避免把不同层的工作混在一起。
|
|
16
|
+
3. 每次只推进一个可验证的小改动。
|
|
17
|
+
4. 完成后交给 `unit-test` 和 `code-review`。
|
|
18
|
+
|
|
19
|
+
## Guardrails
|
|
20
|
+
|
|
21
|
+
- 不要把设计争论留在实现阶段。
|
|
22
|
+
- 不要在没有验证的情况下继续堆改动。
|
|
@@ -1,22 +1,21 @@
|
|
|
1
|
-
# /design
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /design
|
|
2
|
+
|
|
3
|
+
把已经确认的需求收敛成可执行设计,重点是边界、依赖和方案选择。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `architecture-design`
|
|
8
|
+
- 适用: 需要定方案、定边界、定依赖关系
|
|
9
|
+
- 不适用: 需求还没确认,或者已经进入具体编码
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 承接 `requirement-discovery` 的结论。
|
|
14
|
+
2. 说明系统边界、依赖方向和关键 trade-off。
|
|
15
|
+
3. 只输出能指导实现的设计,不写实现细节。
|
|
16
|
+
4. 设计稳定后交给 `task-breakdown`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要把设计写成代码说明。
|
|
21
|
+
- 不要绕过关键决策直接进入实现。
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# /distill
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
- 对应 skill:`
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
1
|
+
# /distill
|
|
2
|
+
|
|
3
|
+
把业务事实和上下文提炼成可复用的业务理解。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill:`business-analysis`
|
|
8
|
+
- 适用:需要整理业务语义、术语、边界和约束
|
|
9
|
+
- 不适用:只是在写纯接口说明或纯实现说明
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 识别业务对象、规则和关键术语。
|
|
14
|
+
2. 归纳成稳定、可复用的业务结论。
|
|
15
|
+
3. 如果需要长期留档,再交给 `evidence-collector`。
|
|
16
|
+
4. 不要把命名本身直接当成领域模型结论。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要忽略业务规则冲突。
|
|
21
|
+
- 不要把实现细节伪装成业务知识。
|
|
@@ -1,22 +1,21 @@
|
|
|
1
|
-
# /doc
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /doc
|
|
2
|
+
|
|
3
|
+
把接口或契约说明收敛成可以落地的设计文档。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill:`api-design`
|
|
8
|
+
- 适用:接口契约、请求响应、兼容性、字段约束
|
|
9
|
+
- 不适用:纯业务讨论或纯实现任务
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 先确认要写的是接口、契约还是交付文档。
|
|
14
|
+
2. 把请求、响应、错误和兼容性讲清楚。
|
|
15
|
+
3. 只保留对实现和联调有帮助的信息。
|
|
16
|
+
4. 如果是部署或发布文档,再交给 `deployment-guide`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要把 API 文档写成泛化的产品说明。
|
|
21
|
+
- 不要忽略兼容性和错误语义。
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# /infra
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
- 对应 skill:`
|
|
8
|
-
- 适用:Docker Compose
|
|
9
|
-
- 不适用:业务需求分析
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2. 只拉起最小可用组合。
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
1
|
+
# /infra
|
|
2
|
+
|
|
3
|
+
准备和管理开发依赖、运行依赖或交付前置环境。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill:`deployment-guide`
|
|
8
|
+
- 适用:Docker Compose、依赖服务、开发联调环境、启动脚本
|
|
9
|
+
- 不适用:业务需求分析
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 先识别需要启动或配置的基础设施组件。
|
|
14
|
+
2. 只拉起最小可用组合。
|
|
15
|
+
3. 说明启动状态、常见失败点和恢复办法。
|
|
16
|
+
4. 不要把生产部署和本地开发环境混在一起。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要默认启动多余服务。
|
|
21
|
+
- 不要混淆生产环境和本地环境。
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
# /init
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
- 对应 skill:`
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3. 输出后续应该进入的 skill。
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
1
|
+
# /init
|
|
2
|
+
|
|
3
|
+
进入新代码库或新模块时,先完成基础认知和落地准备。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill:`codebase-learning`
|
|
8
|
+
- 适用:首次接手项目、初始化工作区、整理目录和基础约定
|
|
9
|
+
- 不适用:已经明确知道要改什么的实现任务
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 先确认是项目级还是模块级初始化。
|
|
14
|
+
2. 搞清楚目录结构、依赖入口和基本约定。
|
|
15
|
+
3. 输出后续应该进入的 skill。
|
|
16
|
+
4. 不要在这里直接做业务实现。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要跳过基础约定检查。
|
|
@@ -1,20 +1,21 @@
|
|
|
1
|
-
# /kb
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
- 对应 skill
|
|
8
|
-
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
1
|
+
# /kb
|
|
2
|
+
|
|
3
|
+
把已经验证过的事实沉淀成可复用、可追溯的知识。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `evidence-collector`
|
|
8
|
+
- 适用: 事实沉淀、证据整理、交接总结
|
|
9
|
+
- 不适用: 还没有证据,或者只是猜测
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 收集来源、证据和适用场景。
|
|
14
|
+
2. 区分事实、推断和未确认内容。
|
|
15
|
+
3. 只沉淀已经验证过的内容。
|
|
16
|
+
4. 如果还要整理业务语义,再交给 `business-analysis`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要把未验证内容写成知识。
|
|
21
|
+
- 不要把长文档当成证据。
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# /perf
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
|
|
1
|
+
# /perf
|
|
2
|
+
|
|
3
|
+
审查变更里的性能风险,重点看延迟、吞吐、内存和热点路径。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `performance-review`
|
|
8
|
+
- 适用: latency、throughput、memory、load、hot path
|
|
9
|
+
- 不适用: 只需要一般代码审查
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 找出具体慢路径和资源压力点。
|
|
14
|
+
2. 说明瓶颈类型和影响范围。
|
|
15
|
+
3. 只输出性能相关结论。
|
|
16
|
+
4. 必要时再交给 `code-review` 或 `backend-development`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要用“可能会慢”代替具体路径。
|
|
21
|
+
- 不要把性能审查变成实现重写。
|
|
@@ -1,22 +1,21 @@
|
|
|
1
|
-
# /prd
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /prd
|
|
2
|
+
|
|
3
|
+
把 PRD、brief 或产品说明整理成可交给设计阶段的业务结论。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `business-analysis`
|
|
8
|
+
- 适用: PRD、产品目标、业务规则、角色、业务流程整理
|
|
9
|
+
- 不适用: 已经明确要写实现方案
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 提炼业务目标、角色、流程和规则。
|
|
14
|
+
2. 区分需求、前提、验收和开放问题。
|
|
15
|
+
3. 用业务语言输出,不提前写技术实现。
|
|
16
|
+
4. 再交给 `architecture-design`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要把 PRD 直接改写成代码任务。
|
|
21
|
+
- 不要忽略业务冲突和未决问题。
|
|
@@ -1,22 +1,21 @@
|
|
|
1
|
-
# /review
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /review
|
|
2
|
+
|
|
3
|
+
审查已经提交的变更,重点找出可证实、可执行的质量问题。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `code-review`
|
|
8
|
+
- 适用: diff、PR、重构结果、需要审查的代码变更
|
|
9
|
+
- 不适用: 还没有实现内容可审
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 先看变更意图和影响面。
|
|
14
|
+
2. 找出正确性、可维护性和回归风险问题。
|
|
15
|
+
3. 只给能落地的审查结论。
|
|
16
|
+
4. 如果发现安全或性能问题,再切到对应 review skill。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要在 review 阶段重写实现。
|
|
21
|
+
- 不要把未验证的猜测写成结论。
|
|
@@ -1,22 +1,21 @@
|
|
|
1
|
-
# /security
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4.
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
1
|
+
# /security
|
|
2
|
+
|
|
3
|
+
审查变更里的认证、权限、数据暴露和滥用风险。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `security-review`
|
|
8
|
+
- 适用: auth、secret、用户输入、数据访问、信任边界
|
|
9
|
+
- 不适用: 只需要一般代码审查
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 找出可能被不可信输入触达的敏感路径。
|
|
14
|
+
2. 说明攻击面、影响对象和最小修复方式。
|
|
15
|
+
3. 只输出安全相关的审查结论。
|
|
16
|
+
4. 如果需要事实支撑,再交给 `evidence-collector`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要把安全审查变成实现重写。
|
|
21
|
+
- 不要把没有证据的风险写成 findings。
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# /test
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Route
|
|
6
|
-
|
|
7
|
-
- 对应 skill
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
1.
|
|
14
|
-
2.
|
|
15
|
-
3.
|
|
16
|
-
4. 必要时交给 `code-review` 或 `
|
|
17
|
-
|
|
18
|
-
## Guardrails
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
1
|
+
# /test
|
|
2
|
+
|
|
3
|
+
把验证目标落成可执行的测试方案和测试实现。
|
|
4
|
+
|
|
5
|
+
## Route
|
|
6
|
+
|
|
7
|
+
- 对应 skill: `unit-test`
|
|
8
|
+
- 适用: 单元测试、边界场景、回归保护
|
|
9
|
+
- 不适用: 需求还不清楚,或者只是想先跑一下
|
|
10
|
+
|
|
11
|
+
## Workflow
|
|
12
|
+
|
|
13
|
+
1. 先确认要验证的行为。
|
|
14
|
+
2. 补齐测试策略、用例和边界场景。
|
|
15
|
+
3. 输出可以直接执行的验证方案。
|
|
16
|
+
4. 必要时交给 `regression-check`、`code-review` 或 `backend-development`。
|
|
17
|
+
|
|
18
|
+
## Guardrails
|
|
19
|
+
|
|
20
|
+
- 不要跳过前置条件。
|
|
21
|
+
- 不要把“跑一次”当成完整验证。
|