artifact-chain-assistant 0.9.2 → 0.9.4
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/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.kimi-plugin/plugin.json +1 -1
- package/CHANGELOG.md +24 -0
- package/INSTALL.md +47 -12
- package/README.md +23 -5
- package/README.zh-CN.md +21 -5
- package/adapters/claude/.claude-plugin/plugin.json +1 -1
- package/adapters/claude/INSTALL.md +47 -12
- package/adapters/claude/agent-methods/catalog.yaml +1 -1
- package/adapters/claude/compatibility.json +4 -4
- package/adapters/claude/family-apis/catalog.json +1 -1
- package/adapters/claude/skills/where-am-i/SKILL.md +1 -1
- package/adapters/codex/.codex-plugin/plugin.json +1 -1
- package/adapters/codex/INSTALL.md +47 -12
- package/adapters/codex/agent-methods/catalog.yaml +1 -1
- package/adapters/codex/compatibility.json +4 -4
- package/adapters/codex/family-apis/catalog.json +1 -1
- package/adapters/codex/skills/where-am-i/SKILL.md +1 -1
- package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
- package/adapters/kimi/INSTALL.md +47 -12
- package/adapters/kimi/agent-methods/catalog.yaml +1 -1
- package/adapters/kimi/compatibility.json +4 -4
- package/adapters/kimi/family-apis/catalog.json +1 -1
- package/adapters/kimi/skills/where-am-i/SKILL.md +1 -1
- package/agent-methods/catalog.yaml +1 -1
- package/compatibility.json +4 -4
- package/family-apis/catalog.json +1 -1
- package/package.json +2 -2
- package/skills/where-am-i/SKILL.md +1 -1
- package/skills-src/where-am-i/SKILL.md.tpl +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "artifact-chain-assistant",
|
|
3
3
|
"displayName": "Artifact Chain Assistant",
|
|
4
|
-
"version": "0.9.
|
|
4
|
+
"version": "0.9.4",
|
|
5
5
|
"description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "广州市风荷科技有限公司"
|
package/.kimi-plugin/plugin.json
CHANGED
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,29 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.9.4
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- Qoder can consume the existing root plugin package as a skills-only host. This compatibility
|
|
8
|
+
path reuses the shared skills and does not add a Qoder-specific adapter, manifest, commands,
|
|
9
|
+
hooks, or settings.
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
|
|
13
|
+
- Host smoke verification now confirms that Qoder's reported install path is isolated and contains
|
|
14
|
+
the shared runtime resource closure plus every expected skill entry point.
|
|
15
|
+
- Shared skill descriptions use host-neutral language where the workflow is not specific to Codex,
|
|
16
|
+
so the same guidance remains accurate in Qoder and other supported hosts.
|
|
17
|
+
- Runtime compatibility and generated plugin manifests are synchronized with
|
|
18
|
+
`artifact-graph@0.9.4`.
|
|
19
|
+
|
|
20
|
+
## 0.9.3
|
|
21
|
+
|
|
22
|
+
### Changed
|
|
23
|
+
|
|
24
|
+
- Runtime compatibility and generated plugin manifests are synchronized with
|
|
25
|
+
`artifact-graph@0.9.3`. No new skill capabilities in this release.
|
|
26
|
+
|
|
3
27
|
## 0.9.2
|
|
4
28
|
|
|
5
29
|
### Changed
|
package/INSTALL.md
CHANGED
|
@@ -2,18 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
This guide separates two responsibilities:
|
|
4
4
|
|
|
5
|
-
1. Install the assistant plugin into Codex
|
|
5
|
+
1. Install the assistant plugin into Codex, Claude Code, Kimi Code, or Qoder.
|
|
6
6
|
2. Prepare each target project so the plugin has a project-local artifact chain to manage.
|
|
7
7
|
|
|
8
8
|
Codex exposes `.codex-plugin/plugin.json` and `skills/**` only. Claude Code also exposes slash
|
|
9
|
-
command wrappers and a Stop-hook guardrail.
|
|
9
|
+
command wrappers and a Stop-hook guardrail. Qoder currently runs in skill-compatible mode: it
|
|
10
|
+
installs and discovers the shared skills but does not receive slash command wrappers or the
|
|
11
|
+
Stop-hook guardrail (see [Qoder](#qoder)). Neither host surface replaces Git hooks or CI: those
|
|
10
12
|
remain the hard gates for a target project's artifacts, graph config, version lock, and project
|
|
11
13
|
instructions.
|
|
12
14
|
|
|
13
15
|
## Prerequisites
|
|
14
16
|
|
|
15
17
|
- Node.js `>=22.0.0`.
|
|
16
|
-
- `artifact-graph` 0.9.
|
|
18
|
+
- `artifact-graph` 0.9.4 installed in the target project.
|
|
17
19
|
- **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
|
|
18
20
|
have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
|
|
19
21
|
profile, or add the marketplace with an explicit `https://` URL. Codex users can check
|
|
@@ -25,24 +27,24 @@ instructions.
|
|
|
25
27
|
|
|
26
28
|
| Plugin | Verified Runtime | Install |
|
|
27
29
|
| --- | --- | --- |
|
|
28
|
-
| `artifact-chain-assistant` 0.9.
|
|
30
|
+
| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
|
|
29
31
|
|
|
30
32
|
### Install The Runtime
|
|
31
33
|
|
|
32
34
|
The default installation path uses the npm registry with a precise version:
|
|
33
35
|
|
|
34
36
|
```bash
|
|
35
|
-
pnpm add -D artifact-graph@0.9.
|
|
37
|
+
pnpm add -D artifact-graph@0.9.4
|
|
36
38
|
```
|
|
37
39
|
|
|
38
40
|
If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
|
|
39
41
|
|
|
40
42
|
```bash
|
|
41
|
-
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
43
|
+
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.4
|
|
42
44
|
```
|
|
43
45
|
|
|
44
46
|
> **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
|
|
45
|
-
> `artifact-graph@^0.9.
|
|
47
|
+
> `artifact-graph@^0.9.4`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
|
|
46
48
|
> Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
|
|
47
49
|
|
|
48
50
|
With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
|
|
@@ -69,7 +71,7 @@ allowBuilds:
|
|
|
69
71
|
|
|
70
72
|
The plugin's `doctor` command validates the installed runtime version before running any
|
|
71
73
|
diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
|
|
72
|
-
command (`pnpm add -D artifact-graph@0.9.
|
|
74
|
+
command (`pnpm add -D artifact-graph@0.9.4`) and exits non-zero.
|
|
73
75
|
|
|
74
76
|
### CLI Resolution Order
|
|
75
77
|
|
|
@@ -144,7 +146,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
|
|
|
144
146
|
|
|
145
147
|
> **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
|
|
146
148
|
> plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
|
|
147
|
-
> must publish and enable `artifact-chain-assistant` 0.9.
|
|
149
|
+
> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
|
|
148
150
|
> succeed.
|
|
149
151
|
|
|
150
152
|
### Kimi Code
|
|
@@ -171,6 +173,39 @@ skills, and managed scripts (`doctor.mjs`, `check-workflow-profile.mjs`, `run-ar
|
|
|
171
173
|
non-interactive install CLI, so automated install verification is limited to layout checks;
|
|
172
174
|
use `artifact-chain-maintainer` to guide version-lock CLI operations.
|
|
173
175
|
|
|
176
|
+
### Qoder
|
|
177
|
+
|
|
178
|
+
Qoder is currently supported as a **skill-compatible host**, not as a fourth adapter. It reuses the
|
|
179
|
+
existing `artifact-skill-set` marketplace: Qoder recognizes the root
|
|
180
|
+
`.claude-plugin/marketplace.json` and installs the shared plugin root (`skills/**`), so no
|
|
181
|
+
Qoder-specific manifest or duplicated runtime assets are required.
|
|
182
|
+
|
|
183
|
+
Register the marketplace and install the plugin (illustrative commands):
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
qodercli plugin marketplace add ifoohoo/artifact-skill-set --scope user
|
|
187
|
+
qodercli plugin install artifact-chain-assistant@artifact-skill-set --scope user --json
|
|
188
|
+
qodercli plugin list --json
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
> The exact flags may change between Qoder CLI releases. Treat the commands above as
|
|
192
|
+
> illustrations and confirm against `qodercli plugin ... --help` at execution time.
|
|
193
|
+
|
|
194
|
+
Current support boundary:
|
|
195
|
+
|
|
196
|
+
- **Committed**: plugin installation and shared skill discovery. Qoder installs
|
|
197
|
+
`artifact-chain-assistant` from the marketplace and discovers the shared `skills/` entries.
|
|
198
|
+
- **Not committed**: Claude Code slash command wrappers and the Stop-hook guardrail are not
|
|
199
|
+
provided for Qoder. `commands` and `hooks` being empty in `plugin list --json` is expected,
|
|
200
|
+
not a defect.
|
|
201
|
+
|
|
202
|
+
Verify an installation with `qodercli plugin list --json`: confirm the installed version, that the
|
|
203
|
+
plugin is enabled, that `installPath` points at the expected location, and that the `skills` list
|
|
204
|
+
matches the shared skill set. Diagnostics still use the plugin root `scripts/doctor.mjs` — resolve
|
|
205
|
+
the installed root from the `installPath` reported by `plugin list --json`, then run
|
|
206
|
+
`node "$PLUGIN_ROOT/scripts/doctor.mjs" --root . --format json`. There is no Qoder-specific
|
|
207
|
+
adapter doctor.
|
|
208
|
+
|
|
174
209
|
## Post-Installation Discovery
|
|
175
210
|
|
|
176
211
|
After installing the plugin, use these entry points to understand available capabilities:
|
|
@@ -218,7 +253,7 @@ The plugin should not move these files into the plugin repository.
|
|
|
218
253
|
|
|
219
254
|
For a first-time setup, the end-to-end sequence is:
|
|
220
255
|
|
|
221
|
-
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.
|
|
256
|
+
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.4` (see Prerequisites above).
|
|
222
257
|
2. **Install the plugin** — follow the Codex or Claude Code section above.
|
|
223
258
|
3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
|
|
224
259
|
below). The skill will:
|
|
@@ -1016,7 +1051,7 @@ with append-only behavior; it does not overwrite local rules.
|
|
|
1016
1051
|
### Recovery Steps
|
|
1017
1052
|
|
|
1018
1053
|
```bash
|
|
1019
|
-
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.
|
|
1054
|
+
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.4)
|
|
1020
1055
|
pnpm install --frozen-lockfile
|
|
1021
1056
|
|
|
1022
1057
|
# 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
|
|
@@ -1083,7 +1118,7 @@ pnpm exec artifact-graph hooks install-git --hook all
|
|
|
1083
1118
|
### Enterprise Mirror
|
|
1084
1119
|
|
|
1085
1120
|
If the corporate environment cannot access the public npm registry or GitHub, mirror both
|
|
1086
|
-
`artifact-graph@0.9.
|
|
1121
|
+
`artifact-graph@0.9.4` and the plugin marketplace repository on an internal registry. The mirror
|
|
1087
1122
|
does not change the state ownership model: Git-tracked files remain authoritative, local caches
|
|
1088
1123
|
remain derived.
|
|
1089
1124
|
|
package/README.md
CHANGED
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
[中文](README.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
Codex, Claude Code, and Kimi Code assistant plugin for projects that use `artifact-graph
|
|
5
|
+
Codex, Claude Code, and Kimi Code assistant plugin for projects that use `artifact-graph`; Qoder
|
|
6
|
+
uses the same shared skills as a skill-compatible host.
|
|
6
7
|
|
|
7
8
|
Artifact Chain Assistant packages reusable skills, host-specific adapter manifests, and install
|
|
8
9
|
guidance for artifact-chain projects. It helps agents discover the right artifact context, bootstrap
|
|
@@ -142,6 +143,10 @@ override, compact query, fallback behavior, and `PLUGIN_ROOT` discovery, see
|
|
|
142
143
|
- **Kimi Code** exposes `.kimi-plugin/plugin.json`, `skills/**`, and managed scripts
|
|
143
144
|
(`doctor.mjs`, `check-workflow-profile.mjs`, `run-artifact-workflow.mjs`, `batch-split.mjs`, `batch-merge.mjs`). It does not
|
|
144
145
|
expose plugin commands, hooks, or settings.
|
|
146
|
+
- **Qoder** is a skill-compatible host: it installs from the same `artifact-skill-set`
|
|
147
|
+
marketplace and discovers the shared `skills/**`. It does not expose slash command wrappers or
|
|
148
|
+
the Stop-hook guardrail, and diagnostics still use the plugin root `scripts/doctor.mjs` (there
|
|
149
|
+
is no Qoder adapter doctor).
|
|
145
150
|
- Git hook templates and installers are host-independent. Git hooks and CI are the hard gates;
|
|
146
151
|
host-specific skills and hooks only provide assistant guidance.
|
|
147
152
|
|
|
@@ -149,13 +154,13 @@ override, compact query, fallback behavior, and `PLUGIN_ROOT` discovery, see
|
|
|
149
154
|
|
|
150
155
|
| Plugin | Runtime | Install |
|
|
151
156
|
| --- | --- | --- |
|
|
152
|
-
| `artifact-chain-assistant` 0.9.
|
|
157
|
+
| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
|
|
153
158
|
|
|
154
159
|
## Install
|
|
155
160
|
|
|
156
161
|
```bash
|
|
157
162
|
# Runtime (required)
|
|
158
|
-
npm install --save-dev artifact-graph@0.9.
|
|
163
|
+
npm install --save-dev artifact-graph@0.9.4
|
|
159
164
|
```
|
|
160
165
|
|
|
161
166
|
```bash
|
|
@@ -177,7 +182,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
|
|
|
177
182
|
|
|
178
183
|
> **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
|
|
179
184
|
> plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
|
|
180
|
-
> must publish and enable `artifact-chain-assistant` 0.9.
|
|
185
|
+
> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
|
|
181
186
|
> succeed.
|
|
182
187
|
|
|
183
188
|
```text
|
|
@@ -188,12 +193,25 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
|
|
|
188
193
|
After installing or upgrading in Kimi Code, run `/reload` (or start a new session) so the plugin
|
|
189
194
|
skills are picked up. Kimi Code has no non-interactive install CLI.
|
|
190
195
|
|
|
196
|
+
```bash
|
|
197
|
+
# Qoder plugin (skill-compatible host; illustrative commands —
|
|
198
|
+
# confirm flags with `qodercli plugin ... --help` at execution time)
|
|
199
|
+
qodercli plugin marketplace add ifoohoo/artifact-skill-set --scope user
|
|
200
|
+
qodercli plugin install artifact-chain-assistant@artifact-skill-set --scope user --json
|
|
201
|
+
qodercli plugin list --json
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
Qoder currently commits to skill installation and discovery only; Claude Code slash commands and
|
|
205
|
+
the Stop hook are not provided. Use `qodercli plugin list --json` to check the installed version,
|
|
206
|
+
`enabled`, `installPath`, and `skills`. Diagnostics still use the plugin root
|
|
207
|
+
`scripts/doctor.mjs`; there is no Qoder adapter doctor.
|
|
208
|
+
|
|
191
209
|
For the full installation guide, quick start, Agent prompts, and clone onboarding, see
|
|
192
210
|
[INSTALL.md](INSTALL.md).
|
|
193
211
|
|
|
194
212
|
## Quick Start
|
|
195
213
|
|
|
196
|
-
1. Install plugin 0.9.
|
|
214
|
+
1. Install plugin 0.9.4 (above) and runtime: `pnpm add -D artifact-graph@0.9.4`.
|
|
197
215
|
2. Run `artifact-graph doctor --root . --format json` to verify the runtime.
|
|
198
216
|
3. For first-time setup, use the bootstrap skill.
|
|
199
217
|
4. For daily work, use the maintainer skill.
|
package/README.zh-CN.md
CHANGED
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md)
|
|
4
4
|
|
|
5
|
-
Artifact Chain Assistant 是面向 `artifact-graph` 项目的 Codex / Claude Code / Kimi Code
|
|
5
|
+
Artifact Chain Assistant 是面向 `artifact-graph` 项目的 Codex / Claude Code / Kimi Code 助手插件;
|
|
6
|
+
Qoder 以技能兼容宿主身份复用同一套共享技能。
|
|
6
7
|
|
|
7
8
|
它打包了可复用的 skill、按宿主划分的 adapter manifest 和安装指引,帮助 agent 找到正确的
|
|
8
9
|
制品上下文、初始化项目本地配置,并维护追溯版本锁(traceability version lock)。
|
|
@@ -190,6 +191,9 @@ catalog 还包含 `artifact.generate`,用于从模板和 profile 配置生成
|
|
|
190
191
|
- **Kimi Code** 暴露 `.kimi-plugin/plugin.json`、`skills/**` 和受管脚本(`doctor.mjs`、
|
|
191
192
|
`check-workflow-profile.mjs`、`run-artifact-workflow.mjs`、`batch-split.mjs`、`batch-merge.mjs`),不暴露插件命令、hook 和
|
|
192
193
|
settings。
|
|
194
|
+
- **Qoder** 是技能兼容宿主:从同一个 `artifact-skill-set` 市场安装并发现共享
|
|
195
|
+
`skills/**`,不暴露 slash command 包装器和 Stop hook 防护;诊断仍使用插件根
|
|
196
|
+
`scripts/doctor.mjs`(不存在 Qoder adapter doctor)。
|
|
193
197
|
- Git hook 模板和安装器与宿主无关。真正的硬门禁是 Git hook 和 CI;各宿主的 skill 和
|
|
194
198
|
hook 只为 assistant 提供指引。
|
|
195
199
|
|
|
@@ -197,13 +201,13 @@ catalog 还包含 `artifact.generate`,用于从模板和 profile 配置生成
|
|
|
197
201
|
|
|
198
202
|
| 插件 | 运行时 | 安装 |
|
|
199
203
|
| --- | --- | --- |
|
|
200
|
-
| `artifact-chain-assistant` 0.9.
|
|
204
|
+
| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
|
|
201
205
|
|
|
202
206
|
## 安装
|
|
203
207
|
|
|
204
208
|
```bash
|
|
205
209
|
# 运行时(必需)
|
|
206
|
-
npm install --save-dev artifact-graph@0.9.
|
|
210
|
+
npm install --save-dev artifact-graph@0.9.4
|
|
207
211
|
```
|
|
208
212
|
|
|
209
213
|
```bash
|
|
@@ -225,7 +229,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
|
|
|
225
229
|
|
|
226
230
|
> **市场说明**:`ifoohoo/artifact-skill-set` 是外部独立市场,插件载荷仍由
|
|
227
231
|
> `ifoohoo/artifact-chain-assistant` 发布。市场条目必须先发布并启用
|
|
228
|
-
> `artifact-chain-assistant` 0.9.
|
|
232
|
+
> `artifact-chain-assistant` 0.9.4,上述安装命令才能生效。
|
|
229
233
|
|
|
230
234
|
```text
|
|
231
235
|
# Kimi Code 插件(交互式,user 作用域)
|
|
@@ -235,12 +239,24 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
|
|
|
235
239
|
在 Kimi Code 中安装或升级后,运行 `/reload`(或新开会话)让插件技能生效。Kimi Code
|
|
236
240
|
没有非交互式安装 CLI。
|
|
237
241
|
|
|
242
|
+
```bash
|
|
243
|
+
# Qoder 插件(技能兼容宿主;示意命令——
|
|
244
|
+
# 具体命令以执行时 qodercli plugin ... --help 为准)
|
|
245
|
+
qodercli plugin marketplace add ifoohoo/artifact-skill-set --scope user
|
|
246
|
+
qodercli plugin install artifact-chain-assistant@artifact-skill-set --scope user --json
|
|
247
|
+
qodercli plugin list --json
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
Qoder 当前承诺的边界是技能安装与发现;不提供 Claude Code 的 slash commands 和 Stop hook。
|
|
251
|
+
使用 `qodercli plugin list --json` 检查安装版本、`enabled`、`installPath` 和 `skills`。
|
|
252
|
+
诊断仍使用插件根 `scripts/doctor.mjs`,不存在 Qoder adapter doctor。
|
|
253
|
+
|
|
238
254
|
完整的安装指南、快速开始、Agent 提示词和团队成员 clone 接入,请参阅
|
|
239
255
|
[INSTALL.md](INSTALL.md)。
|
|
240
256
|
|
|
241
257
|
## 快速开始
|
|
242
258
|
|
|
243
|
-
1. 安装插件 0.9.
|
|
259
|
+
1. 安装插件 0.9.4(见上文)和运行时:`pnpm add -D artifact-graph@0.9.4`。
|
|
244
260
|
2. 运行 `artifact-graph doctor --root . --format json` 验证运行时。
|
|
245
261
|
3. 首次搭建,进入 bootstrap 技能。
|
|
246
262
|
4. 日常工作,进入 maintainer 技能。
|
|
@@ -5,18 +5,20 @@
|
|
|
5
5
|
|
|
6
6
|
This guide separates two responsibilities:
|
|
7
7
|
|
|
8
|
-
1. Install the assistant plugin into Codex
|
|
8
|
+
1. Install the assistant plugin into Codex, Claude Code, Kimi Code, or Qoder.
|
|
9
9
|
2. Prepare each target project so the plugin has a project-local artifact chain to manage.
|
|
10
10
|
|
|
11
11
|
Codex exposes `.codex-plugin/plugin.json` and `skills/**` only. Claude Code also exposes slash
|
|
12
|
-
command wrappers and a Stop-hook guardrail.
|
|
12
|
+
command wrappers and a Stop-hook guardrail. Qoder currently runs in skill-compatible mode: it
|
|
13
|
+
installs and discovers the shared skills but does not receive slash command wrappers or the
|
|
14
|
+
Stop-hook guardrail (see [Qoder](#qoder)). Neither host surface replaces Git hooks or CI: those
|
|
13
15
|
remain the hard gates for a target project's artifacts, graph config, version lock, and project
|
|
14
16
|
instructions.
|
|
15
17
|
|
|
16
18
|
## Prerequisites
|
|
17
19
|
|
|
18
20
|
- Node.js `>=22.0.0`.
|
|
19
|
-
- `artifact-graph` 0.9.
|
|
21
|
+
- `artifact-graph` 0.9.4 installed in the target project.
|
|
20
22
|
- **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
|
|
21
23
|
have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
|
|
22
24
|
profile, or add the marketplace with an explicit `https://` URL. Codex users can check
|
|
@@ -28,24 +30,24 @@ instructions.
|
|
|
28
30
|
|
|
29
31
|
| Plugin | Verified Runtime | Install |
|
|
30
32
|
| --- | --- | --- |
|
|
31
|
-
| `artifact-chain-assistant` 0.9.
|
|
33
|
+
| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
|
|
32
34
|
|
|
33
35
|
### Install The Runtime
|
|
34
36
|
|
|
35
37
|
The default installation path uses the npm registry with a precise version:
|
|
36
38
|
|
|
37
39
|
```bash
|
|
38
|
-
pnpm add -D artifact-graph@0.9.
|
|
40
|
+
pnpm add -D artifact-graph@0.9.4
|
|
39
41
|
```
|
|
40
42
|
|
|
41
43
|
If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
|
|
42
44
|
|
|
43
45
|
```bash
|
|
44
|
-
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
46
|
+
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.4
|
|
45
47
|
```
|
|
46
48
|
|
|
47
49
|
> **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
|
|
48
|
-
> `artifact-graph@^0.9.
|
|
50
|
+
> `artifact-graph@^0.9.4`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
|
|
49
51
|
> Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
|
|
50
52
|
|
|
51
53
|
With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
|
|
@@ -72,7 +74,7 @@ allowBuilds:
|
|
|
72
74
|
|
|
73
75
|
The plugin's `doctor` command validates the installed runtime version before running any
|
|
74
76
|
diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
|
|
75
|
-
command (`pnpm add -D artifact-graph@0.9.
|
|
77
|
+
command (`pnpm add -D artifact-graph@0.9.4`) and exits non-zero.
|
|
76
78
|
|
|
77
79
|
### CLI Resolution Order
|
|
78
80
|
|
|
@@ -147,7 +149,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
|
|
|
147
149
|
|
|
148
150
|
> **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
|
|
149
151
|
> plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
|
|
150
|
-
> must publish and enable `artifact-chain-assistant` 0.9.
|
|
152
|
+
> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
|
|
151
153
|
> succeed.
|
|
152
154
|
|
|
153
155
|
### Kimi Code
|
|
@@ -174,6 +176,39 @@ skills, and managed scripts (`doctor.mjs`, `check-workflow-profile.mjs`, `run-ar
|
|
|
174
176
|
non-interactive install CLI, so automated install verification is limited to layout checks;
|
|
175
177
|
use `artifact-chain-maintainer` to guide version-lock CLI operations.
|
|
176
178
|
|
|
179
|
+
### Qoder
|
|
180
|
+
|
|
181
|
+
Qoder is currently supported as a **skill-compatible host**, not as a fourth adapter. It reuses the
|
|
182
|
+
existing `artifact-skill-set` marketplace: Qoder recognizes the root
|
|
183
|
+
`.claude-plugin/marketplace.json` and installs the shared plugin root (`skills/**`), so no
|
|
184
|
+
Qoder-specific manifest or duplicated runtime assets are required.
|
|
185
|
+
|
|
186
|
+
Register the marketplace and install the plugin (illustrative commands):
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
qodercli plugin marketplace add ifoohoo/artifact-skill-set --scope user
|
|
190
|
+
qodercli plugin install artifact-chain-assistant@artifact-skill-set --scope user --json
|
|
191
|
+
qodercli plugin list --json
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
> The exact flags may change between Qoder CLI releases. Treat the commands above as
|
|
195
|
+
> illustrations and confirm against `qodercli plugin ... --help` at execution time.
|
|
196
|
+
|
|
197
|
+
Current support boundary:
|
|
198
|
+
|
|
199
|
+
- **Committed**: plugin installation and shared skill discovery. Qoder installs
|
|
200
|
+
`artifact-chain-assistant` from the marketplace and discovers the shared `skills/` entries.
|
|
201
|
+
- **Not committed**: Claude Code slash command wrappers and the Stop-hook guardrail are not
|
|
202
|
+
provided for Qoder. `commands` and `hooks` being empty in `plugin list --json` is expected,
|
|
203
|
+
not a defect.
|
|
204
|
+
|
|
205
|
+
Verify an installation with `qodercli plugin list --json`: confirm the installed version, that the
|
|
206
|
+
plugin is enabled, that `installPath` points at the expected location, and that the `skills` list
|
|
207
|
+
matches the shared skill set. Diagnostics still use the plugin root `scripts/doctor.mjs` — resolve
|
|
208
|
+
the installed root from the `installPath` reported by `plugin list --json`, then run
|
|
209
|
+
`node "$PLUGIN_ROOT/scripts/doctor.mjs" --root . --format json`. There is no Qoder-specific
|
|
210
|
+
adapter doctor.
|
|
211
|
+
|
|
177
212
|
## Post-Installation Discovery
|
|
178
213
|
|
|
179
214
|
After installing the plugin, use these entry points to understand available capabilities:
|
|
@@ -221,7 +256,7 @@ The plugin should not move these files into the plugin repository.
|
|
|
221
256
|
|
|
222
257
|
For a first-time setup, the end-to-end sequence is:
|
|
223
258
|
|
|
224
|
-
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.
|
|
259
|
+
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.4` (see Prerequisites above).
|
|
225
260
|
2. **Install the plugin** — follow the Codex or Claude Code section above.
|
|
226
261
|
3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
|
|
227
262
|
below). The skill will:
|
|
@@ -1019,7 +1054,7 @@ with append-only behavior; it does not overwrite local rules.
|
|
|
1019
1054
|
### Recovery Steps
|
|
1020
1055
|
|
|
1021
1056
|
```bash
|
|
1022
|
-
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.
|
|
1057
|
+
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.4)
|
|
1023
1058
|
pnpm install --frozen-lockfile
|
|
1024
1059
|
|
|
1025
1060
|
# 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
|
|
@@ -1086,7 +1121,7 @@ pnpm exec artifact-graph hooks install-git --hook all
|
|
|
1086
1121
|
### Enterprise Mirror
|
|
1087
1122
|
|
|
1088
1123
|
If the corporate environment cannot access the public npm registry or GitHub, mirror both
|
|
1089
|
-
`artifact-graph@0.9.
|
|
1124
|
+
`artifact-graph@0.9.4` and the plugin marketplace repository on an internal registry. The mirror
|
|
1090
1125
|
does not change the state ownership model: Git-tracked files remain authoritative, local caches
|
|
1091
1126
|
remain derived.
|
|
1092
1127
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0",
|
|
3
|
-
"pluginVersion": "0.9.
|
|
3
|
+
"pluginVersion": "0.9.4",
|
|
4
4
|
"artifactGraph": {
|
|
5
|
-
"verifiedVersion": "0.9.
|
|
6
|
-
"installSpec": "artifact-graph@0.9.
|
|
7
|
-
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
5
|
+
"verifiedVersion": "0.9.4",
|
|
6
|
+
"installSpec": "artifact-graph@0.9.4",
|
|
7
|
+
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.4"
|
|
8
8
|
}
|
|
9
9
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: where-am-i
|
|
3
|
-
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助
|
|
3
|
+
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助 AI 编码助手根据当前项目配置自动检索现有制品并判断应使用哪条 artifact-graph context/packet 命令和后续技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
<!-- @feature ACA12 @scenario S-39 -->
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "artifact-chain-assistant",
|
|
3
3
|
"displayName": "Artifact Chain Assistant",
|
|
4
|
-
"version": "0.9.
|
|
4
|
+
"version": "0.9.4",
|
|
5
5
|
"description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "广州市风荷科技有限公司"
|
|
@@ -5,18 +5,20 @@
|
|
|
5
5
|
|
|
6
6
|
This guide separates two responsibilities:
|
|
7
7
|
|
|
8
|
-
1. Install the assistant plugin into Codex
|
|
8
|
+
1. Install the assistant plugin into Codex, Claude Code, Kimi Code, or Qoder.
|
|
9
9
|
2. Prepare each target project so the plugin has a project-local artifact chain to manage.
|
|
10
10
|
|
|
11
11
|
Codex exposes `.codex-plugin/plugin.json` and `skills/**` only. Claude Code also exposes slash
|
|
12
|
-
command wrappers and a Stop-hook guardrail.
|
|
12
|
+
command wrappers and a Stop-hook guardrail. Qoder currently runs in skill-compatible mode: it
|
|
13
|
+
installs and discovers the shared skills but does not receive slash command wrappers or the
|
|
14
|
+
Stop-hook guardrail (see [Qoder](#qoder)). Neither host surface replaces Git hooks or CI: those
|
|
13
15
|
remain the hard gates for a target project's artifacts, graph config, version lock, and project
|
|
14
16
|
instructions.
|
|
15
17
|
|
|
16
18
|
## Prerequisites
|
|
17
19
|
|
|
18
20
|
- Node.js `>=22.0.0`.
|
|
19
|
-
- `artifact-graph` 0.9.
|
|
21
|
+
- `artifact-graph` 0.9.4 installed in the target project.
|
|
20
22
|
- **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
|
|
21
23
|
have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
|
|
22
24
|
profile, or add the marketplace with an explicit `https://` URL. Codex users can check
|
|
@@ -28,24 +30,24 @@ instructions.
|
|
|
28
30
|
|
|
29
31
|
| Plugin | Verified Runtime | Install |
|
|
30
32
|
| --- | --- | --- |
|
|
31
|
-
| `artifact-chain-assistant` 0.9.
|
|
33
|
+
| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
|
|
32
34
|
|
|
33
35
|
### Install The Runtime
|
|
34
36
|
|
|
35
37
|
The default installation path uses the npm registry with a precise version:
|
|
36
38
|
|
|
37
39
|
```bash
|
|
38
|
-
pnpm add -D artifact-graph@0.9.
|
|
40
|
+
pnpm add -D artifact-graph@0.9.4
|
|
39
41
|
```
|
|
40
42
|
|
|
41
43
|
If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
|
|
42
44
|
|
|
43
45
|
```bash
|
|
44
|
-
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
46
|
+
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.4
|
|
45
47
|
```
|
|
46
48
|
|
|
47
49
|
> **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
|
|
48
|
-
> `artifact-graph@^0.9.
|
|
50
|
+
> `artifact-graph@^0.9.4`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
|
|
49
51
|
> Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
|
|
50
52
|
|
|
51
53
|
With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
|
|
@@ -72,7 +74,7 @@ allowBuilds:
|
|
|
72
74
|
|
|
73
75
|
The plugin's `doctor` command validates the installed runtime version before running any
|
|
74
76
|
diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
|
|
75
|
-
command (`pnpm add -D artifact-graph@0.9.
|
|
77
|
+
command (`pnpm add -D artifact-graph@0.9.4`) and exits non-zero.
|
|
76
78
|
|
|
77
79
|
### CLI Resolution Order
|
|
78
80
|
|
|
@@ -147,7 +149,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
|
|
|
147
149
|
|
|
148
150
|
> **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
|
|
149
151
|
> plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
|
|
150
|
-
> must publish and enable `artifact-chain-assistant` 0.9.
|
|
152
|
+
> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
|
|
151
153
|
> succeed.
|
|
152
154
|
|
|
153
155
|
### Kimi Code
|
|
@@ -174,6 +176,39 @@ skills, and managed scripts (`doctor.mjs`, `check-workflow-profile.mjs`, `run-ar
|
|
|
174
176
|
non-interactive install CLI, so automated install verification is limited to layout checks;
|
|
175
177
|
use `artifact-chain-maintainer` to guide version-lock CLI operations.
|
|
176
178
|
|
|
179
|
+
### Qoder
|
|
180
|
+
|
|
181
|
+
Qoder is currently supported as a **skill-compatible host**, not as a fourth adapter. It reuses the
|
|
182
|
+
existing `artifact-skill-set` marketplace: Qoder recognizes the root
|
|
183
|
+
`.claude-plugin/marketplace.json` and installs the shared plugin root (`skills/**`), so no
|
|
184
|
+
Qoder-specific manifest or duplicated runtime assets are required.
|
|
185
|
+
|
|
186
|
+
Register the marketplace and install the plugin (illustrative commands):
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
qodercli plugin marketplace add ifoohoo/artifact-skill-set --scope user
|
|
190
|
+
qodercli plugin install artifact-chain-assistant@artifact-skill-set --scope user --json
|
|
191
|
+
qodercli plugin list --json
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
> The exact flags may change between Qoder CLI releases. Treat the commands above as
|
|
195
|
+
> illustrations and confirm against `qodercli plugin ... --help` at execution time.
|
|
196
|
+
|
|
197
|
+
Current support boundary:
|
|
198
|
+
|
|
199
|
+
- **Committed**: plugin installation and shared skill discovery. Qoder installs
|
|
200
|
+
`artifact-chain-assistant` from the marketplace and discovers the shared `skills/` entries.
|
|
201
|
+
- **Not committed**: Claude Code slash command wrappers and the Stop-hook guardrail are not
|
|
202
|
+
provided for Qoder. `commands` and `hooks` being empty in `plugin list --json` is expected,
|
|
203
|
+
not a defect.
|
|
204
|
+
|
|
205
|
+
Verify an installation with `qodercli plugin list --json`: confirm the installed version, that the
|
|
206
|
+
plugin is enabled, that `installPath` points at the expected location, and that the `skills` list
|
|
207
|
+
matches the shared skill set. Diagnostics still use the plugin root `scripts/doctor.mjs` — resolve
|
|
208
|
+
the installed root from the `installPath` reported by `plugin list --json`, then run
|
|
209
|
+
`node "$PLUGIN_ROOT/scripts/doctor.mjs" --root . --format json`. There is no Qoder-specific
|
|
210
|
+
adapter doctor.
|
|
211
|
+
|
|
177
212
|
## Post-Installation Discovery
|
|
178
213
|
|
|
179
214
|
After installing the plugin, use these entry points to understand available capabilities:
|
|
@@ -221,7 +256,7 @@ The plugin should not move these files into the plugin repository.
|
|
|
221
256
|
|
|
222
257
|
For a first-time setup, the end-to-end sequence is:
|
|
223
258
|
|
|
224
|
-
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.
|
|
259
|
+
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.4` (see Prerequisites above).
|
|
225
260
|
2. **Install the plugin** — follow the Codex or Claude Code section above.
|
|
226
261
|
3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
|
|
227
262
|
below). The skill will:
|
|
@@ -1019,7 +1054,7 @@ with append-only behavior; it does not overwrite local rules.
|
|
|
1019
1054
|
### Recovery Steps
|
|
1020
1055
|
|
|
1021
1056
|
```bash
|
|
1022
|
-
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.
|
|
1057
|
+
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.4)
|
|
1023
1058
|
pnpm install --frozen-lockfile
|
|
1024
1059
|
|
|
1025
1060
|
# 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
|
|
@@ -1086,7 +1121,7 @@ pnpm exec artifact-graph hooks install-git --hook all
|
|
|
1086
1121
|
### Enterprise Mirror
|
|
1087
1122
|
|
|
1088
1123
|
If the corporate environment cannot access the public npm registry or GitHub, mirror both
|
|
1089
|
-
`artifact-graph@0.9.
|
|
1124
|
+
`artifact-graph@0.9.4` and the plugin marketplace repository on an internal registry. The mirror
|
|
1090
1125
|
does not change the state ownership model: Git-tracked files remain authoritative, local caches
|
|
1091
1126
|
remain derived.
|
|
1092
1127
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0",
|
|
3
|
-
"pluginVersion": "0.9.
|
|
3
|
+
"pluginVersion": "0.9.4",
|
|
4
4
|
"artifactGraph": {
|
|
5
|
-
"verifiedVersion": "0.9.
|
|
6
|
-
"installSpec": "artifact-graph@0.9.
|
|
7
|
-
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
5
|
+
"verifiedVersion": "0.9.4",
|
|
6
|
+
"installSpec": "artifact-graph@0.9.4",
|
|
7
|
+
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.4"
|
|
8
8
|
}
|
|
9
9
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: where-am-i
|
|
3
|
-
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助
|
|
3
|
+
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助 AI 编码助手根据当前项目配置自动检索现有制品并判断应使用哪条 artifact-graph context/packet 命令和后续技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
<!-- @feature ACA12 @scenario S-39 -->
|
package/adapters/kimi/INSTALL.md
CHANGED
|
@@ -5,18 +5,20 @@
|
|
|
5
5
|
|
|
6
6
|
This guide separates two responsibilities:
|
|
7
7
|
|
|
8
|
-
1. Install the assistant plugin into Codex
|
|
8
|
+
1. Install the assistant plugin into Codex, Claude Code, Kimi Code, or Qoder.
|
|
9
9
|
2. Prepare each target project so the plugin has a project-local artifact chain to manage.
|
|
10
10
|
|
|
11
11
|
Codex exposes `.codex-plugin/plugin.json` and `skills/**` only. Claude Code also exposes slash
|
|
12
|
-
command wrappers and a Stop-hook guardrail.
|
|
12
|
+
command wrappers and a Stop-hook guardrail. Qoder currently runs in skill-compatible mode: it
|
|
13
|
+
installs and discovers the shared skills but does not receive slash command wrappers or the
|
|
14
|
+
Stop-hook guardrail (see [Qoder](#qoder)). Neither host surface replaces Git hooks or CI: those
|
|
13
15
|
remain the hard gates for a target project's artifacts, graph config, version lock, and project
|
|
14
16
|
instructions.
|
|
15
17
|
|
|
16
18
|
## Prerequisites
|
|
17
19
|
|
|
18
20
|
- Node.js `>=22.0.0`.
|
|
19
|
-
- `artifact-graph` 0.9.
|
|
21
|
+
- `artifact-graph` 0.9.4 installed in the target project.
|
|
20
22
|
- **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
|
|
21
23
|
have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
|
|
22
24
|
profile, or add the marketplace with an explicit `https://` URL. Codex users can check
|
|
@@ -28,24 +30,24 @@ instructions.
|
|
|
28
30
|
|
|
29
31
|
| Plugin | Verified Runtime | Install |
|
|
30
32
|
| --- | --- | --- |
|
|
31
|
-
| `artifact-chain-assistant` 0.9.
|
|
33
|
+
| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
|
|
32
34
|
|
|
33
35
|
### Install The Runtime
|
|
34
36
|
|
|
35
37
|
The default installation path uses the npm registry with a precise version:
|
|
36
38
|
|
|
37
39
|
```bash
|
|
38
|
-
pnpm add -D artifact-graph@0.9.
|
|
40
|
+
pnpm add -D artifact-graph@0.9.4
|
|
39
41
|
```
|
|
40
42
|
|
|
41
43
|
If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
|
|
42
44
|
|
|
43
45
|
```bash
|
|
44
|
-
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
46
|
+
pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.4
|
|
45
47
|
```
|
|
46
48
|
|
|
47
49
|
> **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
|
|
48
|
-
> `artifact-graph@^0.9.
|
|
50
|
+
> `artifact-graph@^0.9.4`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
|
|
49
51
|
> Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
|
|
50
52
|
|
|
51
53
|
With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
|
|
@@ -72,7 +74,7 @@ allowBuilds:
|
|
|
72
74
|
|
|
73
75
|
The plugin's `doctor` command validates the installed runtime version before running any
|
|
74
76
|
diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
|
|
75
|
-
command (`pnpm add -D artifact-graph@0.9.
|
|
77
|
+
command (`pnpm add -D artifact-graph@0.9.4`) and exits non-zero.
|
|
76
78
|
|
|
77
79
|
### CLI Resolution Order
|
|
78
80
|
|
|
@@ -147,7 +149,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
|
|
|
147
149
|
|
|
148
150
|
> **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
|
|
149
151
|
> plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
|
|
150
|
-
> must publish and enable `artifact-chain-assistant` 0.9.
|
|
152
|
+
> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
|
|
151
153
|
> succeed.
|
|
152
154
|
|
|
153
155
|
### Kimi Code
|
|
@@ -174,6 +176,39 @@ skills, and managed scripts (`doctor.mjs`, `check-workflow-profile.mjs`, `run-ar
|
|
|
174
176
|
non-interactive install CLI, so automated install verification is limited to layout checks;
|
|
175
177
|
use `artifact-chain-maintainer` to guide version-lock CLI operations.
|
|
176
178
|
|
|
179
|
+
### Qoder
|
|
180
|
+
|
|
181
|
+
Qoder is currently supported as a **skill-compatible host**, not as a fourth adapter. It reuses the
|
|
182
|
+
existing `artifact-skill-set` marketplace: Qoder recognizes the root
|
|
183
|
+
`.claude-plugin/marketplace.json` and installs the shared plugin root (`skills/**`), so no
|
|
184
|
+
Qoder-specific manifest or duplicated runtime assets are required.
|
|
185
|
+
|
|
186
|
+
Register the marketplace and install the plugin (illustrative commands):
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
qodercli plugin marketplace add ifoohoo/artifact-skill-set --scope user
|
|
190
|
+
qodercli plugin install artifact-chain-assistant@artifact-skill-set --scope user --json
|
|
191
|
+
qodercli plugin list --json
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
> The exact flags may change between Qoder CLI releases. Treat the commands above as
|
|
195
|
+
> illustrations and confirm against `qodercli plugin ... --help` at execution time.
|
|
196
|
+
|
|
197
|
+
Current support boundary:
|
|
198
|
+
|
|
199
|
+
- **Committed**: plugin installation and shared skill discovery. Qoder installs
|
|
200
|
+
`artifact-chain-assistant` from the marketplace and discovers the shared `skills/` entries.
|
|
201
|
+
- **Not committed**: Claude Code slash command wrappers and the Stop-hook guardrail are not
|
|
202
|
+
provided for Qoder. `commands` and `hooks` being empty in `plugin list --json` is expected,
|
|
203
|
+
not a defect.
|
|
204
|
+
|
|
205
|
+
Verify an installation with `qodercli plugin list --json`: confirm the installed version, that the
|
|
206
|
+
plugin is enabled, that `installPath` points at the expected location, and that the `skills` list
|
|
207
|
+
matches the shared skill set. Diagnostics still use the plugin root `scripts/doctor.mjs` — resolve
|
|
208
|
+
the installed root from the `installPath` reported by `plugin list --json`, then run
|
|
209
|
+
`node "$PLUGIN_ROOT/scripts/doctor.mjs" --root . --format json`. There is no Qoder-specific
|
|
210
|
+
adapter doctor.
|
|
211
|
+
|
|
177
212
|
## Post-Installation Discovery
|
|
178
213
|
|
|
179
214
|
After installing the plugin, use these entry points to understand available capabilities:
|
|
@@ -221,7 +256,7 @@ The plugin should not move these files into the plugin repository.
|
|
|
221
256
|
|
|
222
257
|
For a first-time setup, the end-to-end sequence is:
|
|
223
258
|
|
|
224
|
-
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.
|
|
259
|
+
1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.4` (see Prerequisites above).
|
|
225
260
|
2. **Install the plugin** — follow the Codex or Claude Code section above.
|
|
226
261
|
3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
|
|
227
262
|
below). The skill will:
|
|
@@ -1019,7 +1054,7 @@ with append-only behavior; it does not overwrite local rules.
|
|
|
1019
1054
|
### Recovery Steps
|
|
1020
1055
|
|
|
1021
1056
|
```bash
|
|
1022
|
-
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.
|
|
1057
|
+
# 1. Install dependencies from lockfile (gets artifact-graph@0.9.4)
|
|
1023
1058
|
pnpm install --frozen-lockfile
|
|
1024
1059
|
|
|
1025
1060
|
# 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
|
|
@@ -1086,7 +1121,7 @@ pnpm exec artifact-graph hooks install-git --hook all
|
|
|
1086
1121
|
### Enterprise Mirror
|
|
1087
1122
|
|
|
1088
1123
|
If the corporate environment cannot access the public npm registry or GitHub, mirror both
|
|
1089
|
-
`artifact-graph@0.9.
|
|
1124
|
+
`artifact-graph@0.9.4` and the plugin marketplace repository on an internal registry. The mirror
|
|
1090
1125
|
does not change the state ownership model: Git-tracked files remain authoritative, local caches
|
|
1091
1126
|
remain derived.
|
|
1092
1127
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0",
|
|
3
|
-
"pluginVersion": "0.9.
|
|
3
|
+
"pluginVersion": "0.9.4",
|
|
4
4
|
"artifactGraph": {
|
|
5
|
-
"verifiedVersion": "0.9.
|
|
6
|
-
"installSpec": "artifact-graph@0.9.
|
|
7
|
-
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
5
|
+
"verifiedVersion": "0.9.4",
|
|
6
|
+
"installSpec": "artifact-graph@0.9.4",
|
|
7
|
+
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.4"
|
|
8
8
|
}
|
|
9
9
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: where-am-i
|
|
3
|
-
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助
|
|
3
|
+
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助 AI 编码助手根据当前项目配置自动检索现有制品并判断应使用哪条 artifact-graph context/packet 命令和后续技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
<!-- @feature ACA12 @scenario S-39 -->
|
package/compatibility.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0",
|
|
3
|
-
"pluginVersion": "0.9.
|
|
3
|
+
"pluginVersion": "0.9.4",
|
|
4
4
|
"artifactGraph": {
|
|
5
|
-
"verifiedVersion": "0.9.
|
|
6
|
-
"installSpec": "artifact-graph@0.9.
|
|
7
|
-
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.
|
|
5
|
+
"verifiedVersion": "0.9.4",
|
|
6
|
+
"installSpec": "artifact-graph@0.9.4",
|
|
7
|
+
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.4"
|
|
8
8
|
}
|
|
9
9
|
}
|
package/family-apis/catalog.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "artifact-chain-assistant",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.4",
|
|
4
4
|
"description": "Codex, Claude Code, and Kimi Code assistant plugin for artifact-chain projects",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
@@ -99,6 +99,6 @@
|
|
|
99
99
|
},
|
|
100
100
|
"devDependencies": {
|
|
101
101
|
"ajv": "^8.20.0",
|
|
102
|
-
"artifact-graph": "0.9.
|
|
102
|
+
"artifact-graph": "0.9.4"
|
|
103
103
|
}
|
|
104
104
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: where-am-i
|
|
3
|
-
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助
|
|
3
|
+
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助 AI 编码助手根据当前项目配置自动检索现有制品并判断应使用哪条 artifact-graph context/packet 命令和后续技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
<!-- @feature ACA12 @scenario S-39 -->
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: where-am-i
|
|
3
|
-
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助
|
|
3
|
+
description: 面向任意 artifact-graph 项目的搜索优先需求分诊技能。用于用户用自然语言提出模糊需求、询问接下来做什么、确认某个功能/规格/设计/契约/测试是否已存在,或从 PRD、场景、API/IPC/数据/报告/UI 契约、原型/样式问题、测试想法、规则纠偏、产品缺口进入开发前,帮助 AI 编码助手根据当前项目配置自动检索现有制品并判断应使用哪条 artifact-graph context/packet 命令和后续技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
<!-- @feature ACA12 @scenario S-39 -->
|