cokit-cli 1.2.0 → 1.2.3
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/README.md +47 -36
- package/agents/brainstormer.agent.md +1 -1
- package/agents/debugger.agent.md +1 -1
- package/agents/docs-manager.agent.md +2 -2
- package/agents/git-manager.agent.md +5 -5
- package/agents/planner.agent.md +3 -3
- package/agents/researcher.agent.md +0 -1
- package/agents/scout.agent.md +9 -9
- package/agents/ui-ux-designer.agent.md +0 -1
- package/collections/ck-orchestration.collection.yml +2 -2
- package/docs/README.md +8 -8
- package/docs/codebase-summary.md +19 -19
- package/docs/cokit-commands-usage-guide.md +42 -43
- package/docs/cokit-comprehensive-mapping-guide.md +15 -15
- package/docs/cokit-slides.md +6 -6
- package/docs/cokit-sync-and-maintenance-guide.md +45 -45
- package/docs/cokit-team-presentation.md +11 -11
- package/docs/copilot-processing-flow.md +11 -11
- package/docs/guide-next-steps-speckit-cokit-implementation.md +1 -1
- package/docs/migration-guide.md +9 -9
- package/docs/project-overview-pdr.md +3 -3
- package/docs/project-roadmap.md +20 -11
- package/docs/system-architecture.md +6 -6
- package/package.json +1 -1
- package/prompts/ck-ask.prompt.md +3 -2
- package/prompts/ck-bootstrap.prompt.md +26 -32
- package/prompts/ck-brainstorm.prompt.md +4 -3
- package/prompts/ck-cook.prompt.md +5 -4
- package/prompts/ck-debug.prompt.md +4 -3
- package/prompts/ck-docs.prompt.md +4 -3
- package/prompts/ck-fix-ci.prompt.md +46 -0
- package/prompts/ck-fix-fast.prompt.md +44 -0
- package/prompts/ck-fix-hard.prompt.md +60 -0
- package/prompts/ck-fix-logs.prompt.md +53 -0
- package/prompts/ck-fix-test.prompt.md +47 -0
- package/prompts/ck-fix-types.prompt.md +29 -0
- package/prompts/ck-fix-ui.prompt.md +50 -0
- package/prompts/ck-fix.prompt.md +13 -15
- package/prompts/ck-git.prompt.md +2 -2
- package/prompts/ck-help.prompt.md +8 -6
- package/prompts/ck-journal.prompt.md +5 -3
- package/prompts/ck-plan-fast.prompt.md +26 -5
- package/prompts/ck-plan-hard.prompt.md +30 -9
- package/prompts/ck-plan-validate.prompt.md +209 -0
- package/prompts/ck-plan.prompt.md +49 -12
- package/prompts/ck-preview.prompt.md +16 -32
- package/prompts/ck-review.prompt.md +10 -11
- package/prompts/ck-scout.prompt.md +5 -4
- package/prompts/ck-simplify.prompt.md +3 -3
- package/prompts/ck-spec-analyze.prompt.md +9 -11
- package/prompts/ck-spec-checklist.prompt.md +7 -9
- package/prompts/ck-spec-clarify.prompt.md +8 -15
- package/prompts/ck-spec-constitution.prompt.md +6 -11
- package/prompts/ck-spec-implement.prompt.md +7 -10
- package/prompts/ck-spec-plan.prompt.md +5 -18
- package/prompts/ck-spec-specify.prompt.md +8 -17
- package/prompts/ck-spec-tasks.prompt.md +4 -16
- package/prompts/ck-test.prompt.md +5 -3
- package/prompts/ck-watzup.prompt.md +4 -2
- package/skills/INSTALLATION.md +3 -3
- package/skills/README.md +12 -34
- package/skills/agent-browser/SKILL.md +0 -1
- package/skills/agent_skills_spec.md +2 -2
- package/skills/backend-development/SKILL.md +0 -2
- package/skills/brainstorm/SKILL.md +7 -9
- package/skills/code-review/SKILL.md +9 -9
- package/skills/code-review/references/code-review-reception.md +1 -1
- package/skills/code-review/references/requesting-code-review.md +7 -7
- package/skills/common/api_key_helper.py +8 -8
- package/skills/context-engineering/SKILL.md +3 -4
- package/skills/context-engineering/references/context-degradation.md +2 -2
- package/skills/context-engineering/references/runtime-awareness.md +6 -6
- package/skills/cook/README.md +2 -2
- package/skills/cook/SKILL.md +3 -4
- package/skills/cook/references/agent-patterns.md +75 -0
- package/skills/cook/references/review-cycle.md +2 -2
- package/skills/cook/references/workflow-steps.md +6 -6
- package/skills/databases/SKILL.md +0 -1
- package/skills/databases/scripts/db_migrate.py +2 -2
- package/skills/databases/scripts/db_performance_check.py +2 -2
- package/skills/debug/SKILL.md +0 -1
- package/skills/devops/SKILL.md +0 -2
- package/skills/devops/scripts/docker_optimize.py +2 -2
- package/skills/docs-seeker/SKILL.md +0 -1
- package/skills/docs-seeker/package.json +1 -1
- package/skills/docs-seeker/scripts/utils/env-loader.js +2 -2
- package/skills/fix/SKILL.md +10 -11
- package/skills/fix/references/mode-selection.md +11 -27
- package/skills/fix/references/parallel-exploration.md +9 -9
- package/skills/fix/references/review-cycle.md +3 -3
- package/skills/fix/references/skill-activation-matrix.md +3 -3
- package/skills/fix/references/workflow-deep.md +11 -11
- package/skills/fix/references/workflow-quick.md +5 -5
- package/skills/fix/references/workflow-standard.md +12 -12
- package/skills/frontend-design/SKILL.md +2 -3
- package/skills/frontend-design/references/workflow-describe.md +1 -1
- package/skills/frontend-design/references/workflow-quick.md +1 -1
- package/skills/frontend-design/references/workflow-screenshot.md +1 -1
- package/skills/git/SKILL.md +2 -3
- package/skills/git/references/commit-standards.md +2 -2
- package/skills/git/references/workflow-commit.md +1 -1
- package/skills/git/references/workflow-merge.md +1 -1
- package/skills/git/references/workflow-pr.md +1 -1
- package/skills/git/references/workflow-push.md +1 -1
- package/skills/install.ps1 +5 -5
- package/skills/install.sh +2 -2
- package/skills/mcp-management/README.md +8 -8
- package/skills/mcp-management/SKILL.md +9 -9
- package/skills/mcp-management/references/gemini-cli-integration.md +2 -2
- package/skills/mcp-management/scripts/.env.example +2 -2
- package/skills/planning/SKILL.md +4 -5
- package/skills/planning/references/output-standards.md +1 -1
- package/skills/planning/references/plan-organization.md +1 -1
- package/skills/problem-solving/SKILL.md +1 -2
- package/skills/repomix/SKILL.md +2 -2
- package/skills/repomix/references/usage-patterns.md +2 -2
- package/skills/research/SKILL.md +0 -1
- package/skills/scout/SKILL.md +9 -10
- package/skills/scout/references/external-scouting.md +10 -10
- package/skills/scout/references/internal-scouting.md +9 -9
- package/skills/sequential-thinking/README.md +3 -3
- package/skills/sequential-thinking/SKILL.md +0 -2
- package/skills/sequential-thinking/package.json +1 -1
- package/skills/ui-styling/SKILL.md +0 -2
- package/skills/web-testing/SKILL.md +0 -2
- package/templates/repo/.github/agents/brainstormer.agent.md +1 -1
- package/templates/repo/.github/agents/debugger.agent.md +1 -1
- package/templates/repo/.github/agents/docs-manager.agent.md +2 -2
- package/templates/repo/.github/agents/git-manager.agent.md +5 -5
- package/templates/repo/.github/agents/planner.agent.md +3 -3
- package/templates/repo/.github/agents/researcher.agent.md +0 -1
- package/templates/repo/.github/agents/scout.agent.md +9 -9
- package/templates/repo/.github/agents/ui-ux-designer.agent.md +0 -1
- package/templates/repo/.github/collections/ck-orchestration.collection.yml +2 -2
- package/templates/repo/.github/prompts/ck-ask.prompt.md +3 -2
- package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +26 -32
- package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-cook.prompt.md +5 -4
- package/templates/repo/.github/prompts/ck-debug.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-docs.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-fix-ci.prompt.md +46 -0
- package/templates/repo/.github/prompts/ck-fix-fast.prompt.md +44 -0
- package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +60 -0
- package/templates/repo/.github/prompts/ck-fix-logs.prompt.md +53 -0
- package/templates/repo/.github/prompts/ck-fix-test.prompt.md +47 -0
- package/templates/repo/.github/prompts/ck-fix-types.prompt.md +29 -0
- package/templates/repo/.github/prompts/ck-fix-ui.prompt.md +50 -0
- package/templates/repo/.github/prompts/ck-fix.prompt.md +13 -15
- package/templates/repo/.github/prompts/ck-git.prompt.md +2 -2
- package/templates/repo/.github/prompts/ck-help.prompt.md +8 -6
- package/templates/repo/.github/prompts/ck-journal.prompt.md +5 -3
- package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +26 -5
- package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +30 -9
- package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +209 -0
- package/templates/repo/.github/prompts/ck-plan.prompt.md +49 -12
- package/templates/repo/.github/prompts/ck-preview.prompt.md +16 -32
- package/templates/repo/.github/prompts/ck-review.prompt.md +10 -11
- package/templates/repo/.github/prompts/ck-scout.prompt.md +5 -4
- package/templates/repo/.github/prompts/ck-simplify.prompt.md +3 -3
- package/templates/repo/.github/prompts/ck-spec-analyze.prompt.md +9 -11
- package/templates/repo/.github/prompts/ck-spec-checklist.prompt.md +7 -9
- package/templates/repo/.github/prompts/ck-spec-clarify.prompt.md +8 -15
- package/templates/repo/.github/prompts/ck-spec-constitution.prompt.md +6 -11
- package/templates/repo/.github/prompts/ck-spec-implement.prompt.md +7 -10
- package/templates/repo/.github/prompts/ck-spec-plan.prompt.md +5 -18
- package/templates/repo/.github/prompts/ck-spec-specify.prompt.md +7 -17
- package/templates/repo/.github/prompts/ck-spec-tasks.prompt.md +4 -16
- package/templates/repo/.github/prompts/ck-test.prompt.md +5 -3
- package/templates/repo/.github/prompts/ck-watzup.prompt.md +4 -2
- package/templates/repo/.github/skills/INSTALLATION.md +3 -3
- package/templates/repo/.github/skills/README.md +12 -34
- package/templates/repo/.github/skills/agent-browser/SKILL.md +0 -1
- package/templates/repo/.github/skills/agent_skills_spec.md +2 -2
- package/templates/repo/.github/skills/backend-development/SKILL.md +0 -2
- package/templates/repo/.github/skills/brainstorm/SKILL.md +7 -9
- package/templates/repo/.github/skills/code-review/SKILL.md +9 -9
- package/templates/repo/.github/skills/code-review/references/code-review-reception.md +1 -1
- package/templates/repo/.github/skills/code-review/references/requesting-code-review.md +7 -7
- package/templates/repo/.github/skills/common/api_key_helper.py +8 -8
- package/templates/repo/.github/skills/context-engineering/SKILL.md +3 -4
- package/templates/repo/.github/skills/context-engineering/references/context-degradation.md +2 -2
- package/templates/repo/.github/skills/context-engineering/references/runtime-awareness.md +6 -6
- package/templates/repo/.github/skills/cook/README.md +2 -2
- package/templates/repo/.github/skills/cook/SKILL.md +3 -4
- package/templates/repo/.github/skills/cook/references/agent-patterns.md +75 -0
- package/templates/repo/.github/skills/cook/references/review-cycle.md +2 -2
- package/templates/repo/.github/skills/cook/references/workflow-steps.md +6 -6
- package/templates/repo/.github/skills/databases/SKILL.md +0 -1
- package/templates/repo/.github/skills/databases/scripts/db_migrate.py +2 -2
- package/templates/repo/.github/skills/databases/scripts/db_performance_check.py +2 -2
- package/templates/repo/.github/skills/debug/SKILL.md +0 -1
- package/templates/repo/.github/skills/devops/SKILL.md +0 -2
- package/templates/repo/.github/skills/devops/scripts/docker_optimize.py +2 -2
- package/templates/repo/.github/skills/docs-seeker/SKILL.md +0 -1
- package/templates/repo/.github/skills/docs-seeker/package.json +1 -1
- package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js +2 -2
- package/templates/repo/.github/skills/fix/SKILL.md +10 -11
- package/templates/repo/.github/skills/fix/references/mode-selection.md +11 -27
- package/templates/repo/.github/skills/fix/references/parallel-exploration.md +9 -9
- package/templates/repo/.github/skills/fix/references/review-cycle.md +3 -3
- package/templates/repo/.github/skills/fix/references/skill-activation-matrix.md +3 -3
- package/templates/repo/.github/skills/fix/references/workflow-deep.md +11 -11
- package/templates/repo/.github/skills/fix/references/workflow-quick.md +5 -5
- package/templates/repo/.github/skills/fix/references/workflow-standard.md +12 -12
- package/templates/repo/.github/skills/frontend-design/SKILL.md +2 -3
- package/templates/repo/.github/skills/frontend-design/references/workflow-describe.md +1 -1
- package/templates/repo/.github/skills/frontend-design/references/workflow-quick.md +1 -1
- package/templates/repo/.github/skills/frontend-design/references/workflow-screenshot.md +1 -1
- package/templates/repo/.github/skills/git/SKILL.md +2 -3
- package/templates/repo/.github/skills/git/references/commit-standards.md +2 -2
- package/templates/repo/.github/skills/git/references/workflow-commit.md +1 -1
- package/templates/repo/.github/skills/git/references/workflow-merge.md +1 -1
- package/templates/repo/.github/skills/git/references/workflow-pr.md +1 -1
- package/templates/repo/.github/skills/git/references/workflow-push.md +1 -1
- package/templates/repo/.github/skills/install.ps1 +5 -5
- package/templates/repo/.github/skills/install.sh +2 -2
- package/templates/repo/.github/skills/mcp-management/README.md +8 -8
- package/templates/repo/.github/skills/mcp-management/SKILL.md +9 -9
- package/templates/repo/.github/skills/mcp-management/references/gemini-cli-integration.md +2 -2
- package/templates/repo/.github/skills/mcp-management/scripts/.env.example +2 -2
- package/templates/repo/.github/skills/planning/SKILL.md +4 -5
- package/templates/repo/.github/skills/planning/references/output-standards.md +1 -1
- package/templates/repo/.github/skills/planning/references/plan-organization.md +1 -1
- package/templates/repo/.github/skills/problem-solving/SKILL.md +1 -2
- package/templates/repo/.github/skills/repomix/SKILL.md +2 -2
- package/templates/repo/.github/skills/repomix/references/usage-patterns.md +2 -2
- package/templates/repo/.github/skills/research/SKILL.md +0 -1
- package/templates/repo/.github/skills/scout/SKILL.md +9 -10
- package/templates/repo/.github/skills/scout/references/external-scouting.md +10 -10
- package/templates/repo/.github/skills/scout/references/internal-scouting.md +9 -9
- package/templates/repo/.github/skills/sequential-thinking/README.md +3 -3
- package/templates/repo/.github/skills/sequential-thinking/SKILL.md +0 -2
- package/templates/repo/.github/skills/sequential-thinking/package.json +1 -1
- package/templates/repo/.github/skills/ui-styling/SKILL.md +0 -2
- package/templates/repo/.github/skills/web-testing/SKILL.md +0 -2
- package/docs/cokit-instruction-guide.html +0 -3004
- package/docs/images/cokit-command-finder-final.png +0 -0
- package/docs/images/cokit-highlight-fix.png +0 -0
- package/docs/images/cokit-highlight-test.png +0 -0
- package/prompts/ck-spec-taskstoissues.prompt.md +0 -48
- package/skills/cook/references/subagent-patterns.md +0 -75
- package/templates/repo/.github/prompts/ck-spec-taskstoissues.prompt.md +0 -48
- package/templates/repo/.github/skills/cook/references/subagent-patterns.md +0 -75
|
@@ -5,29 +5,27 @@ argument-hint: 'Path to markdown file or directory'
|
|
|
5
5
|
tools: ['execute/runInTerminal', 'execute/getTerminalOutput']
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
Universal viewer
|
|
8
|
+
Universal viewer - pass ANY path and see it rendered nicely.
|
|
9
9
|
|
|
10
10
|
## Usage
|
|
11
11
|
|
|
12
|
-
- `/ck
|
|
13
|
-
- `/ck
|
|
14
|
-
- `/ck
|
|
12
|
+
- `/ck-preview <file.md>` - View markdown file in novel-reader UI
|
|
13
|
+
- `/ck-preview <directory/>` - Browse directory contents
|
|
14
|
+
- `/ck-preview --stop` - Stop running server
|
|
15
15
|
|
|
16
16
|
## Examples
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
|
-
/ck
|
|
20
|
-
/ck
|
|
21
|
-
/ck
|
|
22
|
-
/ck
|
|
23
|
-
/ck
|
|
19
|
+
/ck-preview plans/my-plan/ck-plan.md # View markdown file
|
|
20
|
+
/ck-preview plans/ # Browse plans directory
|
|
21
|
+
/ck-preview docs/ # Browse docs directory
|
|
22
|
+
/ck-preview any/path/to/file.md # View any markdown file
|
|
23
|
+
/ck-preview any/path/ # Browse any directory
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
## Execution
|
|
27
27
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
The skill is located at `$HOME/.copilot/skills/markdown-novel-viewer/`.
|
|
28
|
+
Run the server using `#tool:execute/runInTerminal`. The skill is located at `$HOME/.copilot/skills/markdown-novel-viewer/`.
|
|
31
29
|
|
|
32
30
|
### Stop Server
|
|
33
31
|
|
|
@@ -39,11 +37,11 @@ node $HOME/.copilot/skills/markdown-novel-viewer/scripts/server.cjs --stop
|
|
|
39
37
|
|
|
40
38
|
### Start Server
|
|
41
39
|
|
|
42
|
-
Otherwise, run the `markdown-novel-viewer` server
|
|
40
|
+
Otherwise, run the `markdown-novel-viewer` server with `--foreground` flag:
|
|
43
41
|
|
|
44
42
|
```bash
|
|
45
43
|
# Determine if path is file or directory
|
|
46
|
-
INPUT_PATH="{
|
|
44
|
+
INPUT_PATH="${input}"
|
|
47
45
|
if [[ -d "$INPUT_PATH" ]]; then
|
|
48
46
|
# Directory mode - browse
|
|
49
47
|
node $HOME/.copilot/skills/markdown-novel-viewer/scripts/server.cjs \
|
|
@@ -61,25 +59,10 @@ else
|
|
|
61
59
|
fi
|
|
62
60
|
```
|
|
63
61
|
|
|
64
|
-
**Critical:** When calling the Bash tool:
|
|
65
|
-
- Set `run_in_background: true` to run as CC background task
|
|
66
|
-
- Set `timeout: 300000` (5 minutes) to prevent premature termination
|
|
67
|
-
- Parse JSON output and report URL to user
|
|
68
|
-
|
|
69
|
-
Example Bash tool call:
|
|
70
|
-
```json
|
|
71
|
-
{
|
|
72
|
-
"command": "node $HOME/.copilot/skills/markdown-novel-viewer/scripts/server.cjs --dir \"path\" --host 0.0.0.0 --open --foreground",
|
|
73
|
-
"run_in_background": true,
|
|
74
|
-
"timeout": 300000,
|
|
75
|
-
"description": "Start preview server in background"
|
|
76
|
-
}
|
|
77
|
-
```
|
|
78
|
-
|
|
79
62
|
After starting, parse the JSON output (e.g., `{"success":true,"url":"http://localhost:3456/view?file=...","networkUrl":"http://192.168.1.x:3456/view?file=..."}`) and report:
|
|
80
63
|
- Local URL for browser access
|
|
81
64
|
- Network URL for remote device access (if available)
|
|
82
|
-
- Inform user that server is now running
|
|
65
|
+
- Inform user that server is now running in the terminal; stop it by running the stop command
|
|
83
66
|
|
|
84
67
|
**CRITICAL:** MUST display the FULL URL including path and query string (e.g., `http://localhost:3456/view?file=/path/to/file.md`). NEVER truncate to just `host:port` (e.g., `http://localhost:3456`). The full URL is required for direct file access.
|
|
85
68
|
|
|
@@ -89,5 +72,6 @@ After starting, parse the JSON output (e.g., `{"success":true,"url":"http://loca
|
|
|
89
72
|
|
|
90
73
|
| Command | Description |
|
|
91
74
|
|---------|-------------|
|
|
92
|
-
| `/ck
|
|
93
|
-
| `/ck
|
|
75
|
+
| `/ck-brainstorm` | Explore ideas |
|
|
76
|
+
| `/ck-plan` | Create plan |
|
|
77
|
+
| `/ck-spec-specify` | Write detailed feature spec |
|
|
@@ -4,7 +4,7 @@ description: 'Scan and analyze the codebase'
|
|
|
4
4
|
argument-hint: 'Tasks or prompt to review'
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
Think harder to scan the codebase and analyze it follow the Orchestration Protocol, Core Responsibilities,
|
|
7
|
+
Think harder to scan the codebase and analyze it follow the Orchestration Protocol, Core Responsibilities, Agents Team and Development Rules:
|
|
8
8
|
<tasks>${input}</tasks>
|
|
9
9
|
|
|
10
10
|
---
|
|
@@ -23,31 +23,29 @@ Think harder to scan the codebase and analyze it follow the Orchestration Protoc
|
|
|
23
23
|
|
|
24
24
|
### Research
|
|
25
25
|
|
|
26
|
-
* Use 2 `researcher`
|
|
26
|
+
* Use 2 `researcher` agents in parallel to search up to max 5 sources for the user's request, idea validation, best practices, challenges, and find the best possible solutions.
|
|
27
27
|
* Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
|
|
28
|
-
* Use `/scout
|
|
28
|
+
* Use `/ck-scout` slash command to search the codebase for files needed to complete the task
|
|
29
29
|
|
|
30
30
|
### Code Review
|
|
31
31
|
|
|
32
|
-
* After finishing, use multiple `code-reviewer`
|
|
32
|
+
* After finishing, use multiple `code-reviewer` agents in parallel to review code.
|
|
33
33
|
* If there are any issues, duplicate code, or security vulnerabilities, ask main agent to improve the code and repeat the "Testing" process until all tests pass.
|
|
34
34
|
* When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
|
|
35
35
|
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
36
36
|
|
|
37
37
|
### Plan
|
|
38
|
-
* Use `planner`
|
|
38
|
+
* Use `planner` agent to analyze reports from `researcher` and `scout` agents to create an improvement plan following the progressive disclosure structure:
|
|
39
39
|
- Create a directory using naming pattern from `## Naming` section.
|
|
40
40
|
- Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
|
|
41
41
|
- For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
|
|
42
42
|
|
|
43
43
|
### Final Report
|
|
44
44
|
* Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
45
|
-
* Ask the user if they want to commit and push to git repository, if yes, use `git-manager`
|
|
45
|
+
* Ask the user if they want to commit and push to git repository, if yes, use `git-manager` agent to commit and push to git repository.
|
|
46
46
|
|
|
47
47
|
**REMEMBER**:
|
|
48
|
-
-
|
|
49
|
-
- You always read and analyze the generated assets with `ai-multimodal` skill to verify they meet requirements.
|
|
50
|
-
- For image editing (removing background, adjusting, cropping), use ImageMagick or similar tools as needed.
|
|
48
|
+
- Always verify generated assets meet design requirements before proceeding.
|
|
51
49
|
|
|
52
50
|
---
|
|
53
51
|
|
|
@@ -55,5 +53,6 @@ Think harder to scan the codebase and analyze it follow the Orchestration Protoc
|
|
|
55
53
|
|
|
56
54
|
| Command | Description |
|
|
57
55
|
|---------|-------------|
|
|
58
|
-
| `/ck
|
|
59
|
-
| `/ck
|
|
56
|
+
| `/ck-fix` | Fix issues found in review |
|
|
57
|
+
| `/ck-git` | Commit changes |
|
|
58
|
+
| `/ck-spec-checklist` | Validate against spec requirements |
|
|
@@ -34,7 +34,7 @@ Fast, token-efficient codebase scouting to find files needed for tasks.
|
|
|
34
34
|
- Ensure no overlap, maximize coverage
|
|
35
35
|
|
|
36
36
|
### 3. Execute Parallel Searches
|
|
37
|
-
|
|
37
|
+
Search the codebase with a wide range of patterns:
|
|
38
38
|
- File patterns: `**/*.ts`, `**/*.tsx`, `**/*.md`
|
|
39
39
|
- Content patterns: function names, class names, keywords
|
|
40
40
|
- Directory patterns: `src/`, `lib/`, `components/`
|
|
@@ -79,6 +79,7 @@ Use Glob and Grep with wide range of patterns:
|
|
|
79
79
|
|
|
80
80
|
| Command | Description |
|
|
81
81
|
|---------|-------------|
|
|
82
|
-
| `/ck
|
|
83
|
-
| `/ck
|
|
84
|
-
| `/ck
|
|
82
|
+
| `/ck-plan` | Create implementation plan |
|
|
83
|
+
| `/ck-cook` | Implement feature |
|
|
84
|
+
| `/ck-ask` | Ask technical questions |
|
|
85
|
+
| `/ck-spec-analyze` | Cross-artifact consistency check |
|
|
@@ -41,6 +41,6 @@ Scope:
|
|
|
41
41
|
|
|
42
42
|
| Command | Description |
|
|
43
43
|
|---------|-------------|
|
|
44
|
-
| `/ck
|
|
45
|
-
| `/ck
|
|
46
|
-
| `/ck
|
|
44
|
+
| `/ck-test` | Run tests to verify nothing broke |
|
|
45
|
+
| `/ck-review` | Code review the simplified code |
|
|
46
|
+
| `/ck-git` | Commit changes |
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Cross-artifact consistency and quality analysis across spec, plan, and tasks'
|
|
4
|
-
scripts:
|
|
5
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
|
|
6
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
|
|
7
4
|
---
|
|
8
5
|
|
|
9
6
|
## User Input
|
|
@@ -16,13 +13,13 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
16
13
|
|
|
17
14
|
## Goal
|
|
18
15
|
|
|
19
|
-
Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/ck
|
|
16
|
+
Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/ck-spec-tasks` has successfully produced a complete `tasks.md`.
|
|
20
17
|
|
|
21
18
|
## Operating Constraints
|
|
22
19
|
|
|
23
20
|
**STRICTLY READ-ONLY**: Do **not** modify any files. Output a structured analysis report. Offer an optional remediation plan (user must explicitly approve before any follow-up editing commands would be invoked manually).
|
|
24
21
|
|
|
25
|
-
**Constitution Authority**: The project constitution (`constitution.md` at project root) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/ck
|
|
22
|
+
**Constitution Authority**: The project constitution (`constitution.md` at project root) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/ck-spec-analyze`.
|
|
26
23
|
|
|
27
24
|
## Execution Steps
|
|
28
25
|
|
|
@@ -161,9 +158,9 @@ Output a Markdown report (no file writes) with the following structure:
|
|
|
161
158
|
|
|
162
159
|
At end of report, output a concise Next Actions block:
|
|
163
160
|
|
|
164
|
-
- If CRITICAL issues exist: Recommend resolving before `/ck
|
|
161
|
+
- If CRITICAL issues exist: Recommend resolving before `/ck-spec-implement`
|
|
165
162
|
- If only LOW/MEDIUM: User may proceed, but provide improvement suggestions
|
|
166
|
-
- Provide explicit command suggestions: e.g., "Run /ck
|
|
163
|
+
- Provide explicit command suggestions: e.g., "Run /ck-spec-specify with refinement", "Run /ck-spec-plan to adjust architecture", "Manually edit tasks.md to add coverage for 'performance-metrics'"
|
|
167
164
|
|
|
168
165
|
### 8. Offer Remediation
|
|
169
166
|
|
|
@@ -196,8 +193,9 @@ Ask the user: "Would you like me to suggest concrete remediation edits for the t
|
|
|
196
193
|
|
|
197
194
|
| Command | Description | When to Use |
|
|
198
195
|
|---------|-------------|-------------|
|
|
199
|
-
| `/ck
|
|
200
|
-
| `/ck
|
|
201
|
-
| `/ck
|
|
196
|
+
| `/ck-spec-implement` | Start implementation | Analysis passed, no critical issues |
|
|
197
|
+
| `/ck-spec-clarify` | Clarify requirements | Analysis found ambiguities in spec |
|
|
198
|
+
| `/ck-spec-tasks` | Regenerate tasks | Task coverage gaps identified |
|
|
199
|
+
| `/ck-fix` | Fix issues found in analysis | Code-level bugs identified |
|
|
202
200
|
|
|
203
|
-
**Workflow:** `/ck
|
|
201
|
+
**Workflow:** `/ck-spec-analyze` → fix issues → `/ck-spec-implement`
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Generate a custom checklist for the current feature based on user requirements'
|
|
4
|
-
scripts:
|
|
5
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json
|
|
6
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json
|
|
7
4
|
---
|
|
8
5
|
|
|
9
6
|
## Checklist Purpose: "Unit Tests for English"
|
|
@@ -97,7 +94,7 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
97
94
|
- Format: `[domain].md`
|
|
98
95
|
- If file exists, append to existing file
|
|
99
96
|
- Number items sequentially starting from CHK001
|
|
100
|
-
- Each `/ck
|
|
97
|
+
- Each `/ck-spec-checklist` run creates a NEW file (never overwrites existing checklists)
|
|
101
98
|
|
|
102
99
|
**CORE PRINCIPLE - Test the Requirements, Not the Implementation**:
|
|
103
100
|
Every checklist item MUST evaluate the REQUIREMENTS THEMSELVES for:
|
|
@@ -215,7 +212,7 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
215
212
|
- Actor/timing
|
|
216
213
|
- Any explicit user-specified must-have items incorporated
|
|
217
214
|
|
|
218
|
-
**Important**: Each `/ck
|
|
215
|
+
**Important**: Each `/ck-spec-checklist` command invocation creates a checklist file using short, descriptive names unless file already exists. This allows:
|
|
219
216
|
|
|
220
217
|
- Multiple checklists of different types (e.g., `ux.md`, `test.md`, `security.md`)
|
|
221
218
|
- Simple, memorable filenames that indicate checklist purpose
|
|
@@ -303,8 +300,9 @@ Sample items:
|
|
|
303
300
|
|
|
304
301
|
| Command | Description | When to Use |
|
|
305
302
|
|---------|-------------|-------------|
|
|
306
|
-
| `/ck
|
|
307
|
-
| `/ck
|
|
308
|
-
| `/ck
|
|
303
|
+
| `/ck-spec-clarify` | Clarify requirements | Checklist revealed gaps in spec |
|
|
304
|
+
| `/ck-spec-plan` | Generate implementation plan | Checklist passed, spec is solid |
|
|
305
|
+
| `/ck-spec-implement` | Start implementation | Plan exists, checklist validated |
|
|
306
|
+
| `/ck-test` | Run tests to validate | Checklist passed, verify with tests |
|
|
309
307
|
|
|
310
|
-
**Usage:** Run `/ck
|
|
308
|
+
**Usage:** Run `/ck-spec-checklist [domain]` for focused validation (e.g., security, ux, api)
|
|
@@ -1,13 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Identify underspecified areas and ask targeted clarification questions'
|
|
4
|
-
handoffs:
|
|
5
|
-
- label: Build Technical Plan
|
|
6
|
-
agent: ck.spec.plan
|
|
7
|
-
prompt: Create a plan for the spec. I am building with...
|
|
8
|
-
scripts:
|
|
9
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json --paths-only
|
|
10
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly
|
|
11
4
|
---
|
|
12
5
|
|
|
13
6
|
## User Input
|
|
@@ -22,7 +15,7 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
22
15
|
|
|
23
16
|
Goal: Detect and reduce ambiguity or missing decision points in the active feature specification and record the clarifications directly in the spec file.
|
|
24
17
|
|
|
25
|
-
Note: This clarification workflow is expected to run (and be completed) BEFORE invoking `/ck
|
|
18
|
+
Note: This clarification workflow is expected to run (and be completed) BEFORE invoking `/ck-spec-plan`. If the user explicitly states they are skipping clarification (e.g., exploratory spike), you may proceed, but must warn that downstream rework risk increases.
|
|
26
19
|
|
|
27
20
|
Execution steps:
|
|
28
21
|
|
|
@@ -30,7 +23,7 @@ Execution steps:
|
|
|
30
23
|
- `FEATURE_DIR`
|
|
31
24
|
- `FEATURE_SPEC`
|
|
32
25
|
- (Optionally capture `IMPL_PLAN`, `TASKS` for future chained flows.)
|
|
33
|
-
- If JSON parsing fails, abort and instruct user to re-run `/ck
|
|
26
|
+
- If JSON parsing fails, abort and instruct user to re-run `/ck-spec-specify` or verify feature branch environment.
|
|
34
27
|
- For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
|
|
35
28
|
|
|
36
29
|
2. Load the current spec file. Perform a structured ambiguity & coverage scan using this taxonomy. For each category, mark status: Clear / Partial / Missing. Produce an internal coverage map used for prioritization (do not output raw map unless no questions will be asked).
|
|
@@ -169,13 +162,13 @@ Execution steps:
|
|
|
169
162
|
- Path to updated spec.
|
|
170
163
|
- Sections touched (list names).
|
|
171
164
|
- Coverage summary table listing each taxonomy category with Status: Resolved (was Partial/Missing and addressed), Deferred (exceeds question quota or better suited for planning), Clear (already sufficient), Outstanding (still Partial/Missing but low impact).
|
|
172
|
-
- If any Outstanding or Deferred remain, recommend whether to proceed to `/ck
|
|
165
|
+
- If any Outstanding or Deferred remain, recommend whether to proceed to `/ck-spec-plan` or run `/ck-spec-clarify` again later post-plan.
|
|
173
166
|
- Suggested next command.
|
|
174
167
|
|
|
175
168
|
Behavior rules:
|
|
176
169
|
|
|
177
170
|
- If no meaningful ambiguities found (or all potential questions would be low-impact), respond: "No critical ambiguities detected worth formal clarification." and suggest proceeding.
|
|
178
|
-
- If spec file missing, instruct user to run `/ck
|
|
171
|
+
- If spec file missing, instruct user to run `/ck-spec-specify` first (do not create a new spec here).
|
|
179
172
|
- Never exceed 5 total asked questions (clarification retries for a single question do not count as new questions).
|
|
180
173
|
- Avoid speculative tech stack questions unless the absence blocks functional clarity.
|
|
181
174
|
- Respect user early termination signals ("stop", "done", "proceed").
|
|
@@ -190,8 +183,8 @@ Context for prioritization: {ARGS}
|
|
|
190
183
|
|
|
191
184
|
| Command | Description | When to Use |
|
|
192
185
|
|---------|-------------|-------------|
|
|
193
|
-
| `/ck
|
|
194
|
-
| `/ck
|
|
195
|
-
| `/ck
|
|
186
|
+
| `/ck-spec-plan` | Generate implementation plan | All clarifications resolved, spec is complete |
|
|
187
|
+
| `/ck-spec-checklist` | Generate validation checklist | Need domain-specific requirements validation |
|
|
188
|
+
| `/ck-spec-specify` | Update/rewrite spec | Major scope changes or new feature |
|
|
196
189
|
|
|
197
|
-
**Workflow:** `/ck
|
|
190
|
+
**Workflow:** `/ck-spec-specify` → `/ck-spec-clarify` → `/ck-spec-plan` → `/ck-spec-tasks` → `/ck-spec-implement`
|
|
@@ -1,12 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Create or update the project constitution from principle inputs'
|
|
4
|
-
handoffs:
|
|
5
|
-
- label: Build Specification
|
|
6
|
-
agent: ck.spec.specify
|
|
7
|
-
prompt: >-
|
|
8
|
-
Implement the feature specification based on the updated constitution. I
|
|
9
|
-
want to build...
|
|
10
4
|
---
|
|
11
5
|
|
|
12
6
|
## User Input
|
|
@@ -47,7 +41,7 @@ Follow this execution flow:
|
|
|
47
41
|
- Read `spec-kit/templates/plan-template.md` and ensure any "Constitution Check" or rules align with updated principles.
|
|
48
42
|
- Read `spec-kit/templates/spec-template.md` for scope/requirements alignment—update if constitution adds/removes mandatory sections or constraints.
|
|
49
43
|
- Read `spec-kit/templates/tasks-template.md` and ensure task categorization reflects new or removed principle-driven task types (e.g., observability, versioning, testing discipline).
|
|
50
|
-
- Read each command file in `spec-kit/templates/commands/*.md` (including this one) to verify no outdated references (agent-specific names
|
|
44
|
+
- Read each command file in `spec-kit/templates/commands/*.md` (including this one) to verify no outdated references (agent-specific names only) remain when generic guidance is required.
|
|
51
45
|
- Read any runtime guidance docs (e.g., `README.md`, `docs/quickstart.md`, or agent-specific guidance files if present). Update references to principles changed.
|
|
52
46
|
|
|
53
47
|
5. Produce a Sync Impact Report (prepend as an HTML comment at top of the constitution file after update):
|
|
@@ -90,8 +84,9 @@ The template at `spec-kit/memory/constitution.md` should NOT be modified; always
|
|
|
90
84
|
|
|
91
85
|
| Command | Description | When to Use |
|
|
92
86
|
|---------|-------------|-------------|
|
|
93
|
-
| `/ck
|
|
94
|
-
| `/ck
|
|
95
|
-
| `/ck
|
|
87
|
+
| `/ck-spec-specify` | Create feature spec | Constitution ready, start defining features |
|
|
88
|
+
| `/ck-spec-plan` | Generate implementation plan | Update existing plan with new principles |
|
|
89
|
+
| `/ck-spec-analyze` | Validate consistency | Check if existing artifacts align with constitution |
|
|
90
|
+
| `/ck-brainstorm` | Brainstorm project ideas | Early stage, exploring project direction |
|
|
96
91
|
|
|
97
|
-
**Usage:** Run `/ck
|
|
92
|
+
**Usage:** Run `/ck-spec-constitution` at project start to establish non-negotiable principles
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Execute the implementation plan by processing all tasks in tasks.md'
|
|
4
|
-
scripts:
|
|
5
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
|
|
6
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
|
|
7
4
|
---
|
|
8
5
|
|
|
9
6
|
## User Input
|
|
@@ -98,8 +95,8 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
98
95
|
**Tool-Specific Patterns**:
|
|
99
96
|
- **Docker**: `node_modules/`, `.git/`, `Dockerfile*`, `.dockerignore`, `*.log*`, `.env*`, `coverage/`
|
|
100
97
|
- **ESLint**: `node_modules/`, `dist/`, `build/`, `coverage/`, `*.min.js`
|
|
101
|
-
- **Prettier**: `node_modules/`, `dist/`, `build/`, `coverage/`, `package-lock.json`, `yarn.lock`, `pnpm-lock
|
|
102
|
-
- **Terraform**: `.terraform/`, `*.tfstate*`, `*.tfvars`, `.terraform.lock
|
|
98
|
+
- **Prettier**: `node_modules/`, `dist/`, `build/`, `coverage/`, `package-lock.json`, `yarn.lock`, `pnpm-lock-yaml`
|
|
99
|
+
- **Terraform**: `.terraform/`, `*.tfstate*`, `*.tfvars`, `.terraform.lock-hcl`
|
|
103
100
|
- **Kubernetes/k8s**: `*.secret.yaml`, `secrets/`, `.kube/`, `kubeconfig*`, `*.key`, `*.crt`
|
|
104
101
|
|
|
105
102
|
5. Parse task structure and extract:
|
|
@@ -144,7 +141,7 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
144
141
|
|
|
145
142
|
**Notes**:
|
|
146
143
|
- This command supports both single-file (tasks.md only) and hybrid structure (tasks.md + tasks/phase-*.md)
|
|
147
|
-
- If tasks are incomplete or missing, suggest running `/ck
|
|
144
|
+
- If tasks are incomplete or missing, suggest running `/ck-spec-tasks` first to regenerate the task list
|
|
148
145
|
- Hybrid structure enables parallel work: multiple agents can work on different phase files simultaneously
|
|
149
146
|
|
|
150
147
|
---
|
|
@@ -153,8 +150,8 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
153
150
|
|
|
154
151
|
| Command | Description | When to Use |
|
|
155
152
|
|---------|-------------|-------------|
|
|
156
|
-
| `/ck
|
|
157
|
-
| `/ck
|
|
158
|
-
| `/ck
|
|
153
|
+
| `/ck-test` | Run tests and analyze | Validate implementation against requirements |
|
|
154
|
+
| `/ck-review` | Code review | Implementation complete, ready for QA |
|
|
155
|
+
| `/ck-fix` | Fix issues | Tests failed or bugs discovered |
|
|
159
156
|
|
|
160
|
-
**Workflow:** `/ck
|
|
157
|
+
**Workflow:** `/ck-spec-implement` → `/ck-test` → `/ck-review` → `/ck-git`
|
|
@@ -1,20 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Execute implementation planning workflow to generate design artifacts'
|
|
4
|
-
handoffs:
|
|
5
|
-
- label: Create Tasks
|
|
6
|
-
agent: ck.spec.tasks
|
|
7
|
-
prompt: Break the plan into tasks
|
|
8
|
-
send: true
|
|
9
|
-
- label: Create Checklist
|
|
10
|
-
agent: ck.spec.checklist
|
|
11
|
-
prompt: Create a checklist for the following domain...
|
|
12
|
-
scripts:
|
|
13
|
-
sh: spec-kit/scripts/bash/setup-plan.sh --json
|
|
14
|
-
ps: spec-kit/scripts/powershell/setup-plan.ps1 -Json
|
|
15
|
-
agent_scripts:
|
|
16
|
-
sh: spec-kit/scripts/bash/update-agent-context.sh __AGENT__
|
|
17
|
-
ps: spec-kit/scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__
|
|
18
4
|
---
|
|
19
5
|
|
|
20
6
|
## User Input
|
|
@@ -101,8 +87,9 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
101
87
|
|
|
102
88
|
| Command | Description | When to Use |
|
|
103
89
|
|---------|-------------|-------------|
|
|
104
|
-
| `/ck
|
|
105
|
-
| `/ck
|
|
106
|
-
| `/ck
|
|
90
|
+
| `/ck-spec-tasks` | Generate executable tasks | Plan complete with data-model.md, contracts/ ready |
|
|
91
|
+
| `/ck-spec-checklist` | Generate validation checklist | Need domain-specific QA before implementation |
|
|
92
|
+
| `/ck-spec-analyze` | Cross-artifact analysis | After tasks generated, check consistency |
|
|
93
|
+
| `/ck-cook` | Quick flow — implement plan directly | Plan is simple, skip spec-tasks |
|
|
107
94
|
|
|
108
|
-
**Workflow:** `/ck
|
|
95
|
+
**Workflow:** `/ck-spec-specify` → `/ck-spec-clarify` → `/ck-spec-plan` → `/ck-spec-tasks` → `/ck-spec-implement`
|
|
@@ -1,17 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Create or update the feature specification from a natural language description'
|
|
4
|
-
handoffs:
|
|
5
|
-
- label: Build Technical Plan
|
|
6
|
-
agent: ck.spec.plan
|
|
7
|
-
prompt: Create a plan for the spec. I am building with...
|
|
8
|
-
- label: Clarify Spec Requirements
|
|
9
|
-
agent: ck.spec.clarify
|
|
10
|
-
prompt: Clarify specification requirements
|
|
11
|
-
send: true
|
|
12
|
-
scripts:
|
|
13
|
-
sh: 'spec-kit/scripts/bash/create-new-feature.sh --json "{ARGS}"'
|
|
14
|
-
ps: 'spec-kit/scripts/powershell/create-new-feature.ps1 -Json "{ARGS}"'
|
|
15
4
|
---
|
|
16
5
|
|
|
17
6
|
## User Input
|
|
@@ -24,7 +13,7 @@ You **MUST** consider the user input before proceeding (if not empty).
|
|
|
24
13
|
|
|
25
14
|
## Outline
|
|
26
15
|
|
|
27
|
-
The text the user typed after `/ck
|
|
16
|
+
The text the user typed after `/ck-spec-specify` in the triggering message **is** the feature description. Assume you always have it available in this conversation even if `{ARGS}` appears literally below. Do not ask the user to repeat it unless they provided an empty command.
|
|
28
17
|
|
|
29
18
|
Given that feature description, do this:
|
|
30
19
|
|
|
@@ -138,7 +127,7 @@ Given that feature description, do this:
|
|
|
138
127
|
|
|
139
128
|
## Notes
|
|
140
129
|
|
|
141
|
-
- Items marked incomplete require spec updates before `/ck
|
|
130
|
+
- Items marked incomplete require spec updates before `/ck-spec-clarify` or `/ck-spec-plan`
|
|
142
131
|
```
|
|
143
132
|
|
|
144
133
|
b. **Run Validation Check**: Review the spec against each checklist item:
|
|
@@ -192,7 +181,7 @@ Given that feature description, do this:
|
|
|
192
181
|
|
|
193
182
|
d. **Update Checklist**: After each validation iteration, update the checklist file with current pass/fail status
|
|
194
183
|
|
|
195
|
-
7. Report completion with branch name, spec file path, checklist results, and readiness for the next phase (`/ck
|
|
184
|
+
7. Report completion with branch name, spec file path, checklist results, and readiness for the next phase (`/ck-spec-clarify` or `/ck-spec-plan`).
|
|
196
185
|
|
|
197
186
|
**NOTE:** The script creates and checks out the new branch and initializes the spec file before writing.
|
|
198
187
|
|
|
@@ -265,6 +254,8 @@ Success criteria must be:
|
|
|
265
254
|
|
|
266
255
|
| Command | Description | When to Use |
|
|
267
256
|
|---------|-------------|-------------|
|
|
268
|
-
| `/ck
|
|
269
|
-
| `/ck
|
|
270
|
-
| `/ck
|
|
257
|
+
| `/ck-spec-clarify` | Ask clarification questions | Spec has [NEEDS CLARIFICATION] markers or vague requirements |
|
|
258
|
+
| `/ck-spec-plan` | Generate implementation plan | Spec is complete and ready for technical planning |
|
|
259
|
+
| `/ck-spec-constitution` | Create project principles | Need to establish non-negotiable rules before planning |
|
|
260
|
+
| `/ck-plan` | Create implementation plan | Spec is finalized, ready to plan and implement |
|
|
261
|
+
| `/ck-brainstorm` | Brainstorm ideas first | Not sure what to build yet |
|
|
@@ -1,18 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
agent: 'agent'
|
|
3
3
|
description: 'Generate actionable, dependency-ordered tasks.md from design artifacts'
|
|
4
|
-
handoffs:
|
|
5
|
-
- label: Analyze For Consistency
|
|
6
|
-
agent: ck.spec.analyze
|
|
7
|
-
prompt: Run a project analysis for consistency
|
|
8
|
-
send: true
|
|
9
|
-
- label: Implement Project
|
|
10
|
-
agent: ck.spec.implement
|
|
11
|
-
prompt: Start the implementation in phases
|
|
12
|
-
send: true
|
|
13
|
-
scripts:
|
|
14
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json
|
|
15
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json
|
|
16
4
|
---
|
|
17
5
|
|
|
18
6
|
## User Input
|
|
@@ -186,8 +174,8 @@ Every task MUST strictly follow this format:
|
|
|
186
174
|
|
|
187
175
|
| Command | Description | When to Use |
|
|
188
176
|
|---------|-------------|-------------|
|
|
189
|
-
| `/ck
|
|
190
|
-
| `/ck
|
|
191
|
-
| `/ck
|
|
177
|
+
| `/ck-spec-analyze` | Cross-artifact consistency check | Before implementation, validate spec/plan/tasks alignment |
|
|
178
|
+
| `/ck-spec-implement` | Execute implementation | All tasks validated, ready to code |
|
|
179
|
+
| `/ck-cook` | Quick flow — implement without full spec | Simple tasks that don't need spec-implement |
|
|
192
180
|
|
|
193
|
-
**Workflow:** `/ck
|
|
181
|
+
**Workflow:** `/ck-spec-specify` → `/ck-spec-clarify` → `/ck-spec-plan` → `/ck-spec-tasks` → `/ck-spec-implement`
|
|
@@ -4,7 +4,7 @@ description: 'Run tests locally and analyze the summary report'
|
|
|
4
4
|
tools: ['execute/runInTerminal', 'execute/getTerminalOutput', 'execute/runTests', 'execute/testFailure', 'read/problems']
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
Use the `tester`
|
|
7
|
+
Use the `tester` agent to run tests locally and analyze the summary report.
|
|
8
8
|
|
|
9
9
|
**IMPORTANT**: **Do not** start implementing.
|
|
10
10
|
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
@@ -15,5 +15,7 @@ Use the `tester` subagent to run tests locally and analyze the summary report.
|
|
|
15
15
|
|
|
16
16
|
| Command | Description |
|
|
17
17
|
|---------|-------------|
|
|
18
|
-
| `/ck
|
|
19
|
-
| `/ck
|
|
18
|
+
| `/ck-fix` | Analyze and fix issues |
|
|
19
|
+
| `/ck-review` | Scan and analyze codebase |
|
|
20
|
+
| `/ck-git` | Commit changes |
|
|
21
|
+
| `/ck-spec-checklist` | Validate against spec requirements |
|
|
@@ -15,5 +15,7 @@ Analyze the overall impact and quality of the changes.
|
|
|
15
15
|
|
|
16
16
|
| Command | Description |
|
|
17
17
|
|---------|-------------|
|
|
18
|
-
| `/ck
|
|
19
|
-
| `/ck
|
|
18
|
+
| `/ck-brainstorm` | Explore ideas |
|
|
19
|
+
| `/ck-plan` | Create plan |
|
|
20
|
+
| `/ck-cook` | Implement feature |
|
|
21
|
+
| `/ck-spec-specify` | Write detailed feature spec |
|
package/skills/INSTALLATION.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Skills Installation Guide
|
|
2
2
|
|
|
3
|
-
This guide explains how to install dependencies for
|
|
3
|
+
This guide explains how to install dependencies for skills.
|
|
4
4
|
|
|
5
5
|
## Overview
|
|
6
6
|
|
|
@@ -203,7 +203,7 @@ Skills respect environment variable loading priority:
|
|
|
203
203
|
1. **process.env** (highest priority - runtime environment)
|
|
204
204
|
2. **`$HOME/.copilot/skills/{skill-name}/.env`** (skill-specific config)
|
|
205
205
|
3. **`$HOME/.copilot/skills/.env`** (shared skills config)
|
|
206
|
-
4. **`$HOME/.copilot/.env`** (global
|
|
206
|
+
4. **`$HOME/.copilot/.env`** (global config)
|
|
207
207
|
|
|
208
208
|
Example `.env` files are provided where needed (e.g., `devops/.env.example`).
|
|
209
209
|
|
|
@@ -308,4 +308,4 @@ If dependencies fail to install or scripts don't work:
|
|
|
308
308
|
2. Verify system tools are installed and in PATH
|
|
309
309
|
3. Check environment variables are set correctly
|
|
310
310
|
4. Review skill's `SKILL.md` for additional setup instructions
|
|
311
|
-
5. Open an issue
|
|
311
|
+
5. Open an issue on the project repository
|