@pigcloud/skills 1.0.3 → 1.0.5

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.
Files changed (54) hide show
  1. package/CHANGELOG.md +4 -4
  2. package/README.en.md +74 -83
  3. package/README.md +74 -85
  4. package/bin/cli.js +114 -89
  5. package/bin/postinstall.js +1 -1
  6. package/package.json +1 -1
  7. package/rules/skill-profile-map.json +5 -5
  8. package/rules/skill-profile-map.md +2 -2
  9. package/scripts/validate-skill-shapes.js +2 -1
  10. package/scripts/validate-skills.ps1 +6 -6
  11. package/scripts/validate-skills.sh +5 -5
  12. package/skills/api-docs/SKILL.md +2 -2
  13. package/skills/domain-modeling/SKILL.md +4 -4
  14. package/skills/extract-business-facts/SKILL.md +336 -0
  15. package/skills/extract-business-facts/scripts/write-knowledge-base.js +227 -0
  16. package/skills/knowledge-capture/SKILL.md +16 -7
  17. package/skills/project-bootstrap/SKILL.md +2 -2
  18. package/skills/references/business-fact-extraction.md +414 -0
  19. package/skills/references/golden-prompt-suite.js +64 -14
  20. package/skills/references/rule-loading-map.md +18 -18
  21. package/skills/references/skill-authoring-standard.md +2 -2
  22. package/skills/references/skill-boundary-template.md +56 -23
  23. package/skills/references/skill-enhanced-template.md +80 -30
  24. package/skills/references/skill-reference-matrix.md +21 -20
  25. package/skills/{spec-refinement → spec}/SKILL.md +19 -14
  26. package/skills/technical-design/SKILL.md +4 -4
  27. package/pig-cloud-skills-commands/.codex-plugin/plugin.json +0 -35
  28. package/pig-cloud-skills-commands/README.md +0 -24
  29. package/pig-cloud-skills-commands/commands/analyze.md +0 -21
  30. package/pig-cloud-skills-commands/commands/build.md +0 -21
  31. package/pig-cloud-skills-commands/commands/design.md +0 -21
  32. package/pig-cloud-skills-commands/commands/distill.md +0 -21
  33. package/pig-cloud-skills-commands/commands/doc.md +0 -21
  34. package/pig-cloud-skills-commands/commands/infra.md +0 -21
  35. package/pig-cloud-skills-commands/commands/init.md +0 -20
  36. package/pig-cloud-skills-commands/commands/kb.md +0 -20
  37. package/pig-cloud-skills-commands/commands/perf.md +0 -20
  38. package/pig-cloud-skills-commands/commands/prd.md +0 -21
  39. package/pig-cloud-skills-commands/commands/review.md +0 -21
  40. package/pig-cloud-skills-commands/commands/security.md +0 -21
  41. package/pig-cloud-skills-commands/commands/test.md +0 -21
  42. package/pig-cloud-skills-commands/commands/workflow.md +0 -20
  43. package/skills/product-intake/SKILL.md +0 -98
  44. package/skills/references/agent-personas.md +0 -34
  45. package/skills/references/flow-test-cases.md +0 -62
  46. package/skills/references/full-chain-replay-scenarios.md +0 -79
  47. package/skills/references/hooks.md +0 -67
  48. package/skills/references/negative-replay-scenarios.md +0 -49
  49. package/skills/references/prompt-replay-checklist.md +0 -128
  50. package/skills/references/requirements-separation-map.md +0 -71
  51. package/skills/references/slash-commands.md +0 -34
  52. package/skills/spec-refinement/references/ears-syntax.md +0 -127
  53. package/skills/spec-refinement/references/requirement-checklist.md +0 -139
  54. package/skills/spec-refinement/references/spec-workbook.md +0 -75
@@ -1,38 +1,71 @@
1
- # Skill 边界模板
1
+ # Skill Boundary Template
2
2
 
3
- 这是一份给基础 skill 复用的短模板。正文只保留可执行边界,不写长背景。
3
+ Use this template for simple routing, capture, or handoff skills where the body should stay very small. If the skill needs Quick Start, Inputs / Outputs, or Gotchas, it should probably use the enhanced template instead.
4
4
 
5
- ## 默认结构
5
+ ## Copyable SKILL.md skeleton
6
+
7
+ ```markdown
8
+ ---
9
+ name: example-skill
10
+ description: What the skill does and when to use it, written as one clear sentence.
11
+ lifecycle_stage: [routing|capture|scaffold]
12
+ rule_profile: [router|capture|scaffold]
13
+ dependencies:
14
+ - [only hard prerequisites]
15
+ triggers:
16
+ - [exact phrases or intent keywords]
17
+ inputs:
18
+ - [artifacts or facts the skill consumes]
19
+ outputs:
20
+ - [artifacts the skill must produce]
21
+ workflow:
22
+ - [step 1]
23
+ - [step 2]
24
+ - [step 3]
25
+ gates:
26
+ - [objective stop condition]
27
+ refs:
28
+ - [smallest needed reference file]
29
+ ---
30
+
31
+ # Example Skill
6
32
 
7
- ```text
8
33
  ## Purpose
9
- 一句话说明这个 skill 只负责什么。
34
+
35
+ Describe the skill in one sentence. Keep it narrow.
10
36
 
11
37
  ## Suitable / Unsuitable
12
- - Suitable: 该 skill 该接的输入类型
13
- - Unsuitable: skill 不该碰的工作
38
+
39
+ - Suitable: [what this skill should handle]
40
+ - Unsuitable: [what this skill should not handle]
14
41
 
15
42
  ## Workflow
16
- 1. 识别输入。
17
- 2. 执行本阶段工作。
18
- 3. 产出本阶段工件。
19
- 4. 交接到下一 skill。
43
+
44
+ 1. Identify the request type and boundary.
45
+ 2. Do the one bounded step.
46
+ 3. Produce the handoff artifact or stop.
20
47
 
21
48
  ## Replay Signals
22
- - Input signal: 什么输入会触发这个 skill。
23
- - Output to verify: 需要检查什么产物。
24
- - Stop signal: 什么行为说明越界了。
25
- - Handoff signal: 什么时候交给下一 skill
49
+
50
+ - Input signal: [what should trigger this skill]
51
+ - Output to verify: [what a correct output should include]
52
+ - Stop signal: [what means the skill has gone too far]
53
+ - Handoff signal: [when to pass control onward]
26
54
 
27
55
  ## Stop Rules
28
- - 停在本阶段。
29
- - 不做下一阶段的工作。
30
- - 不跳过规则加载。
56
+
57
+ - Stop after the bounded step is complete.
58
+ - Do not expand into adjacent skills.
59
+ - Do not add long background or policy details.
60
+
61
+ ## References
62
+
63
+ - [skill-authoring-standard.md](skill-authoring-standard.md)
64
+ - [skill-enhanced-template.md](skill-enhanced-template.md)
31
65
  ```
32
66
 
33
- ## 使用原则
67
+ ## When to choose the short template
34
68
 
35
- - `Replay Signals` 只写可验证的信号。
36
- - `Stop Rules` 只写硬边界。
37
- - 两者都要短,不要写成说明文。
38
- - 复杂 skill 需要升级到 [`skill-enhanced-template.md`](skill-enhanced-template.md)。
69
+ - Use it for routing-only, capture-only, or single-boundary skills.
70
+ - Keep replay signals and stop rules concise.
71
+ - Move any detailed guidance into `references/` only if it is truly needed.
@@ -1,53 +1,103 @@
1
- # Skill 增强模板
1
+ # Skill Enhanced Template
2
2
 
3
- 这是一份给复杂 skill 复用的增强模板。它在短边界模板之上补充快速启动、输入输出和常见坑。
3
+ Use this template for complex skills that need a clear boundary, explicit replay signals, and a small amount of reusable structure. Keep the final skill body short; move long explanations into `references/`.
4
4
 
5
- ## 默认结构
5
+ ## Copyable SKILL.md skeleton
6
+
7
+ ```markdown
8
+ ---
9
+ name: example-skill
10
+ description: What the skill does and when to use it, written as one clear sentence.
11
+ lifecycle_stage: [routing|refinement|analysis|implementation|testing|capture|scaffold]
12
+ rule_profile: [router|refinement|analysis|implementation|testing|capture|api|scaffold|security|performance|modeling|code]
13
+ dependencies:
14
+ - [only hard prerequisites]
15
+ triggers:
16
+ - [exact phrases or intent keywords]
17
+ inputs:
18
+ - [artifacts or facts the skill consumes]
19
+ outputs:
20
+ - [artifacts the skill must produce]
21
+ workflow:
22
+ - [step 1]
23
+ - [step 2]
24
+ - [step 3]
25
+ gates:
26
+ - [objective stop condition]
27
+ refs:
28
+ - [smallest needed reference file]
29
+ ---
30
+
31
+ # Example Skill
6
32
 
7
- ```text
8
33
  ## Purpose
9
- 一句话说明这个 skill 只负责什么。
34
+
35
+ Describe the skill in one sentence. State the outcome, not the implementation.
10
36
 
11
37
  ## Suitable / Unsuitable
12
- - Suitable: 该 skill 该接的输入类型
13
- - Unsuitable: skill 不该碰的工作
38
+
39
+ - Suitable: [what this skill should handle]
40
+ - Unsuitable: [what this skill should not handle]
14
41
 
15
42
  ## Quick Start
16
- - 一句话说明怎么进入这个 skill。
17
- - 一句话说明第一步看什么。
43
+
44
+ - State the first action the model should take.
45
+ - State the first artifact it should inspect or produce.
46
+ - State the handoff point if another skill should continue.
18
47
 
19
48
  ## Inputs / Outputs
20
- - Inputs: 这个 skill 需要什么输入。
21
- - Outputs: 这个 skill 要交付什么产物。
49
+
50
+ - Inputs:
51
+ - [input 1]
52
+ - [input 2]
53
+ - Outputs:
54
+ - [output 1]
55
+ - [output 2]
22
56
 
23
57
  ## Workflow
24
- 1. 识别输入。
25
- 2. 执行本阶段工作。
26
- 3. 产出本阶段工件。
27
- 4. 交接到下一 skill。
58
+
59
+ 1. Identify the request type and the boundary.
60
+ 2. Gather only the facts needed for this step.
61
+ 3. Produce the step-specific artifact.
62
+ 4. Hand off or stop when the boundary is reached.
28
63
 
29
64
  ## Replay Signals
30
- - Input signal: 什么输入会触发这个 skill。
31
- - Output to verify: 需要检查什么产物。
32
- - Stop signal: 什么行为说明越界了。
33
- - Handoff signal: 什么时候交给下一 skill
65
+
66
+ - Input signal: [what should trigger this skill]
67
+ - Output to verify: [what a correct output should include]
68
+ - Stop signal: [what means the skill has gone too far]
69
+ - Handoff signal: [when to pass control onward]
34
70
 
35
71
  ## Gotchas
36
- - 该 skill 最容易犯的 2-4 个错误。
72
+
73
+ - [common failure mode 1]
74
+ - [common failure mode 2]
75
+ - [common failure mode 3]
37
76
 
38
77
  ## Stop Rules
39
- - 停在本阶段。
40
- - 不做下一阶段的工作。
41
- - 不跳过规则加载。
78
+
79
+ - Stop when the step-specific artifact is complete.
80
+ - Do not cross into the next skill's work.
81
+ - Do not add unrelated context or policy details.
42
82
 
43
83
  ## References
44
- - 该 skill 依赖的最小 references。
84
+
85
+ - [skill-authoring-standard.md](skill-authoring-standard.md)
86
+ - [skill-boundary-template.md](skill-boundary-template.md)
87
+ - [rule-loading-map.md](rule-loading-map.md)
45
88
  ```
46
89
 
47
- ## 使用原则
90
+ ## How to use this template
91
+
92
+ - Start with the `description` field. It is the primary trigger.
93
+ - Keep `dependencies` for hard prerequisites only.
94
+ - Put exact trigger phrases in `triggers`.
95
+ - Use `workflow` for the minimal reliable procedure.
96
+ - Put hard stop conditions in `gates` and `Stop Rules`.
97
+ - Keep detailed notes, examples, and variant-specific guidance in `references/`.
98
+
99
+ ## When to choose the enhanced template
48
100
 
49
- - 增强模板只给复杂 skill。
50
- - `Quick Start` 先帮模型快速进入任务。
51
- - `Inputs / Outputs` 让产出更稳定。
52
- - `Gotchas` 只写最常见、最容易越界的点。
53
- - `References` 只挂最小必要文件,不要堆背景。
101
+ - Use it for skills with multiple steps, strict boundaries, or meaningful handoff behavior.
102
+ - Use the short template in `skill-boundary-template.md` for simpler routing or capture tasks.
103
+ - Prefer the smallest possible reference set that still keeps the skill reliable.
@@ -1,25 +1,25 @@
1
- # Skill Reference Matrix
2
-
3
- ## Governance Context
4
-
5
- - Skills are the execution layer.
6
- - Rules are the constraint layer.
7
- - Workflow decides routing before execution.
8
- - For a broader system view, see [docs/agent-governance-overview.md](../../docs/agent-governance-overview.md).
9
-
10
- ## Borrowed Patterns
1
+ # Skill Reference Matrix
2
+
3
+ ## Governance Context
4
+
5
+ - Skills are the execution layer.
6
+ - Rules are the constraint layer.
7
+ - Workflow decides routing before execution.
8
+ - For a broader system view, see [docs/agent-governance-overview.md](../../docs/agent-governance-overview.md).
9
+
10
+ ## Borrowed Patterns
11
11
 
12
12
  | Source | Best Practice | Applies To |
13
13
  |---|---|---|
14
- | GitHub Spec Kit | Define before build | `spec-refinement` |
15
- | AWS Kiro EARS | Structured requirement writing | `spec-refinement` |
16
- | RIPER | Research / Innovate / Plan / Execute / Review | `spec-refinement` / routing context |
14
+ | GitHub Spec Kit | Define before build | `spec` |
15
+ | AWS Kiro EARS | Structured requirement writing | `spec` |
16
+ | RIPER | Research / Innovate / Plan / Execute / Review | `spec` / routing context |
17
17
  | Claude Code | Short, dense prompts | all skills |
18
18
  | open-code-review | Deterministic review plus agent review | `code-review` |
19
19
  | Skill Reviewer | Rubric-based review gate | `code-review` / `performance-check` / `security-review` |
20
20
  | Short boundary template | One screen for Purpose / Workflow / Replay Signals / Stop Rules | low-complexity skills |
21
- | Enhanced template | Add Quick Start / Inputs / Outputs / Gotchas / References | `spec-refinement` / `technical-design` / `feature-build` / `code-review` / `security-review` / `performance-check` |
22
- | Negative replay | Use counterexamples to verify stop boundaries | `spec-refinement` / `technical-design` / `feature-build` / `test-design` |
21
+ | Enhanced template | Add Quick Start / Inputs / Outputs / Gotchas / References | `spec` / `technical-design` / `feature-build` / `code-review` / `security-review` / `performance-check` |
22
+ | Negative replay | Use counterexamples to verify stop boundaries | `spec` / `technical-design` / `feature-build` / `test-design` |
23
23
  | Engineering delivery method | Decide complexity first, then split and implement inside `feature-build` | `feature-build` / `test-design` / `code-review` |
24
24
  | Engineering delivery template | One-page task card with facts, complexity, tasks, self-test, and validation | `feature-build` / `test-design` |
25
25
 
@@ -34,14 +34,14 @@
34
34
 
35
35
  ## Applicable Skills
36
36
 
37
- - `product-intake`: turn business intent into a PRD-ready brief
38
- - `spec-refinement`: turn approved requirements into an executable spec
37
+ - `spec`: turn product input, current facts, and implementation evidence into an executable spec
39
38
  - `technical-design`: turn complex changes into boundaries, dependencies, and rollback
40
39
  - `feature-build`: turn the confirmed spec into code
41
40
  - `test-design`: turn implementation results into a validation plan
42
- - `knowledge-capture`: turn product and engineering facts into requirements knowledge, realtime code facts, CodeWiki entries, and enterprise knowledge
41
+ - `knowledge-capture`: turn product and engineering facts into requirements knowledge, realtime code facts, CodeWiki entries, enterprise knowledge, and persisted knowledge-base packs
43
42
  - `api-docs`: turn confirmed interfaces into docs
44
43
  - `domain-modeling`: turn domain language into boundaries
44
+ - `extract-business-facts`: turn code-backed evidence into code facts, business facts, CodeWiki deltas, and file targets
45
45
  - `workflow-router`: route the stage
46
46
  - `code-review`: output generic review findings
47
47
  - `security-review`: output security findings
@@ -49,8 +49,8 @@
49
49
 
50
50
  ## Template Selection
51
51
 
52
- - Short template: `workflow-router`, `product-intake`, `knowledge-capture`, `api-docs`, `test-design`, `domain-modeling`, `project-bootstrap`, `environment-deploy`
53
- - Enhanced template: `spec-refinement`, `technical-design`, `feature-build`, `code-review`, `security-review`, `performance-check`
52
+ - Short template: `workflow-router`, `knowledge-capture`, `api-docs`, `test-design`, `domain-modeling`, `project-bootstrap`, `environment-deploy`
53
+ - Enhanced template: `spec`, `technical-design`, `feature-build`, `code-review`, `security-review`, `performance-check`, `extract-business-facts`
54
54
 
55
55
  ## Rules Loading
56
56
 
@@ -58,3 +58,4 @@
58
58
  - Use `skills/references/rule-loading-map.md` to decide which bundle to load.
59
59
  - Load the smallest bundle that covers the task.
60
60
  - Skills should reference at least one `rules` bundle when the task touches code.
61
+
@@ -1,16 +1,18 @@
1
1
  ---
2
- name: spec-refinement
3
- description: 通过对齐产品意图、项目事实、原型、实现事实和知识库证据,将已批准的需求细化为可执行规格,适用于仍存在验收缺口、约束或实现输入时
2
+ name: spec
3
+ description: Turn PRDs, prototypes, current project facts, implementation facts, and knowledge-base evidence into an executable engineering spec, task breakdown, and confirmation package; use when requirements must be clarified and aligned before design or implementation.
4
4
  lifecycle_stage: refinement
5
5
  rule_profile: refinement
6
6
  dependencies:
7
- - product-intake
7
+ - workflow-router
8
8
  triggers:
9
+ - spec
9
10
  - requirement clarification
10
11
  - acceptance gap
11
- - impact analysis
12
12
  - engineering spec
13
- - open question
13
+ - task breakdown
14
+ - execution direction
15
+ - confirmation package
14
16
  inputs:
15
17
  - approved product brief
16
18
  - current project facts
@@ -27,17 +29,17 @@ outputs:
27
29
  - implementation inputs
28
30
  - alignment notes
29
31
  - task breakdown plan
32
+ - conflict map
30
33
  - confirmation package
31
34
  workflow:
32
35
  - verify the product brief is approved
33
36
  - compare the brief with current project facts, prototype notes, implementation facts, and knowledge snippets
34
- - clarify boundaries, assumptions, and acceptance gaps
35
- - identify conflicts between intent and current facts
37
+ - clarify boundaries, assumptions, acceptance gaps, and fact conflicts
36
38
  - decide the task execution direction before splitting tasks
37
39
  - extract a task breakdown plan for user confirmation
38
40
  - define implementation-facing constraints and verification inputs
39
41
  - assemble a confirmation package for user sign-off
40
- - hand off to technical-design or feature-build only after confirmation
42
+ - hand off to `technical-design` or `feature-build` only after confirmation
41
43
  gates:
42
44
  - stop at spec clarity
43
45
  - do not restart PRD writing
@@ -55,16 +57,16 @@ refs:
55
57
  - rules/index.md
56
58
  ---
57
59
 
58
- # Spec Refinement
60
+ # Spec
59
61
 
60
62
  ## Purpose
61
63
 
62
- Turn approved product input into an executable spec for engineering. This skill ends when the scope is clear enough for design or implementation.
64
+ Turn product input, current project facts, and implementation evidence into an executable engineering spec.
63
65
 
64
66
  ## Suitable / Unsuitable
65
67
 
66
- - Suitable: requirement clarification, boundary checks, acceptance gaps, impact analysis, project-fact alignment, prototype alignment, implementation-fact alignment
67
- - Unsuitable: redoing the PRD, writing code, selecting rule bundles, skipping the rules bundle
68
+ - Suitable: requirement clarification, boundary checks, acceptance gaps, impact analysis, project-fact alignment, prototype alignment, implementation-fact alignment, task breakdown, user confirmation
69
+ - Unsuitable: redoing the PRD, writing code, selecting rule bundles, skipping the rules bundle, starting implementation before confirmation
68
70
 
69
71
  ## Quick Start
70
72
 
@@ -73,7 +75,7 @@ Turn approved product input into an executable spec for engineering. This skill
73
75
  - Decide the task execution direction before extracting the task breakdown plan.
74
76
  - Extract the task breakdown plan so feature-build can break the work into small tasks.
75
77
  - Convert the result into an executable spec that AI can follow without re-interpreting the PRD.
76
- - Package the spec, task plan, and acceptance criteria into a confirmation package before execution starts.
78
+ - Package the spec, task plan, and acceptance criteria into a confirmation package before execution starts.
77
79
  - If scope is still unstable, stop and keep the output at spec clarity.
78
80
 
79
81
  ## Inputs / Outputs
@@ -138,6 +140,9 @@ Turn approved product input into an executable spec for engineering. This skill
138
140
  ## References
139
141
 
140
142
  - `skills/references/requirements-separation-map.md`
143
+ - `skills/references/project-requirement-alignment.md`
144
+ - `skills/references/engineering-delivery-method.md`
145
+ - `skills/references/engineering-delivery-template.md`
141
146
  - `skills/references/rule-loading-map.md`
142
- - `skills/references/flow-test-cases.md`
143
147
  - `rules/index.md`
148
+
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: technical-design
3
- description: 当模块、接口或依赖仍需决策时,在稳定规格基础上梳理架构与实现边界
3
+ description: 当模块、接口或依赖仍需决策时,在稳定规格基础上梳理架构与实现边界
4
4
  lifecycle_stage: design
5
5
  rule_profile: analysis
6
6
  dependencies:
7
- - spec-refinement
7
+ - spec
8
8
  triggers:
9
9
  - architecture decision
10
10
  - module split
@@ -54,7 +54,7 @@ Turn a stable spec into concrete architecture and implementation boundaries.
54
54
  - Start from the stable spec and isolate the decisions that affect boundaries or dependencies.
55
55
  - Load the smallest rules bundle that matches the current task context.
56
56
  - Turn design choices into implementation constraints, not code.
57
- - If the spec is still unstable, stop and return to `spec-refinement`.
57
+ - If the spec is still unstable, stop and return to `spec`.
58
58
 
59
59
  ## Inputs / Outputs
60
60
 
@@ -72,7 +72,7 @@ Turn a stable spec into concrete architecture and implementation boundaries.
72
72
 
73
73
  1. Confirm the spec is stable enough for design work.
74
74
  2. Define boundaries, dependencies, and interfaces.
75
- 3. Route scope gaps back to `spec-refinement` instead of forcing design decisions.
75
+ 3. Route scope gaps back to `spec` instead of forcing design decisions.
76
76
  4. Map design decisions to the rules bundle.
77
77
  5. Produce implementation constraints for `feature-build`.
78
78
 
@@ -1,35 +0,0 @@
1
- {
2
- "name": "pig-cloud-skills-commands",
3
- "version": "1.1.0",
4
- "description": "Codex command pack for Pig Cloud skills. Exposes direct command-style entrypoints such as /prd and /analyze so the skill pack can be invoked without memorizing raw skill names.",
5
- "author": {
6
- "name": "pig-cloud-framework",
7
- "url": "https://gitee.com/rebys/pig-skills"
8
- },
9
- "homepage": "https://gitee.com/rebys/pig-skills",
10
- "repository": "https://gitee.com/rebys/pig-skills.git",
11
- "license": "MIT",
12
- "keywords": [
13
- "codex",
14
- "commands",
15
- "skills",
16
- "prd",
17
- "analysis"
18
- ],
19
- "interface": {
20
- "displayName": "Pig Cloud Skills Commands",
21
- "shortDescription": "Command-style entrypoints for the Pig Cloud skill pack",
22
- "longDescription": "Provides Codex command files like /prd, /analyze, /design, /build, and /kb that route into the Pig Cloud skills pack with stable, low-token prompts and clear execution gates.",
23
- "developerName": "pig-cloud-framework",
24
- "category": "Productivity",
25
- "capabilities": [
26
- "Interactive",
27
- "Read"
28
- ],
29
- "websiteURL": "https://gitee.com/rebys/pig-skills",
30
- "defaultPrompt": [
31
- "Use /prd, /analyze, /design, /build, /review, or /kb to route work into the correct Pig Cloud skill"
32
- ],
33
- "brandColor": "#2563EB"
34
- }
35
- }
@@ -1,24 +0,0 @@
1
- # Pig Cloud Skills Commands
2
-
3
- 本插件提供 Pig Cloud skill pack 的命令式入口。
4
-
5
- 先安装 skill pack,再重启 Codex,命令才会生效。
6
-
7
- ## Commands
8
-
9
- - `/prd` -> `product-intake`
10
- - `/analyze` -> `spec-refinement`
11
- - `/design` -> `technical-design`
12
- - `/build` -> `feature-build`
13
- - `/review` -> `code-review`
14
- - `/security` -> `security-review`
15
- - `/perf` -> `performance-check`
16
- - `/test` -> `test-design`
17
- - `/doc` -> `api-docs`
18
- - `/distill` -> `domain-modeling`
19
- - `/workflow` -> `workflow-router`
20
- - `/kb` -> `knowledge-capture`
21
- - `/init` -> `project-bootstrap`
22
- - `/infra` -> `environment-deploy`
23
-
24
- 这些命令页保持短小,是为了让 Codex 更快定位到正确的 skill。
@@ -1,21 +0,0 @@
1
- # /analyze
2
-
3
- 把已经确认的需求收敛成研发可执行的规格。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`spec-refinement`
8
- - 适用:需求拆解、边界梳理、依赖确认、验收标准补全
9
- - 不适用:还没收口的产品讨论
10
-
11
- ## Workflow
12
-
13
- 1. 先确认输入来自 `product-intake` 的收口结果,或至少已经完成初步收敛。
14
- 2. 把目标、边界、依赖、约束和验收条件整理成可执行规格。
15
- 3. 输出研发分析结果,明确后续实现所需输入。
16
- 4. 必要时交给 `technical-design` 或 `knowledge-capture`。
17
-
18
- ## Guardrails
19
-
20
- - 不直接写实现代码。
21
- - 不把未确认假设当结论。
@@ -1,21 +0,0 @@
1
- # /build
2
-
3
- 按方案规范实现已经收口的需求。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`feature-build`
8
- - 适用:开发实现、增量改造、接口联动、落地代码
9
- - 不适用:需求还没收口,或者设计还没稳定
10
-
11
- ## Workflow
12
-
13
- 1. 先确认输入来自 `spec-refinement` 或 `technical-design`。
14
- 2. 按分层、事务和返回值规范实现。
15
- 3. 保持改动最小,优先可验证。
16
- 4. 交给 `test-design` 和 `code-review` 收口。
17
-
18
- ## Guardrails
19
-
20
- - 不绕过架构约束。
21
- - 不把临时修补当作最终实现。
@@ -1,21 +0,0 @@
1
- # /design
2
-
3
- 把已经收口的需求补成可实现的技术方案。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`technical-design`
8
- - 适用:架构选型、模块拆分、接口设计、数据流设计、实现前补充设计
9
- - 不适用:尚未收口的需求讨论
10
-
11
- ## Workflow
12
-
13
- 1. 读取 `spec-refinement` 的结论。
14
- 2. 拆分模块、接口、数据结构、事务边界和异常路径。
15
- 3. 输出方案草图、关键决策和落地顺序。
16
- 4. 给 `feature-build` 准备实现输入。
17
-
18
- ## Guardrails
19
-
20
- - 不重新发散需求范围。
21
- - 不跳过架构约束直接写实现。
@@ -1,21 +0,0 @@
1
- # /distill
2
-
3
- 把业务事实提炼成可复用的领域知识。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`domain-modeling`
8
- - 适用:领域边界、实体关系、核心概念、规则沉淀
9
- - 不适用:纯接口变更说明
10
-
11
- ## Workflow
12
-
13
- 1. 识别业务对象、边界和核心规则。
14
- 2. 抽取实体、关系、状态和约束。
15
- 3. 输出可复用的领域索引和冲突点。
16
- 4. 不把命名本身当作领域模型。
17
-
18
- ## Guardrails
19
-
20
- - 不忽略规则冲突。
21
- - 不把实现细节冒充领域知识。
@@ -1,21 +0,0 @@
1
- # /doc
2
-
3
- 把接口和变更整理成可对接的文档。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`api-docs`
8
- - 适用:接口说明、变更说明、联调说明、同步文档
9
- - 不适用:纯代码审查
10
-
11
- ## Workflow
12
-
13
- 1. 先确认接口边界和输入输出。
14
- 2. 提炼请求、响应、错误码和调用顺序。
15
- 3. 输出可联调的文档草案。
16
- 4. 变更后同步到知识沉淀。
17
-
18
- ## Guardrails
19
-
20
- - 不遗漏错误返回和约束。
21
- - 不把空泛说明当成文档交付。
@@ -1,21 +0,0 @@
1
- # /infra
2
-
3
- 准备或管理开发依赖的基础设施。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`environment-deploy`
8
- - 适用:Docker Compose、依赖服务启动、开发联调环境准备
9
- - 不适用:业务需求分析
10
-
11
- ## Workflow
12
-
13
- 1. 识别需要启动的基础设施组件。
14
- 2. 只拉起最小可用组合。
15
- 3. 输出启动状态和常见失败点。
16
- 4. 不把生产部署和本地开发混在一起。
17
-
18
- ## Guardrails
19
-
20
- - 不默认启动多余服务。
21
- - 不混淆生产环境和本地环境。
@@ -1,20 +0,0 @@
1
- # /init
2
-
3
- 初始化项目或模块脚手架。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`project-bootstrap`
8
- - 适用:新建项目、模块初始化、标准目录生成
9
- - 不适用:业务分析
10
-
11
- ## Workflow
12
-
13
- 1. 确认初始化对象是项目还是模块。
14
- 2. 生成标准目录、基础配置和依赖边界。
15
- 3. 输出后续应该进入的 skill。
16
- 4. 不触碰具体业务逻辑。
17
-
18
- ## Guardrails
19
-
20
- - 不跳过基础配置检查。
@@ -1,20 +0,0 @@
1
- # /kb
2
-
3
- 把项目事实整理成可检索、可复用、可过期治理的知识中心。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`knowledge-capture`
8
- - 适用:项目概览、模块索引、领域知识、方案沉淀、交接归档
9
-
10
- ## Workflow
11
-
12
- 1. 收集事实、来源、适用场景和限制条件。
13
- 2. 分类沉淀到项目、模块、领域、方案或协作索引。
14
- 3. 标明哪些内容可复用,哪些内容应过期清理。
15
- 4. 让归档结果反哺后续分析和实现。
16
-
17
- ## Guardrails
18
-
19
- - 不堆文档。
20
- - 不把未经验证的信息当知识沉淀。