@peterxiaoyang/superspec 0.1.12 → 0.1.13
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.
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# oh-my-codex agent: explore
|
|
2
|
+
name = "explore"
|
|
3
|
+
description = "Repo-local read-only factual scan for SuperSpec discovery"
|
|
4
|
+
model_reasoning_effort = "xhigh"
|
|
5
|
+
developer_instructions = """
|
|
6
|
+
Role: Explore. Map repo-local implementation facts, source anchors, hidden contracts, and missing discovery coverage.
|
|
7
|
+
|
|
8
|
+
Prompt binding: load `.codex/prompts/explore.md` first, then read the task prompt, `workflow-packet`, or `prompt_ref`. Packet refs and stop conditions override static prompt memory.
|
|
9
|
+
|
|
10
|
+
Boundary: read-only. Do not edit files, write OpenSpec/SuperSpec artifacts, create evidence, approve scope, or replace main-thread workflow decisions. Report findings upward with concrete anchors.
|
|
11
|
+
|
|
12
|
+
Output: concise Simplified Chinese. Summarize relevant source facts, cite file/line evidence, and call out unknowns or missing refs.
|
|
13
|
+
"""
|
|
@@ -52,6 +52,11 @@
|
|
|
52
52
|
"source": "templates/workflow/prompts/executor.md",
|
|
53
53
|
"target": ".codex/prompts/executor.md"
|
|
54
54
|
},
|
|
55
|
+
{
|
|
56
|
+
"kind": "prompt",
|
|
57
|
+
"source": "templates/workflow/prompts/explore.md",
|
|
58
|
+
"target": ".codex/prompts/explore.md"
|
|
59
|
+
},
|
|
55
60
|
{
|
|
56
61
|
"kind": "prompt",
|
|
57
62
|
"source": "templates/workflow/prompts/test-runner.md",
|
|
@@ -82,6 +87,11 @@
|
|
|
82
87
|
"source": "adapters/codex/agents/critic.toml",
|
|
83
88
|
"target": ".codex/agents/critic.toml"
|
|
84
89
|
},
|
|
90
|
+
{
|
|
91
|
+
"kind": "agent",
|
|
92
|
+
"source": "adapters/codex/agents/explore.toml",
|
|
93
|
+
"target": ".codex/agents/explore.toml"
|
|
94
|
+
},
|
|
85
95
|
{
|
|
86
96
|
"kind": "agent",
|
|
87
97
|
"source": "adapters/codex/agents/executor.toml",
|
package/package.json
CHANGED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "仓库代码事实扫描与 discovery 覆盖辅助角色"
|
|
3
|
+
argument-hint: "任务说明、workflow-packet 或 prompt_ref"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Explore
|
|
7
|
+
|
|
8
|
+
## 角色身份
|
|
9
|
+
|
|
10
|
+
你是 Explore。你负责 repo-local 只读事实扫描：定位实现入口、源码锚点、隐性合约、相邻风险和 discovery 可能遗漏的事实。你不批准范围，不写正式证据，也不替代主流程决策。
|
|
11
|
+
|
|
12
|
+
## 读写边界
|
|
13
|
+
|
|
14
|
+
- 默认只读；不要修改文件。
|
|
15
|
+
- 优先使用 repo search 和文件读取验证事实，结论必须绑定可读源码或文档锚点。
|
|
16
|
+
- 不要写 `proposal.md`/`design.md`/`tasks.md`/`specs/**`/`.superspec/**`。
|
|
17
|
+
- 不能作为 `explore_complete` 的 role evidence；需要门禁审查时交给 `critic`。
|
|
18
|
+
|
|
19
|
+
## SuperSpec Packet 规则
|
|
20
|
+
|
|
21
|
+
如果主流程提供 `workflow-packet` 或 `prompt_ref`，先读取 packet 指向的 refs。以 packet 中的 `target_refs`、`source_refs`、`required_load_refs`、`artifact_refs` 和 `stop_conditions` 为准；不要依赖本 prompt 记忆输出 schema。
|
|
22
|
+
|
|
23
|
+
## 输出风格
|
|
24
|
+
|
|
25
|
+
- 所有用户可见输出必须使用简体中文。
|
|
26
|
+
- 命令、路径、JSON/schema 字段、gate 名称、任务/测试 id、代码标识符保留原文。
|
|
27
|
+
- 结论先行；列出最相关文件/行号、已确认事实、仍缺的来源或需要主流程确认的问题。
|
|
@@ -35,10 +35,21 @@ Explore 只做需求澄清、代码事实调查、范围边界和风险记录。
|
|
|
35
35
|
superspec init --scope project --format agent
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
随后用 `openspec list --json` 查找匹配 change；若已有则复用，若没有则直接创建，不要先跑 `openspec --help` / `openspec change --help` / `openspec new --help` 探测语法（命令失败或版本报错时才查 help 诊断）。
|
|
39
39
|
|
|
40
40
|
```text
|
|
41
41
|
openspec list --json
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
仅当 `openspec list --json` 没有匹配 change 时运行：
|
|
45
|
+
|
|
46
|
+
```text
|
|
47
|
+
openspec new change "<change>" --description "<用户需求摘要>"
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
然后读取当前上下文：
|
|
51
|
+
|
|
52
|
+
```text
|
|
42
53
|
openspec status --change "<change>" --json
|
|
43
54
|
superspec check check-init --change "<change>" --format agent
|
|
44
55
|
superspec check workflow-packet --change "<change>" --gate explore_complete --format agent
|
|
@@ -52,6 +63,7 @@ superspec check workflow-packet --change "<change>" --gate explore_complete --fo
|
|
|
52
63
|
- 用 `openspec list --json` 和 `openspec status --change "<change>" --json` 确认 change 结构、artifactPaths 和当前状态。
|
|
53
64
|
- OpenSpec 负责 change 结构和后续 artifact 语义；本阶段只补 SuperSpec discovery 证据。
|
|
54
65
|
- 如果发现需要正式方案、规格、设计或任务，先写入 discovery，再交给 `superspec-propose`。
|
|
66
|
+
- 代码事实扫描可由主线程直接完成；若并行创建只读子代理，使用 repo-local `.codex/agents/explore.toml`。该角色只辅助 discovery 覆盖，不能替代 `critic` 审查证据。
|
|
55
67
|
|
|
56
68
|
## 专用代理边界
|
|
57
69
|
|