projectops 4.48.1 → 4.49.0
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 -9
- package/package.json +1 -1
- package/src/core/exclusions.js +1 -0
package/README.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
<img src="https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/hero-en.webp" alt="Projectops: from issue to release" width="100%">
|
|
4
4
|
|
|
5
|
+
**One install: issue → branch → release PR → deploy, with agent skills that drive each step.**
|
|
6
|
+
|
|
5
7
|
[한국어](docs/i18n/README.ko.md) | **English** | [简体中文](docs/i18n/README.zh-CN.md) | [日本語](docs/i18n/README.ja.md)
|
|
6
8
|
|
|
7
9
|
[](https://www.npmjs.com/package/projectops) [](https://github.com/Cassiiopeia/projectops/releases) [](LICENSE) [](https://cassiiopeia.github.io/projectops/)
|
|
@@ -9,7 +11,7 @@
|
|
|
9
11
|
**Status: actively maintained.** npm `latest` is exactly what is on the `main` branch; work in progress on `develop` is never published. Versions can still ship several times a day. To stay on a version you have tested, run `npx projectops@<version>` ([releases](https://github.com/Cassiiopeia/projectops/releases)).
|
|
10
12
|
|
|
11
13
|
<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
|
|
12
|
-
## Latest version : v4.48.
|
|
14
|
+
## Latest version : v4.48.1 (2026-10-12)
|
|
13
15
|
|
|
14
16
|
[View full version history](CHANGELOG.md)
|
|
15
17
|
|
|
@@ -39,7 +41,7 @@
|
|
|
39
41
|
This project automates your development workflow on two axes.
|
|
40
42
|
|
|
41
43
|
**① GitHub Actions**: one push to main handles versioning, changelogs, and CI/CD deployment.
|
|
42
|
-
**② Agent Skills**: commands such as `/pro-github`, `/pro-commit`, and `/pro-report` let an AI agent
|
|
44
|
+
**② Agent Skills**: commands such as `/pro-github`, `/pro-commit`, and `/pro-report` let an AI agent drive each step of that automation for you: issues, commits in your own style, reports, and release PRs.
|
|
43
45
|
|
|
44
46
|
| The usual way | With Projectops |
|
|
45
47
|
|----------|---------------------|
|
|
@@ -47,9 +49,9 @@ This project automates your development workflow on two axes.
|
|
|
47
49
|
| Write the changelog yourself | Generated for every release PR (commit analysis, or an AI summary if you add an AI key) |
|
|
48
50
|
| Set up CI/CD from scratch | Workflows for your project type, ready immediately |
|
|
49
51
|
| Format every issue by hand | `/pro-github` writes and files an issue from the standard template in one step |
|
|
50
|
-
| Copy the issue URL into commit messages | `/pro-commit` completes the message from the issue context |
|
|
52
|
+
| Copy the issue URL into commit messages | `/pro-commit` completes the message from the issue context, in your own style |
|
|
51
53
|
| Write PR descriptions and reports by hand | `/pro-report` analyzes the git diff and generates one |
|
|
52
|
-
| Re-type prompts for every code review or analysis |
|
|
54
|
+
| Re-type prompts for every code review or analysis | 14 skills give consistent results without re-typing |
|
|
53
55
|
|
|
54
56
|
---
|
|
55
57
|
|
|
@@ -63,7 +65,7 @@ If you only need one piece of this, a smaller tool may suit you better.
|
|
|
63
65
|
| Review step before a release | A release PR (develop → main), merged automatically | A release PR you merge | None by default, releases on push | A "Version Packages" PR |
|
|
64
66
|
| Changelog | Written in the release PR (commit analysis, or an AI summary) | Generated | Generated (plugin) | Assembled from changeset files |
|
|
65
67
|
| CI/CD workflows for your project type | Yes (Spring, Flutter, React, Node, Python ...) | No | No | No |
|
|
66
|
-
|
|
|
68
|
+
| Agent skills that run the cycle (issues, worktrees, commits in your style, reports, release PRs, real-device QA) | Yes | No | No | No |
|
|
67
69
|
| What it adds to your repo | About 50 files (below) | A workflow and a config file | A config file and a CI step | A `.changeset/` folder and a CI step |
|
|
68
70
|
|
|
69
71
|
- Want only versioning and a changelog? release-please or semantic-release is smaller.
|
|
@@ -84,19 +86,54 @@ Below is a **real run, recorded** after installing projectops in a sample repo i
|
|
|
84
86
|
|
|
85
87
|
When an issue is opened, GitHub Actions runs on its own and comments a **branch name and a commit message template**. Work on that branch name and the issue number links into your commits and reports automatically.
|
|
86
88
|
|
|
89
|
+
**Drive it from your agent:** `/pro-github` files the issue, `/pro-init-worktree` sets up the workspace, and `/pro-commit` writes the commit in your format.
|
|
90
|
+
|
|
87
91
|
### 2. Open a PR and a change summary arrives automatically
|
|
88
92
|
|
|
89
93
|

|
|
90
94
|
|
|
91
95
|
Open a PR from a work branch and a **change summary** built from the commits is posted as a comment. Push more commits and the same comment is updated instead of piling up new ones.
|
|
92
96
|
|
|
97
|
+
**Drive it from your agent:** `/pro-report` analyzes the diff and posts the implementation report; `/pro-agent-test` verifies the change by actually running it.
|
|
98
|
+
|
|
93
99
|
### 3. Open a release PR and everything from versioning to merge and tag is automatic
|
|
94
100
|
|
|
95
101
|

|
|
96
102
|
|
|
97
103
|
Open a PR from the development branch to `main` and it writes the release notes, decides the version from commit titles (`feat`, `fix`, ...) and puts it in the PR title, merges automatically, and creates the **version tag**. This example had `feat` commits, so the minor version went up.
|
|
98
104
|
|
|
105
|
+
**Drive it from your agent:** `/pro-changelog-deploy` pushes develop and opens the release PR for you.
|
|
106
|
+
|
|
99
107
|
> The warning banner GitHub shows for Korean branch names is hidden in the recording. Everything else is the unedited screen.
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Make it yours
|
|
112
|
+
|
|
113
|
+
Skills write in your style. Put your preferences in `~/.projectops/config/config.json`; nothing is asked on first run.
|
|
114
|
+
|
|
115
|
+
```json
|
|
116
|
+
{
|
|
117
|
+
"preferences": { "language": "en", "tone": "short and direct", "rules": ["no emoji"] },
|
|
118
|
+
"skills": { "pro-commit": { "preset": "gitmoji" } }
|
|
119
|
+
}
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
Team formats in `version.yml` win; your tone still applies. Details: [Skills guide](docs/en/skills.md).
|
|
123
|
+
|
|
124
|
+
### Example: /pro-oss-consult on this repo
|
|
125
|
+
|
|
126
|
+
We ran `/pro-oss-consult` on this repo, then fixed what it found (measured 2026-10-13).
|
|
127
|
+
|
|
128
|
+
| Check | Before | After |
|
|
129
|
+
|---|---|---|
|
|
130
|
+
| Skill count stated in README and manifests | inconsistent (15 vs 20 stated, actual 15) | consistent: 14 core + 1 in the optional extras plugin |
|
|
131
|
+
| Longest skill description | 1,183 chars; 6 over 1,000 | 237 chars; 0 over 300 |
|
|
132
|
+
| Skills with no tests (all 15 skills) | 6 | 0 (56 contract test cases cover all 15 skills, 14 core + 1 extras) |
|
|
133
|
+
| Commit format | hardcoded in `pro-commit` | configurable via preferences and `version.yml` |
|
|
134
|
+
|
|
135
|
+
What it changed: descriptions were cut to short English triggers, a shared contract test now checks every skill, and `pro-commit` follows your team's `version.yml` commit template.
|
|
136
|
+
|
|
100
137
|
---
|
|
101
138
|
|
|
102
139
|
## What is inside
|
|
@@ -104,18 +141,18 @@ Open a PR from the development branch to `main` and it writes the release notes,
|
|
|
104
141
|
| Part | What it does | Docs |
|
|
105
142
|
|---|---|---|
|
|
106
143
|
| **GitHub Actions** | One push to main handles versioning, changelogs, and CI/CD deployment | [Versioning](https://cassiiopeia.github.io/projectops/VERSION-CONTROL) (Korean) |
|
|
107
|
-
| **Agent Skills** (
|
|
144
|
+
| **Agent Skills** (14) | `/pro-github`, `/pro-commit`, `/pro-report` and more let an AI agent drive each step: issues, commits in your style, reports, release PRs | [Skills guide](https://cassiiopeia.github.io/projectops/SKILLS) (Korean) |
|
|
108
145
|
| **npx CLI** | Installs and updates workflows in an existing project, and diagnoses its state | [CLI reference](https://cassiiopeia.github.io/projectops/en/cli) |
|
|
109
146
|
|
|
110
147
|
<details>
|
|
111
|
-
<summary>See all
|
|
148
|
+
<summary>See all 14 Agent Skills</summary>
|
|
112
149
|
|
|
113
150
|
### 🔄 Development cycle automation
|
|
114
151
|
|
|
115
152
|
| Skill | Purpose |
|
|
116
153
|
|------|------|
|
|
117
154
|
| `/pro-init-worktree` | Create a Git worktree and copy sensitive files automatically |
|
|
118
|
-
| `/pro-commit` | Complete a commit message from the issue context (
|
|
155
|
+
| `/pro-commit` | Complete a commit message from the issue context, in your own format (preset or template) |
|
|
119
156
|
| `/pro-report` | Analyze the git diff → generate an implementation report and post it as a GitHub comment |
|
|
120
157
|
| `/pro-changelog-deploy` | Push develop → open the main release PR + write release notes + automerge |
|
|
121
158
|
| `/pro-github` | GitHub in general: create issues (one-line description → template + file), view/edit/comment/label/assign, create/merge/view PRs, explore repos, manage Actions and Secrets |
|
|
@@ -143,10 +180,11 @@ Open a PR from the development branch to `main` and it writes the release notes,
|
|
|
143
180
|
|------|------|
|
|
144
181
|
| `/pro-testcase` | Analyze an issue → generate a QA checklist |
|
|
145
182
|
| `/pro-agent-test` | QA that actually runs apps, web, and servers to find bugs, reporting reproduction steps, evidence, and severity (it does not fix code) |
|
|
146
|
-
| `/pro-synology-expose` | Guide to exposing a Synology NAS service on an external domain |
|
|
147
183
|
| `/pro-ssh` | Connect to a remote server over SSH and run commands (AWS EC2, Synology NAS, Linux, and more) |
|
|
148
184
|
| `/pro-skill-creator` | Create, review, and improve a Skill (CREATE / REVIEW / IMPROVE modes) |
|
|
149
185
|
|
|
186
|
+
**Extras** (optional plugin): `/pro-synology-expose` — `claude plugin install projectops-extras@projectops-marketplace --scope user`
|
|
187
|
+
|
|
150
188
|
</details>
|
|
151
189
|
|
|
152
190
|
<details>
|
package/package.json
CHANGED