ultra-builder-pro-cli 0.10.0 → 0.12.1
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/.ultra-template/specs/architecture.md +54 -223
- package/.ultra-template/specs/discovery.md +34 -231
- package/.ultra-template/specs/product.md +44 -200
- package/.ultra-template/tasks/contexts/TEMPLATE.md +36 -0
- package/.ultra-template/tasks/tasks.json +6 -0
- package/CHANGELOG.md +86 -1
- package/README.md +21 -9
- package/adapters/_shared/codex-assets.cjs +24 -342
- package/adapters/_shared/handbook.cjs +4 -3
- package/adapters/_shared/runtime-assets.cjs +24 -0
- package/adapters/_shared/tests/handbook.test.cjs +4 -0
- package/adapters/_shared/tests/runtime-assets.test.cjs +11 -4
- package/adapters/claude.js +28 -5
- package/adapters/kimi.js +15 -138
- package/adapters/opencode.js +22 -49
- package/adapters/tests/claude.test.cjs +22 -8
- package/adapters/tests/codex.test.cjs +21 -8
- package/adapters/tests/kimi-hook.test.cjs +1 -1
- package/adapters/tests/kimi.test.cjs +11 -11
- package/adapters/tests/opencode.test.cjs +47 -8
- package/agents/code-reviewer.md +24 -85
- package/agents/debugger.md +30 -132
- package/agents/review-code.md +24 -104
- package/agents/review-comments.md +20 -83
- package/agents/review-coordinator.md +40 -137
- package/agents/review-design.md +21 -118
- package/agents/review-errors.md +22 -70
- package/agents/review-spec.md +36 -0
- package/agents/review-tests.md +20 -76
- package/agents/tdd-runner.md +26 -84
- package/commands/learn.md +5 -36
- package/commands/ultra-change.md +5 -43
- package/commands/ultra-deliver.md +4 -46
- package/commands/ultra-dev.md +4 -48
- package/commands/ultra-doctor.md +4 -30
- package/commands/ultra-init.md +5 -47
- package/commands/ultra-plan.md +5 -48
- package/commands/ultra-research.md +5 -54
- package/commands/ultra-status.md +5 -44
- package/commands/ultra-test.md +5 -45
- package/commands/ultra-think.md +5 -40
- package/docs/AGENT-CONTEXT.md +16 -8
- package/docs/ARCHITECTURE.md +32 -5
- package/docs/PLAN.zh-CN.md +8 -6
- package/docs/ROADMAP.md +5 -3
- package/docs/RUNTIME-COMPAT-MATRIX.md +8 -5
- package/docs/SKILL-AUTHORING.md +75 -0
- package/docs/STATE-DB-ACCESS-POLICY.md +17 -11
- package/docs/USER-HANDBOOK-CONTRACT.md +8 -5
- package/hooks/README.md +4 -3
- package/hooks/adapters/codex.py +1 -1
- package/hooks/adapters/kimi.py +1 -1
- package/hooks/context_spine.py +120 -16
- package/hooks/health_check.py +11 -0
- package/hooks/pre_stop_check.py +6 -5
- package/mcp-server/lib/baseline-workflow.cjs +415 -0
- package/mcp-server/lib/baseline-workflow.test.cjs +225 -0
- package/mcp-server/lib/change-workflow.cjs +24 -27
- package/mcp-server/lib/change-workflow.test.cjs +202 -6
- package/mcp-server/lib/context-spine.cjs +74 -9
- package/mcp-server/lib/context-spine.test.cjs +15 -0
- package/mcp-server/lib/doctor.cjs +14 -0
- package/mcp-server/lib/doctor.test.cjs +25 -1
- package/mcp-server/lib/init-project.cjs +49 -14
- package/mcp-server/lib/provider-refs.cjs +42 -0
- package/mcp-server/lib/spec-learning.test.cjs +5 -0
- package/mcp-server/lib/state-db.cjs +63 -4
- package/mcp-server/lib/state-db.test.cjs +8 -3
- package/mcp-server/server.cjs +48 -3
- package/mcp-server/tests/init-project.test.cjs +54 -8
- package/mcp-server/tests/server-contract.test.cjs +99 -2
- package/mcp-server/tests/state-db.test.cjs +11 -2
- package/package.json +3 -2
- package/skills/cc-collab/SKILL.md +16 -18
- package/skills/code-review-expert/SKILL.md +39 -114
- package/skills/code-review-expert/references/correctness-reliability.md +30 -0
- package/skills/code-review-expert/references/design-boundaries.md +26 -0
- package/skills/code-review-expert/references/removal-plan.md +17 -45
- package/skills/codex-collab/SKILL.md +23 -28
- package/skills/codex-collab/evals/evals.json +18 -23
- package/skills/integration-rules/SKILL.md +28 -67
- package/skills/learn/SKILL.md +46 -106
- package/skills/security-rules/SKILL.md +34 -56
- package/skills/testing-rules/SKILL.md +28 -52
- package/skills/ultra-change/SKILL.md +68 -114
- package/skills/ultra-deliver/SKILL.md +58 -86
- package/skills/ultra-dev/SKILL.md +46 -105
- package/skills/ultra-doctor/SKILL.md +45 -72
- package/skills/ultra-init/SKILL.md +62 -147
- package/skills/ultra-init/references/brownfield-adoption.md +65 -0
- package/skills/ultra-plan/SKILL.md +56 -89
- package/skills/ultra-research/SKILL.md +64 -152
- package/skills/ultra-research/references/architecture.md +38 -0
- package/skills/ultra-research/references/problem-product.md +39 -0
- package/skills/ultra-research/references/quality-delivery.md +34 -0
- package/skills/ultra-research/references/synthesis.md +38 -0
- package/skills/ultra-research/references/users-scope.md +40 -0
- package/skills/ultra-review/SKILL.md +54 -98
- package/skills/ultra-review/references/unified-schema.md +76 -101
- package/skills/ultra-review/scripts/review_wait.py +242 -77
- package/skills/ultra-status/SKILL.md +41 -56
- package/skills/ultra-test/SKILL.md +37 -72
- package/skills/ultra-think/SKILL.md +43 -102
- package/skills/ultra-verify/SKILL.md +44 -84
- package/skills/ultra-verify/evals/evals.json +24 -27
- package/spec/cli-protocol.md +4 -0
- package/spec/mcp-tools.yaml +223 -4
- package/spec/schemas/command-manifest.schema.json +7 -25
- package/spec/schemas/mcp-tools.schema.json +1 -1
- package/spec/schemas/skill-manifest.schema.json +9 -79
- package/spec/schemas/state-db.sql +33 -2
- package/ultra-tools/commands/status.cjs +20 -2
- package/ultra-tools/commands/task.cjs +4 -1
- package/ultra-tools/status-command.test.cjs +20 -0
- package/ultra-tools/system-command.test.cjs +5 -0
- package/skills/code-review-expert/references/code-quality-checklist.md +0 -112
- package/skills/code-review-expert/references/integration-checklist.md +0 -46
- package/skills/code-review-expert/references/security-checklist.md +0 -100
- package/skills/code-review-expert/references/solid-checklist.md +0 -65
- package/skills/ultra-research/steps/step-00-problem-validation.md +0 -154
- package/skills/ultra-research/steps/step-01-opportunity-discovery.md +0 -172
- package/skills/ultra-research/steps/step-02-market-assessment.md +0 -195
- package/skills/ultra-research/steps/step-03-competitive-landscape.md +0 -197
- package/skills/ultra-research/steps/step-04-product-strategy.md +0 -196
- package/skills/ultra-research/steps/step-05-assumptions-validation.md +0 -234
- package/skills/ultra-research/steps/step-10-user-personas.md +0 -169
- package/skills/ultra-research/steps/step-11-user-scenarios.md +0 -181
- package/skills/ultra-research/steps/step-20-user-stories.md +0 -156
- package/skills/ultra-research/steps/step-21-features-scope.md +0 -157
- package/skills/ultra-research/steps/step-22-success-metrics.md +0 -195
- package/skills/ultra-research/steps/step-30-architecture-context.md +0 -154
- package/skills/ultra-research/steps/step-31-solution-strategy.md +0 -172
- package/skills/ultra-research/steps/step-32-building-blocks.md +0 -188
- package/skills/ultra-research/steps/step-40-deployment.md +0 -123
- package/skills/ultra-research/steps/step-41-quality-risks.md +0 -135
- package/skills/ultra-research/steps/step-99-synthesis.md +0 -188
- package/skills/ultra-review/scripts/review_verdict_update.py +0 -99
package/agents/tdd-runner.md
CHANGED
|
@@ -1,27 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tdd-runner
|
|
3
|
-
description:
|
|
4
|
-
Test execution and analysis specialist. Runs test suites, analyzes failures,
|
|
5
|
-
reports results. Use to isolate verbose test output from main conversation.
|
|
6
|
-
Proactive trigger: "run tests", "test suite", "check coverage".
|
|
7
|
-
|
|
8
|
-
<example>
|
|
9
|
-
Context: User wants to run tests after code changes
|
|
10
|
-
user: "Run the test suite and tell me what's failing"
|
|
11
|
-
assistant: "I'll use the tdd-runner agent to execute tests and analyze results."
|
|
12
|
-
<commentary>
|
|
13
|
-
Test execution produces verbose output - isolate in subagent context.
|
|
14
|
-
</commentary>
|
|
15
|
-
</example>
|
|
16
|
-
|
|
17
|
-
<example>
|
|
18
|
-
Context: Checking test coverage
|
|
19
|
-
user: "What's our test coverage looking like?"
|
|
20
|
-
assistant: "I'll use the tdd-runner agent to run coverage analysis."
|
|
21
|
-
<commentary>
|
|
22
|
-
Coverage reports are large - subagent filters to relevant summary.
|
|
23
|
-
</commentary>
|
|
24
|
-
</example>
|
|
3
|
+
description: Run the repository's exact test or coverage command, isolate actionable failures, and return concise execution evidence without editing files.
|
|
25
4
|
tools: Bash, Read, Grep, Glob
|
|
26
5
|
model: opus
|
|
27
6
|
maxTurns: 20
|
|
@@ -29,65 +8,28 @@ skills:
|
|
|
29
8
|
- testing-rules
|
|
30
9
|
---
|
|
31
10
|
|
|
32
|
-
# Test
|
|
33
|
-
|
|
34
|
-
Run tests
|
|
35
|
-
|
|
36
|
-
##
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
## Mock Violation Detection
|
|
59
|
-
|
|
60
|
-
Scan test files for forbidden patterns:
|
|
61
|
-
- `jest.fn()` on Repository/Service/Domain
|
|
62
|
-
- `class InMemoryRepository` / `class MockXxx` / `class FakeXxx`
|
|
63
|
-
- `jest.mock('../services/X')`
|
|
64
|
-
- `it.skip('...database...')`
|
|
65
|
-
|
|
66
|
-
## Output Format
|
|
67
|
-
|
|
68
|
-
```markdown
|
|
69
|
-
## Test Results
|
|
70
|
-
|
|
71
|
-
### Summary
|
|
72
|
-
- Total: X | Pass: X | Fail: X | Skip: X
|
|
73
|
-
- Duration: Xs
|
|
74
|
-
- Coverage: X% (if available)
|
|
75
|
-
|
|
76
|
-
### Failures
|
|
77
|
-
#### {test name}
|
|
78
|
-
**File**: `path:line`
|
|
79
|
-
**Error**: {concise error message}
|
|
80
|
-
**Cause**: {likely root cause}
|
|
81
|
-
|
|
82
|
-
### Mock Violations (if any)
|
|
83
|
-
- `file:line` - {violation description}
|
|
84
|
-
|
|
85
|
-
### Verdict
|
|
86
|
-
ALL PASS / X FAILURES NEED ATTENTION
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
## Handoff
|
|
90
|
-
|
|
91
|
-
Return reusable test patterns, common failure causes, and framework quirks to the
|
|
92
|
-
parent agent as explicit evidence. Do not create or update a private Ultra memory
|
|
93
|
-
store; persistent memory belongs to the host's separately installed provider.
|
|
11
|
+
# Test execution specialist
|
|
12
|
+
|
|
13
|
+
Run tests and analyze their evidence. This assignment is read-only.
|
|
14
|
+
|
|
15
|
+
## Workflow
|
|
16
|
+
|
|
17
|
+
1. Resolve the requested scope, checkout, repository guidance, and canonical command
|
|
18
|
+
from package scripts, CI configuration, or framework files. Ask the parent to
|
|
19
|
+
resolve ambiguity when different commands prove different contracts.
|
|
20
|
+
2. Run the exact command without weakening flags, skipping failures, or changing test
|
|
21
|
+
configuration. Capture exit code, duration, pass/fail/skip counts, and coverage only
|
|
22
|
+
when the runner reports it.
|
|
23
|
+
3. For each failure, identify the first useful error, tight source or test location,
|
|
24
|
+
whether the failure reproduces, and the most likely boundary that is wrong. Separate
|
|
25
|
+
product defects, test defects, environment failures, and flaky or nondeterministic
|
|
26
|
+
evidence.
|
|
27
|
+
4. Evaluate test doubles only when relevant to the failed or requested behavior. Flag
|
|
28
|
+
one only when it bypasses the contract under test or diverges materially from the
|
|
29
|
+
production boundary.
|
|
30
|
+
5. Return a concise summary with the exact command, exit code, counts, actionable
|
|
31
|
+
failures, environment limitations, and residual coverage gaps. Do not paste the full
|
|
32
|
+
runner transcript unless the parent requests it.
|
|
33
|
+
|
|
34
|
+
Do not edit tests, production code, task state, or projections. Do not claim a green
|
|
35
|
+
suite when the command did not complete successfully.
|
package/commands/learn.md
CHANGED
|
@@ -1,41 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint: "[
|
|
4
|
-
allowed-tools: Read, Write, Grep, Glob, AskUserQuestion
|
|
5
|
-
model: opus
|
|
2
|
+
description: Capture one verified reusable workflow as a portable user skill after explicit approval
|
|
3
|
+
argument-hint: "[skill-name]"
|
|
6
4
|
workflow-ref: "@skills/learn/SKILL.md"
|
|
7
5
|
---
|
|
8
6
|
|
|
9
|
-
#
|
|
7
|
+
# Capture a reusable skill
|
|
10
8
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
扫当前会话挑一个最值得保存的「可复用模式」,以 Speculation 级别写到
|
|
14
|
-
`~/.claude/skills/learned-<slug>-unverified/SKILL.md`。写入前必问用户确认。
|
|
15
|
-
|
|
16
|
-
## 参数
|
|
17
|
-
|
|
18
|
-
| 位 | 含义 | 缺省 |
|
|
19
|
-
|----|------|------|
|
|
20
|
-
| `$1` | pattern 文件名建议 slug | 由 skill 自动生成 |
|
|
21
|
-
|
|
22
|
-
## Workflow
|
|
23
|
-
|
|
24
|
-
完整 5 步见 `@skills/learn/SKILL.md`(review → pick one → draft → 用户确认 → write)。
|
|
25
|
-
|
|
26
|
-
**命令入口做的事**:
|
|
27
|
-
1. 回溯会话找可提炼的模式(错误修复 / 调试套路 / workaround / 项目级惯例)
|
|
28
|
-
2. 选一个价值最高的(不是多个 — 一个文件一个模式)
|
|
29
|
-
3. 按模板起草 → 直接询问用户选择 Save/Edit/Cancel
|
|
30
|
-
4. 保存到 `~/.claude/skills/learned-<slug>-unverified/SKILL.md`(不覆盖已存在目录)
|
|
31
|
-
|
|
32
|
-
## 用法
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
/learn # 自动挑
|
|
36
|
-
/learn supabase-rls-debug # 指定文件名 slug
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## 下一步
|
|
40
|
-
|
|
41
|
-
用户以后 review 后手动去掉 `_unverified` 后缀升为 Inference;多次成功使用后升为 Fact。
|
|
9
|
+
Read and follow `@skills/learn/SKILL.md` with `$ARGUMENTS` as optional naming guidance.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
package/commands/ultra-change.md
CHANGED
|
@@ -1,48 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint: "[change-id
|
|
4
|
-
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion
|
|
5
|
-
model: opus
|
|
2
|
+
description: Open or resume a bounded continuous change with linked authoritative tasks and context
|
|
3
|
+
argument-hint: "[change-id-or-title] [quick|standard|major|incident]"
|
|
6
4
|
workflow-ref: "@skills/ultra-change/SKILL.md"
|
|
7
|
-
mcp_tools_required:
|
|
8
|
-
- change.create
|
|
9
|
-
- change.update
|
|
10
|
-
- change.get
|
|
11
|
-
- change.list
|
|
12
|
-
- change.context
|
|
13
|
-
- task.create
|
|
14
|
-
- task.list
|
|
15
5
|
---
|
|
16
6
|
|
|
17
|
-
#
|
|
7
|
+
# Open or resume a change
|
|
18
8
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
把初始交付后的日常修复、功能、重构或事故变成一个持续可追踪的 change,避免
|
|
22
|
-
代码、spec、测试证据和项目上下文逐步漂移。
|
|
23
|
-
|
|
24
|
-
## Workflow
|
|
25
|
-
|
|
26
|
-
完整流程见 `@skills/ultra-change/SKILL.md`:
|
|
27
|
-
|
|
28
|
-
1. 先查 active/blocked change,匹配则恢复,避免重复创建。
|
|
29
|
-
2. 按 `quick / standard / major / incident` 分类并声明 docs impact。
|
|
30
|
-
3. 调 `change.create`,为 change 创建至少一个带 `change_id` 的 task。
|
|
31
|
-
4. standard/major 写 delta + plan;incident 完成结构化 `diagnosis.md`。
|
|
32
|
-
5. 调 `change.context` 编译最小上下文;incident 先走 debugger 诊断切片。
|
|
33
|
-
6. 路由到 `/ultra-dev`、`/ultra-test`、`/ultra-review`、`/ultra-deliver`。
|
|
34
|
-
|
|
35
|
-
Memory 与代码图谱只允许以外部 provider 元数据引用出现;本命令不保存 provider
|
|
36
|
-
正文,也不自动刷新外部 provider。
|
|
37
|
-
|
|
38
|
-
## 用法
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
/ultra-change auth-timeout quick
|
|
42
|
-
/ultra-change billing-redesign major
|
|
43
|
-
/ultra-change incident-2026-07-17 incident
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## 下一步
|
|
47
|
-
|
|
48
|
-
输出会给出 change id、artifact root、linked task 与准确的下一个 Ultra workflow。
|
|
9
|
+
Read and follow `@skills/ultra-change/SKILL.md`, using `$ARGUMENTS` to identify and classify the change.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
|
@@ -1,52 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: Converge
|
|
2
|
+
description: Converge current evidence and specification learning into an archived or released baseline
|
|
3
3
|
argument-hint: "[version-type]"
|
|
4
|
-
allowed-tools: Task, Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion
|
|
5
|
-
model: opus
|
|
6
4
|
workflow-ref: "@skills/ultra-deliver/SKILL.md"
|
|
7
|
-
cli_fallback: "direct user interaction"
|
|
8
|
-
mcp_tools_required:
|
|
9
|
-
- change.list
|
|
10
|
-
- change.get
|
|
11
|
-
- change.context
|
|
12
|
-
- change.converge
|
|
13
|
-
- change.archive
|
|
14
5
|
---
|
|
15
6
|
|
|
16
|
-
#
|
|
7
|
+
# Converge and deliver
|
|
17
8
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
`/ultra-test` 绿灯后,把 active delta 合并回 baseline,重跑发布证据,调用
|
|
21
|
-
`change.converge` 与 `change.archive`,再完成版本号、tag、push 和 delivery report。
|
|
22
|
-
|
|
23
|
-
## 参数
|
|
24
|
-
|
|
25
|
-
| 位 | 含义 | 缺省 |
|
|
26
|
-
|----|------|------|
|
|
27
|
-
| `$1` | 版本跳跃(`patch`/`minor`/`major`) | 按 commit 类型自动判断 |
|
|
28
|
-
|
|
29
|
-
## Workflow
|
|
30
|
-
|
|
31
|
-
完整流程见 `@skills/ultra-deliver/SKILL.md`(绑定 change → baseline reconciliation →
|
|
32
|
-
build/test → release commit → context/convergence/archive → tag/push → report)。
|
|
33
|
-
|
|
34
|
-
**命令入口做的事**:
|
|
35
|
-
1. 读 `.ultra/test-report.json` 验 `passed=true` + `git_commit === HEAD`
|
|
36
|
-
2. `git status` 清洁检查;不干净 → 通过 Host 原生提问界面选处理方式
|
|
37
|
-
3. 有 active change 时合并 delta、刷新 context,并通过确定性 convergence gate
|
|
38
|
-
4. archive 完成后才允许 tag/push
|
|
39
|
-
5. 写带 change id、archive path、baseline updates 的 delivery report
|
|
40
|
-
|
|
41
|
-
## 用法
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
/ultra-deliver # 自动判断版本号
|
|
45
|
-
/ultra-deliver major # 强制 major bump(breaking changes)
|
|
46
|
-
/ultra-deliver patch # 强制 patch
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## 下一步
|
|
50
|
-
|
|
51
|
-
部署到 Railway / Vercel,或在 release channel 广播。`delivery-report.json` 里
|
|
52
|
-
`pushed=true` 后即可视作发布完成。
|
|
9
|
+
Read and follow `@skills/ultra-deliver/SKILL.md`, using `$ARGUMENTS` only for an explicitly requested version policy.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
package/commands/ultra-dev.md
CHANGED
|
@@ -1,54 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Execute one authoritative Ultra task through implementation, verification, and review
|
|
3
3
|
argument-hint: "[task-id]"
|
|
4
|
-
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, Task, AskUserQuestion, Skill
|
|
5
|
-
model: opus
|
|
6
4
|
workflow-ref: "@skills/ultra-dev/SKILL.md"
|
|
7
|
-
mcp_tools_required:
|
|
8
|
-
- task.update
|
|
9
|
-
- task.get
|
|
10
|
-
- task.list
|
|
11
|
-
- change.get
|
|
12
|
-
- change.context
|
|
13
5
|
---
|
|
14
6
|
|
|
15
|
-
#
|
|
7
|
+
# Execute one Ultra task
|
|
16
8
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
把一个 task 从 `pending` 推到 `completed`:进入 feature 分支 → RED/GREEN/REFACTOR
|
|
20
|
-
TDD → 质量门 → `/ultra-review all` → 完成 → commit/merge。**单写**:状态只通过
|
|
21
|
-
MCP `task.update` 改一次;projector 自动更新 tasks.json + context-md frontmatter。
|
|
22
|
-
MCP 状态工具失败时 fail closed;`LEGACY_STATE_MIGRATION_REQUIRED` 只允许先跑
|
|
23
|
-
v4.4→v4.5 迁移,绝不从 `tasks.json` 回退或直接改投影。
|
|
24
|
-
|
|
25
|
-
## 参数
|
|
26
|
-
|
|
27
|
-
| 位 | 含义 | 缺省 |
|
|
28
|
-
|----|------|------|
|
|
29
|
-
| `$1` | task id | 拓扑序第一个 `pending` |
|
|
30
|
-
|
|
31
|
-
## Workflow
|
|
32
|
-
|
|
33
|
-
完整 8 步流程见 `@skills/ultra-dev/SKILL.md`(Resume Check → Design Gate → 选 task →
|
|
34
|
-
状态 in_progress → 环境 → TDD → 质量门 → checkpoint → review → 完成 → commit/merge → report)。
|
|
35
|
-
|
|
36
|
-
**命令入口做的事**:
|
|
37
|
-
1. 读 `.ultra/workflow-state.json` 决定新跑 vs resume
|
|
38
|
-
2. 首跑通过 Host 原生提问触发 Design Approval Gate
|
|
39
|
-
3. 驱动 skill 走 TDD + review 循环;状态仅通过 MCP `task.update`
|
|
40
|
-
4. task 有 `change_id` 时把需求变化写进 active delta,并用 `change.context` 刷新上下文
|
|
41
|
-
5. Step 4.5 review 通过 `/ultra-review` 和 Host 原生 subagent 执行
|
|
42
|
-
6. Step 4.4 pre-review checkpoint 写入 workflow-state.json,不依赖 `/compact`
|
|
43
|
-
|
|
44
|
-
## 用法
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
/ultra-dev # 自动选下一个 pending task
|
|
48
|
-
/ultra-dev 3 # 直接做 task 3
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## 下一步
|
|
52
|
-
|
|
53
|
-
单个 task 完成后自动提示下一个 `/ultra-dev`;所有 Walking Skeleton +
|
|
54
|
-
critical-path task 完成 → `/ultra-test` 做交付前质量审计。
|
|
9
|
+
Read and follow `@skills/ultra-dev/SKILL.md`, using `$ARGUMENTS` as the optional task id.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
package/commands/ultra-doctor.md
CHANGED
|
@@ -1,36 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Diagnose Ultra state and installed-plugin health with optional explicit repair
|
|
3
3
|
argument-hint: "[--repair]"
|
|
4
|
-
allowed-tools: Read, Bash
|
|
5
|
-
model: opus
|
|
6
4
|
workflow-ref: "@skills/ultra-doctor/SKILL.md"
|
|
7
|
-
mcp_tools_required:
|
|
8
|
-
- system.doctor
|
|
9
|
-
cli_fallback: "system doctor"
|
|
10
5
|
---
|
|
11
6
|
|
|
12
|
-
#
|
|
7
|
+
# Diagnose Ultra health
|
|
13
8
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
诊断 state.db、projection、incident、session 和 active change artifact 的健康状态。
|
|
17
|
-
默认只读;只有显式传入 `--repair` 才允许备份后执行机械恢复。
|
|
18
|
-
|
|
19
|
-
## Workflow
|
|
20
|
-
|
|
21
|
-
完整契约见 `@skills/ultra-doctor/SKILL.md`。
|
|
22
|
-
|
|
23
|
-
1. 默认调用 `system.doctor {"repair": false}`。
|
|
24
|
-
2. 只报告失败检查、incident、游标落后和归属边界。
|
|
25
|
-
3. `--repair` 时必须先生成 state.db 备份,再恢复 orphan、消费 staleness event、
|
|
26
|
-
重排超时中断或失败的 projection 并重新投影。
|
|
27
|
-
4. 修复后重新读取报告;仍 degraded 就明确剩余阻塞,不宣称完成。
|
|
28
|
-
|
|
29
|
-
## 用法
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
/ultra-doctor
|
|
33
|
-
/ultra-doctor --repair
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Memory 和代码图谱属于外部 provider,本命令既不收集也不修复它们。
|
|
9
|
+
Read and follow `@skills/ultra-doctor/SKILL.md`; allow repair only when `$ARGUMENTS` explicitly contains `--repair`.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
package/commands/ultra-init.md
CHANGED
|
@@ -1,52 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: Initialize
|
|
3
|
-
argument-hint:
|
|
4
|
-
allowed-tools: Read, Write, Bash, Grep, Glob, AskUserQuestion
|
|
5
|
-
model: opus
|
|
2
|
+
description: Initialize a new project or adopt an existing repository into authoritative Ultra baseline state
|
|
3
|
+
argument-hint: "[name] [type] [stack] [auto|greenfield|brownfield]"
|
|
6
4
|
workflow-ref: "@skills/ultra-init/SKILL.md"
|
|
7
|
-
mcp_tools_required:
|
|
8
|
-
- task.init_project
|
|
9
|
-
cli_fallback: "task init-project"
|
|
10
5
|
---
|
|
11
6
|
|
|
12
|
-
#
|
|
7
|
+
# Initialize or adopt an Ultra project
|
|
13
8
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
搭 `.ultra/` 骨架(specs + tasks + changes + docs + reports),初始化权威
|
|
17
|
-
`state.db`,写入带元数据的初始 `tasks.json`,并按需初始化 git。Claude Code、
|
|
18
|
-
OpenCode、Codex 三个 runtime 行为一致。
|
|
19
|
-
|
|
20
|
-
## 参数
|
|
21
|
-
|
|
22
|
-
| 位 | 含义 | 缺省 |
|
|
23
|
-
|----|------|------|
|
|
24
|
-
| `$1` | 项目名 | 当前目录名 |
|
|
25
|
-
| `$2` | 项目类型(`web`/`api`/`cli`/`fullstack`/`other`) | 从 package 文件识别 |
|
|
26
|
-
| `$3` | 技术栈(逗号分隔) | 从 package 文件识别 |
|
|
27
|
-
| `$4` | `git` → 初始化 git | 检测已有 `.git/` 时询问 |
|
|
28
|
-
|
|
29
|
-
## Workflow
|
|
30
|
-
|
|
31
|
-
完整流程见 `@skills/ultra-init/SKILL.md`(4 步:状态检测 → 参数补全 →
|
|
32
|
-
`task.init_project` 拉起骨架 → git 集成)。
|
|
33
|
-
|
|
34
|
-
**命令入口做的事**:
|
|
35
|
-
1. 解析 `$1-$4`,补缺省
|
|
36
|
-
2. 探测 runtime 能力:优先走 MCP `task.init_project`;不可达时退回 `ultra-tools task init-project`
|
|
37
|
-
3. 按 skill 的 4 步工作流推进
|
|
38
|
-
4. 完成后提示下一步命令
|
|
39
|
-
|
|
40
|
-
## 用法
|
|
41
|
-
|
|
42
|
-
```bash
|
|
43
|
-
/ultra-init # 交互模式(自动识别)
|
|
44
|
-
/ultra-init my-app # 带项目名
|
|
45
|
-
/ultra-init my-app api # 带类型
|
|
46
|
-
/ultra-init my-app fullstack react,postgres git # 完整 + git
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## 下一步
|
|
50
|
-
|
|
51
|
-
**CRITICAL**:跑 `/ultra-research` 做 17 步 discovery 把 spec 填满,
|
|
52
|
-
**然后**才跑 `/ultra-plan` 生成任务。直接 plan 会产出基于模糊需求的任务。
|
|
9
|
+
Read and follow `@skills/ultra-init/SKILL.md`, using `$ARGUMENTS` as optional project metadata.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
package/commands/ultra-plan.md
CHANGED
|
@@ -1,53 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint: [scope]
|
|
4
|
-
allowed-tools: Read, Write, Edit, Bash(mkdir .ultra/*), Grep, Glob, AskUserQuestion
|
|
5
|
-
model: opus
|
|
2
|
+
description: Convert validated requirements into dependency-valid Ultra tasks with bounded context and exact verification
|
|
3
|
+
argument-hint: "[scope]"
|
|
6
4
|
workflow-ref: "@skills/ultra-plan/SKILL.md"
|
|
7
|
-
mcp_tools_required:
|
|
8
|
-
- task.create
|
|
9
5
|
---
|
|
10
6
|
|
|
11
|
-
#
|
|
7
|
+
# Plan executable slices
|
|
12
8
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
把 `/ultra-research` 验证过的完整 spec 转成可执行的任务计划:先 Walking
|
|
16
|
-
Skeleton 贯穿所有层,再切 vertical slices,每 3-4 个 feature task 插一个
|
|
17
|
-
Integration Checkpoint。任务写入 state.db(MCP `task.create`),projector
|
|
18
|
-
自动生成 `.ultra/tasks/tasks.json` + contexts/*.md frontmatter。
|
|
19
|
-
|
|
20
|
-
入口先写 active `.ultra/workflow-state.json`。MCP 不可用或返回
|
|
21
|
-
`LEGACY_STATE_MIGRATION_REQUIRED` 时立即停止,提示运行
|
|
22
|
-
`ultra-tools migrate --from=4.4 --to=4.5 --source-dir <project-root>`;绝不读取或写入
|
|
23
|
-
`tasks.json` 作为回退。
|
|
24
|
-
|
|
25
|
-
## 参数
|
|
26
|
-
|
|
27
|
-
| 位 | 含义 | 缺省 |
|
|
28
|
-
|----|------|------|
|
|
29
|
-
| `$1` | scope 模式(EXPAND / SELECTIVE / HOLD / REDUCE) | 询问用户;默认 SELECTIVE |
|
|
30
|
-
|
|
31
|
-
## Workflow
|
|
32
|
-
|
|
33
|
-
完整 8 步流程见 `@skills/ultra-plan/SKILL.md`。
|
|
34
|
-
|
|
35
|
-
**命令入口做的事**:
|
|
36
|
-
1. 探测 spec 完整度 — 未填充则 block 并转 `/ultra-research`
|
|
37
|
-
2. 使用 Host 原生提问界面交互选 scope 模式
|
|
38
|
-
3. 驱动 skill 跑生成 → 依赖分析 → `task.create` 循环 → 写 context-md 正文
|
|
39
|
-
4. 跑 7 项 verification(requirement coverage / 无环 / trace_to / 复杂度等)
|
|
40
|
-
5. 输出 report + 下一步
|
|
41
|
-
|
|
42
|
-
## 用法
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
/ultra-plan # 交互模式;默认 SELECTIVE
|
|
46
|
-
/ultra-plan EXPAND # 直接进入"激进扩张"模式
|
|
47
|
-
/ultra-plan REDUCE # MVP 最小化模式
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
## 下一步
|
|
51
|
-
|
|
52
|
-
所有 CRITICAL check 过了 → `/clear` 然后 `/ultra-dev` 开始 TDD。
|
|
53
|
-
单个 task 完成后 `/ultra-status` 看进度。
|
|
9
|
+
Read and follow `@skills/ultra-plan/SKILL.md`, using `$ARGUMENTS` to select the requested scope.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
|
@@ -1,59 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint: [
|
|
4
|
-
allowed-tools: Task, Read, Write, WebSearch, WebFetch, Grep, Glob, AskUserQuestion
|
|
5
|
-
model: opus
|
|
2
|
+
description: Research unresolved product or architecture decisions and update the authoritative baseline specifications
|
|
3
|
+
argument-hint: "[scope-or-question]"
|
|
6
4
|
workflow-ref: "@skills/ultra-research/SKILL.md"
|
|
7
5
|
---
|
|
8
6
|
|
|
9
|
-
#
|
|
7
|
+
# Research a baseline
|
|
10
8
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
## How This Works
|
|
14
|
-
|
|
15
|
-
1. Read the main skill file: `skills/ultra-research/SKILL.md`
|
|
16
|
-
2. Follow the activation sequence (pre-checks → project type detection → step routing)
|
|
17
|
-
3. For each step: Read `skills/ultra-research/steps/step-{NN}-{name}.md` and follow ALL instructions
|
|
18
|
-
4. Each step writes output immediately to spec files, then presents [C] Continue gate
|
|
19
|
-
5. Only proceed to next step after user confirms [C]
|
|
20
|
-
|
|
21
|
-
## Step Sequence
|
|
22
|
-
|
|
23
|
-
| Step | File | Focus |
|
|
24
|
-
|------|------|-------|
|
|
25
|
-
| **R0: Product Discovery** | | |
|
|
26
|
-
| 00 | `step-00-problem-validation.md` | Validate the problem is real |
|
|
27
|
-
| 01 | `step-01-opportunity-discovery.md` | Map opportunity space (OST) |
|
|
28
|
-
| 02 | `step-02-market-assessment.md` | TAM/SAM/SOM sizing |
|
|
29
|
-
| 03 | `step-03-competitive-landscape.md` | Competitor analysis |
|
|
30
|
-
| 04 | `step-04-product-strategy.md` | Vision, segments, trade-offs |
|
|
31
|
-
| 05 | `step-05-assumptions-validation.md` | Risk assumptions + experiments |
|
|
32
|
-
| **R1: User & Scenario** | | |
|
|
33
|
-
| 10 | `step-10-user-personas.md` | 2-3 personas |
|
|
34
|
-
| 11 | `step-11-user-scenarios.md` | 3-5 user scenarios |
|
|
35
|
-
| **R2: Feature Definition** | | |
|
|
36
|
-
| 20 | `step-20-user-stories.md` | Stories + acceptance criteria |
|
|
37
|
-
| 21 | `step-21-features-scope.md` | MVP scope + exclusions |
|
|
38
|
-
| 22 | `step-22-success-metrics.md` | KPIs + targets |
|
|
39
|
-
| **R3: Architecture** | | |
|
|
40
|
-
| 30 | `step-30-architecture-context.md` | Quality goals, constraints |
|
|
41
|
-
| 31 | `step-31-solution-strategy.md` | Tech stack decisions |
|
|
42
|
-
| 32 | `step-32-building-blocks.md` | Modules + runtime scenarios |
|
|
43
|
-
| **R4: Quality & Deploy** | | |
|
|
44
|
-
| 40 | `step-40-deployment.md` | Infrastructure + CI/CD |
|
|
45
|
-
| 41 | `step-41-quality-risks.md` | Quality scenarios + risks |
|
|
46
|
-
| **Synthesis** | | |
|
|
47
|
-
| 99 | `step-99-synthesis.md` | Distillate + validation |
|
|
48
|
-
|
|
49
|
-
## Critical Rules
|
|
50
|
-
|
|
51
|
-
- **Read SKILL.md first** — it has activation logic and project type detection
|
|
52
|
-
- **One step at a time** — never load multiple step files simultaneously
|
|
53
|
-
- **Write immediately** — every step writes to spec file before presenting to user
|
|
54
|
-
- **Web search mandatory** — factual claims need sources, no exceptions
|
|
55
|
-
- **User gate** — halt at [C] Continue, do not auto-proceed
|
|
56
|
-
|
|
57
|
-
## Begin
|
|
58
|
-
|
|
59
|
-
Read `skills/ultra-research/SKILL.md` now and follow the activation sequence.
|
|
9
|
+
Read and follow `@skills/ultra-research/SKILL.md`, using `$ARGUMENTS` to bound the research scope.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|
package/commands/ultra-status.md
CHANGED
|
@@ -1,49 +1,10 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint: "[task-id]"
|
|
4
|
-
allowed-tools: Read, Bash(git status), Bash(git log *), Grep, Glob, Task
|
|
5
|
-
model: opus
|
|
2
|
+
description: Report authoritative Ultra health, readiness, evidence freshness, and one next action
|
|
3
|
+
argument-hint: "[task-or-change-id]"
|
|
6
4
|
workflow-ref: "@skills/ultra-status/SKILL.md"
|
|
7
|
-
mcp_tools_required:
|
|
8
|
-
- task.list
|
|
9
|
-
- task.get
|
|
10
|
-
- change.list
|
|
11
|
-
- system.doctor
|
|
12
5
|
---
|
|
13
6
|
|
|
14
|
-
#
|
|
7
|
+
# Report Ultra status
|
|
15
8
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
一次调用拿整个项目近况:任务进度(来自 state.db `task.list`)+ 测试状态(`test-report.json`)+
|
|
19
|
-
发布状态(`delivery-report.json`)+ active change + runtime health + 下一步命令路由。只读。
|
|
20
|
-
任务状态只接受 MCP `task.list`/`task.get`;失败时原样报告并停止,绝不读取
|
|
21
|
-
`tasks.json` 冒充权威数据。旧 v4.4 数据必须先执行正式迁移。
|
|
22
|
-
|
|
23
|
-
## 参数
|
|
24
|
-
|
|
25
|
-
| 位 | 含义 | 缺省 |
|
|
26
|
-
|----|------|------|
|
|
27
|
-
| `$1` | 单 task id(只看这个 task) | 不填 → 全局报告 |
|
|
28
|
-
|
|
29
|
-
## Workflow
|
|
30
|
-
|
|
31
|
-
完整 5 阶段见 `@skills/ultra-status/SKILL.md`(validation → load → progress → risk → routing)。
|
|
32
|
-
|
|
33
|
-
**命令入口做的事**:
|
|
34
|
-
1. 环境检查(state.db 可达 + 有 task)
|
|
35
|
-
2. `task.list` + `change.list` + read-only `system.doctor`;读 test/delivery report
|
|
36
|
-
3. 算进度 + 风险(含 projection、incident、context/docs drift)
|
|
37
|
-
4. 初始交付后不再显示终局 Done;健康 baseline 的下一项日常工作路由到 `/ultra-change`
|
|
38
|
-
|
|
39
|
-
## 用法
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
/ultra-status # 项目全局报告
|
|
43
|
-
/ultra-status 3 # 只看 task 3
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## 下一步
|
|
47
|
-
|
|
48
|
-
看输出的 `▶ Next Up` 块。常见场景:有 pending → `/ultra-dev`;全绿 → `/ultra-test`;
|
|
49
|
-
test passed → `/ultra-deliver`;已归档且 baseline 健康 → `/ultra-change`。
|
|
9
|
+
Read and follow `@skills/ultra-status/SKILL.md`, using `$ARGUMENTS` to select a specific task or change.
|
|
10
|
+
Treat the referenced skill as the only workflow definition.
|