@ranger1/dx 0.1.115 → 0.1.117

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ranger1/dx",
3
- "version": "0.1.115",
3
+ "version": "0.1.117",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: backend-audit-fixer
3
- description: 必须显式调用才触发
3
+ description: 仅在用户显式调用 $backend-audit-fixer 或明确要求使用 backend-audit-fixer 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # 后端规范审计与修复(伞 skill)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: create-issue
3
- description: 仅在用户显式调用 /create-issue 或明确要求使用 create-issue 技能时使用;不要通过关键词自动触发。用于把已收敛的设计对照 / 缺陷调查 / 需求讨论落成开发者可快速定位、可客观验收的 GitHub issue。
3
+ description: 仅在用户显式调用 $create-issue、/create-issue 或明确要求使用 create-issue 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Create Issue
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: delivering-design-handoff
3
- description: Use when a design is already approved and the user asks to create a design/spec doc, implementation plan, adversarial review, GitHub issue, issue branch, handoff document, commit, push, or copyable assignment text.
3
+ description: 仅在用户显式调用 $delivering-design-handoff 或明确要求使用 delivering-design-handoff 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Delivering Design Handoff
@@ -37,7 +37,6 @@ By the end, produce all of these or clearly state the blocker:
37
37
  | Issue branch | `codex/docs/<issue-id>-<slug>` for docs-only handoff, or matching repo convention |
38
38
  | Commit | Conventional commit ending with `Refs: #<issue-id>` |
39
39
  | Push | Branch pushed with upstream |
40
- | Pull request | PR created or updated with the repo PR template, non-empty body, linked issue, doc paths, verification evidence, and read-back validation |
41
40
  | Issue comment | Comment linking branch, commit, spec, plan, and handoff, plus the same project-manager-style assignment block from the final answer |
42
41
  | Final answer | Short status plus a copyable project-manager-style assignment block |
43
42
 
@@ -144,7 +143,7 @@ This is separate from the implementation plan. It is the short assignment packet
144
143
  - implementation order summary
145
144
  - top risks and invariants
146
145
  - required verification commands
147
- - PR expectations and acceptance checklist pointer
146
+ - delivery boundary and acceptance checklist pointer
148
147
 
149
148
  Run placeholder scan over all docs. Placeholders that must be filled before commit, such as issue id after creation, must not remain.
150
149
 
@@ -217,84 +216,11 @@ rtk git push -u origin <branch>
217
216
 
218
217
  Comment on the issue with branch, commit, spec path, plan path, handoff path, and the copyable project-manager-style assignment block from the final answer. This issue comment is mandatory; do not finish with only a local final answer.
219
218
 
220
- ### 10. Create or update the pull request
219
+ ### 10. Do not create a pull request
221
220
 
222
- If the user asks for a PR, or repo convention expects a PR for the handoff branch, create or update it before the final answer.
221
+ This skill stops after the handoff docs are committed, pushed to the remote issue branch, and linked from the GitHub issue comment. Do not create or update a PR for the docs-only handoff branch as part of this workflow, even when the repository's normal implementation flow expects PRs.
223
222
 
224
- PR body must be written to a temporary markdown file and passed with `--body-file "$pr_body_file"`. Never use `gh pr create --body-file -`, `gh pr edit --body-file -`, or `--body "multi-line text"` for PR content. Do not trust `ok` or a returned URL as proof that the body was saved; only trust a read-back from `gh pr view --json body`.
225
-
226
- Use the repository PR template. When this repo's template is the standard git workflow template, the body must include all of these headings exactly:
227
-
228
- - `## 变更目的`
229
- - `## 主要改动和解决的问题`
230
- - `## 遗留的问题`
231
- - `## 已做的验证`
232
- - `## PR 遗留未做的`
233
- - `## 关联`
234
-
235
- The body must also include:
236
-
237
- - `Closes: #<issue-id>`
238
- - branch name
239
- - commit sha or subject
240
- - spec path
241
- - plan path
242
- - handoff path
243
- - verification commands and results, or an explicit docs-only note
244
-
245
- Example shape:
246
-
247
- ```bash
248
- pr_body_file="$(mktemp "${TMPDIR:-/tmp}/handoff-pr-body.XXXXXX.md")"
249
- cat > "$pr_body_file" <<'MSG'
250
- ## 变更目的
251
- <why this handoff exists and which approved design it packages>
252
-
253
- ## 主要改动和解决的问题
254
- - 新增设计文档:`<spec-path>`
255
- - 新增实施计划:`<plan-path>`
256
- - 新增交接文档:`<handoff-path>`
257
- - 分支:`<branch>`
258
- - 提交:`<sha> <subject>`
259
-
260
- ## 遗留的问题
261
- - 无,或列出明确遗留风险和处理建议。
262
-
263
- ## 已做的验证
264
- - `rtk git diff --cached --check`:通过
265
- - `rtk rg -n "TBD|TODO|待定|占位|\\.\\.\\." <spec-path> <plan-path> <handoff-path>`:无真实占位
266
- - 文档交付,无需运行构建或测试。
267
-
268
- ## PR 遗留未做的
269
- - 无,或列出需要后续实现 PR 完成的事项。
270
-
271
- ## 关联
272
- Closes: #<issue-id>
273
- MSG
274
-
275
- pr_url="$(rtk gh pr create --base main --title 'docs: add <topic> handoff' --body-file "$pr_body_file")"
276
- pr_number="$(rtk gh pr view "$pr_url" --json number --jq '.number')"
277
- pr_body="$(rtk gh pr view "$pr_number" --json body --jq '.body')"
278
- test -n "$pr_body"
279
- for heading in \
280
- "## 变更目的" \
281
- "## 主要改动和解决的问题" \
282
- "## 遗留的问题" \
283
- "## 已做的验证" \
284
- "## PR 遗留未做的" \
285
- "## 关联"; do
286
- printf '%s\n' "$pr_body" | grep -F "$heading" >/dev/null
287
- done
288
- printf '%s\n' "$pr_body" | grep -F "Closes: #<issue-id>" >/dev/null
289
- printf '%s\n' "$pr_body" | grep -F "<branch>" >/dev/null
290
- printf '%s\n' "$pr_body" | grep -F "<sha>" >/dev/null
291
- printf '%s\n' "$pr_body" | grep -F "<spec-path>" >/dev/null
292
- printf '%s\n' "$pr_body" | grep -F "<plan-path>" >/dev/null
293
- printf '%s\n' "$pr_body" | grep -F "<handoff-path>" >/dev/null
294
- rm -f "$pr_body_file"
295
- ```
296
-
297
- If a PR already exists, use the same temp-file path with `rtk gh pr edit <pr-number> --body-file "$pr_body_file"`, then run the same read-back validation. If any heading, issue link, doc path, branch, commit, or verification evidence is missing, fix the temp body file, edit again, and read back again before continuing.
223
+ If the user explicitly asks for a PR, treat that as a separate follow-up workflow after this handoff is complete.
298
224
 
299
225
  ### 11. Final verification
300
226
 
@@ -308,8 +234,6 @@ rtk git rev-parse --abbrev-ref --symbolic-full-name @{u}
308
234
 
309
235
  Report actual state. If no tests/builds were run because this is docs-only, say that.
310
236
 
311
- If a PR was created or updated, read back the PR body and verify it is non-empty, follows the repo template headings, includes `Closes: #<issue-id>`, and contains the branch, commit, spec path, plan path, handoff path, and verification evidence. If `gh pr create` or `gh pr edit` reported success but read-back is empty or incomplete, repair the PR with a temp body file and read it back again before claiming completion.
312
-
313
237
  Read back the issue comments and verify that the latest handoff comment contains the branch, commit, spec path, plan path, handoff path, and the same assignment block shown in the final answer. If `gh issue comment` failed, the comment is missing, or the readback does not match the final assignment block, fix that before claiming completion.
314
238
 
315
239
  ## Final Answer Template
@@ -320,7 +244,6 @@ Keep it short, then include this copyable block:
320
244
  已准备好交接资料:
321
245
 
322
246
  - Issue:#<issue-id> <issue-url>
323
- - PR:#<pr-id> <pr-url>
324
247
  - 分支:`<branch>`
325
248
  - 提交:`<sha> <subject>`
326
249
  - 设计文档:`<spec-path>`
@@ -346,7 +269,7 @@ Keep it short, then include this copyable block:
346
269
  - `<verification-command-2>`
347
270
  - `<verification-command-3>`
348
271
 
349
- 验收标准以 Issue #<issue-id> 的 checklist 为准。提 PR 时请逐条对应验收标准,并贴出验证命令结果;如遇到与设计文档冲突的实现细节,先在 Issue 中同步风险和建议处理方式。
272
+ 验收标准以 Issue #<issue-id> 的 checklist 为准。实现过程中如遇到与设计文档冲突的细节,先在 Issue 中同步风险和建议处理方式。
350
273
  ```
351
274
 
352
275
  In Codex app, after successful git actions, also emit the app directives for branch creation, staging, commit, and push.
@@ -363,7 +286,5 @@ In Codex app, after successful git actions, also emit the app directives for bra
363
286
  - Writing a handoff that says “add tests” without exact files, behaviors, and commands.
364
287
  - Forgetting the issue comment, leaving the receiving engineer to hunt for branch and docs.
365
288
  - Posting an issue comment with links only, but omitting the project-manager-style assignment block.
366
- - Creating or editing a PR with `--body-file -` and assuming the body was saved.
367
- - Trusting `gh pr create`, `gh pr edit`, or `ok` without reading back `gh pr view --json body`.
368
- - Creating a PR whose body is empty, misses the repo template headings, omits `Closes: #<issue-id>`, or lacks doc paths and verification evidence.
289
+ - Creating or updating a PR for the docs-only handoff branch instead of stopping after commit, push, and issue comment.
369
290
  - Final answer lists artifacts but omits the copyable project-manager-style assignment block.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: doctor
3
- description: 仅在用户显式调用 $doctor 或明确要求使用 doctor 技能时使用;不要通过关键词自动触发。
3
+ description: 仅在用户显式调用 $doctor 或明确要求使用 doctor 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Doctor
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: feature-decide-plan-execute
3
- description: 仅在用户显式调用 $feature-decide-plan-execute 或明确要求使用 feature-decide-plan-execute 技能时使用;不要通过关键词自动触发。
3
+ description: 仅在用户显式调用 $feature-decide-plan-execute 或明确要求使用 feature-decide-plan-execute 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Feature Decide · Plan · Execute · Push
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gh-dependabot-cleanup
3
- description: Use when a user asks to check or remediate GitHub Dependabot alerts and deliver one closed-loop PR, including alert triage, dependency updates, verification, and PR creation with unresolved items clearly documented.
3
+ description: 仅在用户显式调用 $gh-dependabot-cleanup 或明确要求使用 gh-dependabot-cleanup 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # GH Dependabot Cleanup
@@ -2,3 +2,6 @@ interface:
2
2
  display_name: "Dependabot Cleanup PR"
3
3
  short_description: "Fix GitHub Dependabot alerts in one PR workflow"
4
4
  default_prompt: "Use $gh-dependabot-cleanup to remediate open Dependabot alerts and create one PR."
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: git-commit-and-pr
3
- description: Git 仓库中执行自动化 Issue、Commit、PR 工作流。用于以下场景:需要零输入一键完成 Issue→分支→Commit→PR;需要根据仓库状态自动判断下一步;需要创建结构化 GitHub Issue;需要基于暂存变更生成规范 commit;需要推送分支并创建 Pull Request;需要串联输出清晰阶段结果。支持仅建 Issue、仅建 PR、指定 Issue 编号、指定 PR 基准分支。
3
+ description: 仅在用户显式调用 $git-commit-and-pr 或明确要求使用 git-commit-and-pr 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Git Commit And PR
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: git-release
3
- description: 仅在用户显式调用 $git-release 或明确要求使用 git-release 技能时使用;不要通过关键词自动触发。
3
+ description: 仅在用户显式调用 $git-release 或明确要求使用 git-release 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Git Release
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: issues-batch-deliver
3
- description: 仅在用户显式调用 $issues-batch-deliver 或明确要求使用 issues-batch-deliver 技能时使用;不要通过关键词自动触发。
3
+ description: 仅在用户显式调用 $issues-batch-deliver 或明确要求使用 issues-batch-deliver 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Issues Batch Deliver — 批量 Issue 编排器
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: online-debug-guard
3
- description: 在线调试安全护栏技能。用于排查数据库、Redis、服务配置等线上或准线上问题时,强制执行环境识别、模式校验和本地环境文件存在性检查,防止误连误操作。触发场景:用户提到在线调试、连库排查、查 Redis、生产环境排障、按指定环境排查问题。
3
+ description: 仅在用户显式调用 $online-debug-guard 或明确要求使用 online-debug-guard 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # 在线调试安全护栏
@@ -1,4 +1,7 @@
1
1
  interface:
2
2
  display_name: "Online Debug Guard"
3
3
  short_description: "Guarded workflow for environment-aware online debugging"
4
- default_prompt: "执行安全的在线调试流程,先判定环境与模式,再执行只读排查。"
4
+ default_prompt: "使用 $online-debug-guard 执行安全的在线调试流程,先判定环境与模式,再执行只读排查。"
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: pr-train-ship
3
- description: 仅在用户显式调用 $pr-train-ship 或明确要求使用 pr-train-ship 技能时使用;不要通过关键词自动触发。
3
+ description: 仅在用户显式调用 $pr-train-ship 或明确要求使用 pr-train-ship 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # PR Train Ship — PR 审查 · 修复 · 自动合并
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: stagewise-ui-debugging
3
- description: Use when comparing the ai-monorepo Stagewise design system with the front app for UI alignment, visual QA, responsive layout checks, DOM inspection, or design draft debugging.
3
+ description: 仅在用户显式调用 $stagewise-ui-debugging 或明确要求使用 stagewise-ui-debugging 技能时使用;不要通过关键词、任务类型或上下文自动触发。
4
4
  ---
5
5
 
6
6
  # Stagewise UI 调试