@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 +1 -1
- package/skills/backend-audit-fixer/SKILL.md +1 -1
- package/skills/create-issue/SKILL.md +1 -1
- package/skills/delivering-design-handoff/SKILL.md +7 -86
- package/skills/doctor/SKILL.md +1 -1
- package/skills/feature-decide-plan-execute/SKILL.md +1 -1
- package/skills/gh-dependabot-cleanup/SKILL.md +1 -1
- package/skills/gh-dependabot-cleanup/agents/openai.yaml +3 -0
- package/skills/git-commit-and-pr/SKILL.md +1 -1
- package/skills/git-release/SKILL.md +1 -1
- package/skills/issues-batch-deliver/SKILL.md +1 -1
- package/skills/online-debug-guard/SKILL.md +1 -1
- package/skills/online-debug-guard/agents/openai.yaml +4 -1
- package/skills/pr-train-ship/SKILL.md +1 -1
- package/skills/stagewise-ui-debugging/SKILL.md +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: create-issue
|
|
3
|
-
description: 仅在用户显式调用
|
|
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:
|
|
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
|
-
-
|
|
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.
|
|
219
|
+
### 10. Do not create a pull request
|
|
221
220
|
|
|
222
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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.
|
package/skills/doctor/SKILL.md
CHANGED
|
@@ -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:
|
|
3
|
+
description: 仅在用户显式调用 $gh-dependabot-cleanup 或明确要求使用 gh-dependabot-cleanup 技能时使用;不要通过关键词、任务类型或上下文自动触发。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# GH Dependabot Cleanup
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: git-commit-and-pr
|
|
3
|
-
description:
|
|
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: 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:
|
|
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: stagewise-ui-debugging
|
|
3
|
-
description:
|
|
3
|
+
description: 仅在用户显式调用 $stagewise-ui-debugging 或明确要求使用 stagewise-ui-debugging 技能时使用;不要通过关键词、任务类型或上下文自动触发。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Stagewise UI 调试
|