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.
Files changed (137) hide show
  1. package/.ultra-template/specs/architecture.md +54 -223
  2. package/.ultra-template/specs/discovery.md +34 -231
  3. package/.ultra-template/specs/product.md +44 -200
  4. package/.ultra-template/tasks/contexts/TEMPLATE.md +36 -0
  5. package/.ultra-template/tasks/tasks.json +6 -0
  6. package/CHANGELOG.md +86 -1
  7. package/README.md +21 -9
  8. package/adapters/_shared/codex-assets.cjs +24 -342
  9. package/adapters/_shared/handbook.cjs +4 -3
  10. package/adapters/_shared/runtime-assets.cjs +24 -0
  11. package/adapters/_shared/tests/handbook.test.cjs +4 -0
  12. package/adapters/_shared/tests/runtime-assets.test.cjs +11 -4
  13. package/adapters/claude.js +28 -5
  14. package/adapters/kimi.js +15 -138
  15. package/adapters/opencode.js +22 -49
  16. package/adapters/tests/claude.test.cjs +22 -8
  17. package/adapters/tests/codex.test.cjs +21 -8
  18. package/adapters/tests/kimi-hook.test.cjs +1 -1
  19. package/adapters/tests/kimi.test.cjs +11 -11
  20. package/adapters/tests/opencode.test.cjs +47 -8
  21. package/agents/code-reviewer.md +24 -85
  22. package/agents/debugger.md +30 -132
  23. package/agents/review-code.md +24 -104
  24. package/agents/review-comments.md +20 -83
  25. package/agents/review-coordinator.md +40 -137
  26. package/agents/review-design.md +21 -118
  27. package/agents/review-errors.md +22 -70
  28. package/agents/review-spec.md +36 -0
  29. package/agents/review-tests.md +20 -76
  30. package/agents/tdd-runner.md +26 -84
  31. package/commands/learn.md +5 -36
  32. package/commands/ultra-change.md +5 -43
  33. package/commands/ultra-deliver.md +4 -46
  34. package/commands/ultra-dev.md +4 -48
  35. package/commands/ultra-doctor.md +4 -30
  36. package/commands/ultra-init.md +5 -47
  37. package/commands/ultra-plan.md +5 -48
  38. package/commands/ultra-research.md +5 -54
  39. package/commands/ultra-status.md +5 -44
  40. package/commands/ultra-test.md +5 -45
  41. package/commands/ultra-think.md +5 -40
  42. package/docs/AGENT-CONTEXT.md +16 -8
  43. package/docs/ARCHITECTURE.md +32 -5
  44. package/docs/PLAN.zh-CN.md +8 -6
  45. package/docs/ROADMAP.md +5 -3
  46. package/docs/RUNTIME-COMPAT-MATRIX.md +8 -5
  47. package/docs/SKILL-AUTHORING.md +75 -0
  48. package/docs/STATE-DB-ACCESS-POLICY.md +17 -11
  49. package/docs/USER-HANDBOOK-CONTRACT.md +8 -5
  50. package/hooks/README.md +4 -3
  51. package/hooks/adapters/codex.py +1 -1
  52. package/hooks/adapters/kimi.py +1 -1
  53. package/hooks/context_spine.py +120 -16
  54. package/hooks/health_check.py +11 -0
  55. package/hooks/pre_stop_check.py +6 -5
  56. package/mcp-server/lib/baseline-workflow.cjs +415 -0
  57. package/mcp-server/lib/baseline-workflow.test.cjs +225 -0
  58. package/mcp-server/lib/change-workflow.cjs +24 -27
  59. package/mcp-server/lib/change-workflow.test.cjs +202 -6
  60. package/mcp-server/lib/context-spine.cjs +74 -9
  61. package/mcp-server/lib/context-spine.test.cjs +15 -0
  62. package/mcp-server/lib/doctor.cjs +14 -0
  63. package/mcp-server/lib/doctor.test.cjs +25 -1
  64. package/mcp-server/lib/init-project.cjs +49 -14
  65. package/mcp-server/lib/provider-refs.cjs +42 -0
  66. package/mcp-server/lib/spec-learning.test.cjs +5 -0
  67. package/mcp-server/lib/state-db.cjs +63 -4
  68. package/mcp-server/lib/state-db.test.cjs +8 -3
  69. package/mcp-server/server.cjs +48 -3
  70. package/mcp-server/tests/init-project.test.cjs +54 -8
  71. package/mcp-server/tests/server-contract.test.cjs +99 -2
  72. package/mcp-server/tests/state-db.test.cjs +11 -2
  73. package/package.json +3 -2
  74. package/skills/cc-collab/SKILL.md +16 -18
  75. package/skills/code-review-expert/SKILL.md +39 -114
  76. package/skills/code-review-expert/references/correctness-reliability.md +30 -0
  77. package/skills/code-review-expert/references/design-boundaries.md +26 -0
  78. package/skills/code-review-expert/references/removal-plan.md +17 -45
  79. package/skills/codex-collab/SKILL.md +23 -28
  80. package/skills/codex-collab/evals/evals.json +18 -23
  81. package/skills/integration-rules/SKILL.md +28 -67
  82. package/skills/learn/SKILL.md +46 -106
  83. package/skills/security-rules/SKILL.md +34 -56
  84. package/skills/testing-rules/SKILL.md +28 -52
  85. package/skills/ultra-change/SKILL.md +68 -114
  86. package/skills/ultra-deliver/SKILL.md +58 -86
  87. package/skills/ultra-dev/SKILL.md +46 -105
  88. package/skills/ultra-doctor/SKILL.md +45 -72
  89. package/skills/ultra-init/SKILL.md +62 -147
  90. package/skills/ultra-init/references/brownfield-adoption.md +65 -0
  91. package/skills/ultra-plan/SKILL.md +56 -89
  92. package/skills/ultra-research/SKILL.md +64 -152
  93. package/skills/ultra-research/references/architecture.md +38 -0
  94. package/skills/ultra-research/references/problem-product.md +39 -0
  95. package/skills/ultra-research/references/quality-delivery.md +34 -0
  96. package/skills/ultra-research/references/synthesis.md +38 -0
  97. package/skills/ultra-research/references/users-scope.md +40 -0
  98. package/skills/ultra-review/SKILL.md +54 -98
  99. package/skills/ultra-review/references/unified-schema.md +76 -101
  100. package/skills/ultra-review/scripts/review_wait.py +242 -77
  101. package/skills/ultra-status/SKILL.md +41 -56
  102. package/skills/ultra-test/SKILL.md +37 -72
  103. package/skills/ultra-think/SKILL.md +43 -102
  104. package/skills/ultra-verify/SKILL.md +44 -84
  105. package/skills/ultra-verify/evals/evals.json +24 -27
  106. package/spec/cli-protocol.md +4 -0
  107. package/spec/mcp-tools.yaml +223 -4
  108. package/spec/schemas/command-manifest.schema.json +7 -25
  109. package/spec/schemas/mcp-tools.schema.json +1 -1
  110. package/spec/schemas/skill-manifest.schema.json +9 -79
  111. package/spec/schemas/state-db.sql +33 -2
  112. package/ultra-tools/commands/status.cjs +20 -2
  113. package/ultra-tools/commands/task.cjs +4 -1
  114. package/ultra-tools/status-command.test.cjs +20 -0
  115. package/ultra-tools/system-command.test.cjs +5 -0
  116. package/skills/code-review-expert/references/code-quality-checklist.md +0 -112
  117. package/skills/code-review-expert/references/integration-checklist.md +0 -46
  118. package/skills/code-review-expert/references/security-checklist.md +0 -100
  119. package/skills/code-review-expert/references/solid-checklist.md +0 -65
  120. package/skills/ultra-research/steps/step-00-problem-validation.md +0 -154
  121. package/skills/ultra-research/steps/step-01-opportunity-discovery.md +0 -172
  122. package/skills/ultra-research/steps/step-02-market-assessment.md +0 -195
  123. package/skills/ultra-research/steps/step-03-competitive-landscape.md +0 -197
  124. package/skills/ultra-research/steps/step-04-product-strategy.md +0 -196
  125. package/skills/ultra-research/steps/step-05-assumptions-validation.md +0 -234
  126. package/skills/ultra-research/steps/step-10-user-personas.md +0 -169
  127. package/skills/ultra-research/steps/step-11-user-scenarios.md +0 -181
  128. package/skills/ultra-research/steps/step-20-user-stories.md +0 -156
  129. package/skills/ultra-research/steps/step-21-features-scope.md +0 -157
  130. package/skills/ultra-research/steps/step-22-success-metrics.md +0 -195
  131. package/skills/ultra-research/steps/step-30-architecture-context.md +0 -154
  132. package/skills/ultra-research/steps/step-31-solution-strategy.md +0 -172
  133. package/skills/ultra-research/steps/step-32-building-blocks.md +0 -188
  134. package/skills/ultra-research/steps/step-40-deployment.md +0 -123
  135. package/skills/ultra-research/steps/step-41-quality-risks.md +0 -135
  136. package/skills/ultra-research/steps/step-99-synthesis.md +0 -188
  137. package/skills/ultra-review/scripts/review_verdict_update.py +0 -99
@@ -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 Execution Specialist
33
-
34
- Run tests, analyze failures, report results concisely.
35
-
36
- ## Scope
37
-
38
- **DO**: Execute test suites, analyze failures, check coverage, detect mock violations.
39
-
40
- **DON'T**: Write tests (that's the developer's job), modify code, fix bugs.
41
-
42
- ## Process
43
-
44
- 1. **Detect framework**: Look for package.json (jest/vitest), pytest.ini, Cargo.toml, etc.
45
- 2. **Execute**: Run appropriate test command
46
- 3. **Analyze failures**: Extract error messages, stack traces, root cause
47
- 4. **Check violations**: Scan for forbidden mock patterns
48
- 5. **Report**: Only failures + summary (not full output)
49
-
50
- ## Test Commands
51
-
52
- Auto-detect and run the appropriate command:
53
- - Node.js: `npm test` / `npx jest` / `npx vitest`
54
- - Python: `pytest -v`
55
- - Rust: `cargo test`
56
- - Go: `go test ./...`
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: Extract one reusable pattern into a valid user skill after explicit approval
3
- argument-hint: "[pattern-name]"
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
- # /learn
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.
@@ -1,48 +1,10 @@
1
1
  ---
2
- description: Start or resume a continuous post-delivery change with bounded context, documentation impact, and linked authoritative tasks
3
- argument-hint: "[change-id or title] [quick|standard|major|incident]"
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
- # /ultra-change
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 and deliver a verified baseline or continuous change — reconcile specs, archive evidence, version, tag, and push
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
- # /ultra-deliver
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.
@@ -1,54 +1,10 @@
1
1
  ---
2
- description: Agile development execution — one task through TDD + review gate, writing state via MCP task.update
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
- # /ultra-dev
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.
@@ -1,36 +1,10 @@
1
1
  ---
2
- description: Inspect Ultra runtime health and optionally run explicit backup-first mechanical recovery
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
- # /ultra-doctor
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.
@@ -1,52 +1,10 @@
1
1
  ---
2
- description: Initialize Ultra Builder Pro project — scaffold .ultra/, initialize state.db and continuous-change directories, optional git
3
- argument-hint: <name> <type> <stack> [git]
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
- # /ultra-init
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.
@@ -1,53 +1,10 @@
1
1
  ---
2
- description: Generate task breakdown from complete specs — walking-skeleton first, vertical slices, via MCP task.create
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
- # /ultra-plan
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: Think-Driven Interactive Discovery — 17-step research with per-step web search and spec-file output
3
- argument-hint: [topic]
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
- # Ultra Research v2
7
+ # Research a baseline
10
8
 
11
- **Step-file architecture**: Each research step is a self-contained instruction file loaded just-in-time for maximum LLM attention density.
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.
@@ -1,49 +1,10 @@
1
1
  ---
2
- description: Real-time project status — progress + risks + workflow routing, via MCP task.list
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
- # /ultra-status
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.