@akagilnc/pi-workflow-roles 0.1.3803 → 0.1.3808
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.md +1 -1
- package/README.md +1 -14
- package/README.zh-CN.md +1 -14
- package/package.json +1 -1
- package/souls/fixer-output-guide.md +1 -1
- package/souls/quality-law.md +1 -1
package/CLAUDE.md
CHANGED
|
@@ -78,7 +78,7 @@ A probe is temporary evidence. After its evidence purpose is disposed, either de
|
|
|
78
78
|
|
|
79
79
|
**机器只咬契约,不咬呈现**:对自由文本的正则/措辞/表头机械依赖、对图像的像素机械依赖,视同缺陷;机器要消费的信息必须以键、typed 字段或 schema 提供。呈现为人服务,随时可重排。
|
|
80
80
|
|
|
81
|
-
**生产与统计两个 regime(陛下 2026-08-25 释宪)**:上条禁令的对象是生产代码对不可穷举输入的机械依赖。统计/分析对**已冻结卷宗**不适用该禁令——太史报告层可由 LLM 做语义分类与统计,逐条附卷宗引证即为可核;形式语言命令(shell 等)非散文,不因 LLM 书写而成「自由文本」。太史代码机制维持确定性(ADR 0047/0068 不动);闸判据仍只认 typed
|
|
81
|
+
**生产与统计两个 regime(陛下 2026-08-25 释宪)**:上条禁令的对象是生产代码对不可穷举输入的机械依赖。统计/分析对**已冻结卷宗**不适用该禁令——太史报告层可由 LLM 做语义分类与统计,逐条附卷宗引证即为可核;形式语言命令(shell 等)非散文,不因 LLM 书写而成「自由文本」。太史代码机制维持确定性(ADR 0047/0068 不动);闸判据仍只认 typed 键。报告引证同符宝郎证据条款(陛下 2026-09-09 释宪):**指针(runId/toolCallId/路径)即合格引用,开卷核对相符即成立;同样字数能说清的结论直接摘抄亦合格,判据是读者省事,不为指针而指针**——禁的只是往报告里灌大段原文,卷宗仍是唯一真源;举证到问题所需粒度为止,汇总申报方法与判据即可,不逐条立账。
|
|
82
82
|
|
|
83
83
|
**票面先过给事中再开工;决策问题上呈陛下。**(ADR 0074:票庭审读由大理寺移交门下省给事中。)
|
|
84
84
|
|
package/README.md
CHANGED
|
@@ -13,20 +13,7 @@ export PATH="$HOME/.pi/agent/npm/node_modules/.bin:$PATH"
|
|
|
13
13
|
|
|
14
14
|
Update with `pi update npm:@akagilnc/pi-workflow-roles`—never a second global `npm install -g`. Inspect with `ak-role roles` and `ak-role help <role>`; seat and Gate-officer configuration lives under Reading results below.
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
Family / dogfood installs use the same package under dist-tag `next`. Pi installation surface is isolated via `PI_CODING_AGENT_DIR` (package config, ledger, and books remain machine-scoped under user home, never following `HOME`). Do not mount or copy host credentials into the test surface; do not use a book/worktree as a stand-in for install isolation. No second global npm.
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
export PI_CODING_AGENT_DIR="/path/to/test-surface/.pi/agent"
|
|
22
|
-
export PATH="$PI_CODING_AGENT_DIR/npm/node_modules/.bin:$PATH"
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
- **First install of next**: `pi install npm:@akagilnc/pi-workflow-roles@next` → `ak-role roles` runs; installed version looks like `0.1.<count>-next.<shortsha>`.
|
|
26
|
-
- **Advance to a newer next**: `pi update npm:@akagilnc/pi-workflow-roles@next` → `<shortsha>` becomes the new CI `head_sha` prefix (7 chars).
|
|
27
|
-
- **Same-version reinstall / restore**: rerun the first-install command → idempotent; version unchanged (stamp path that only moves the dist-tag when the version is already on the registry).
|
|
28
|
-
|
|
29
|
-
Publish routing (Actions, not local stamp): successful `ci` push on `main` → `latest`; successful `ci` push on an allowlisted non-main branch (see `.github/workflows/ci.yml` `push.branches`) → `next`. PR completions and failed CI never publish.
|
|
16
|
+
Publish routing (Actions, not local stamp): successful `ci` push on the repository default branch → `latest`. Non-default-branch CI completions, PR completions, and failed CI never publish.
|
|
30
17
|
|
|
31
18
|
## Reading results
|
|
32
19
|
|
package/README.zh-CN.md
CHANGED
|
@@ -13,20 +13,7 @@ export PATH="$HOME/.pi/agent/npm/node_modules/.bin:$PATH"
|
|
|
13
13
|
|
|
14
14
|
更新用 `pi update npm:@akagilnc/pi-workflow-roles`——勿另起全局 `npm install -g`。查看能力:`ak-role roles`、`ak-role help <role>`;席位与官席配置见下方「读结果」。
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
家族/dogfood 安装面复用同一包,经 dist-tag `next` 取得;Pi 安装面经 `PI_CODING_AGENT_DIR` 隔离(包配置、账本与 book 仍属于机器用户家目录,不随 `HOME` 漂移),不与宿主已装包共享。测试面不挂载、不复制宿主凭据;不以 book/worktree 冒充安装隔离。不装第二份全局 npm。
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
export PI_CODING_AGENT_DIR="/path/to/test-surface/.pi/agent"
|
|
22
|
-
export PATH="$PI_CODING_AGENT_DIR/npm/node_modules/.bin:$PATH"
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
- **首次装 next**:`pi install npm:@akagilnc/pi-workflow-roles@next` → `ak-role roles` 可跑;装到的版本形如 `0.1.<count>-next.<shortsha>`。
|
|
26
|
-
- **推进到新 next**:`pi update npm:@akagilnc/pi-workflow-roles@next` → 版本号里的 `<shortsha>` 变为新 CI `head_sha` 的前 7 位。
|
|
27
|
-
- **同版本重装/恢复**:重跑首次安装命令 → 幂等,版本不变(对应 stamp「版本已在 registry 则只移 dist-tag」路径)。
|
|
28
|
-
|
|
29
|
-
发布路由(Actions 真入口,非本地 stamp):`ci` 在 `main` 上成功 push → `latest`;`ci` 在 allowlist 非 main 分支上成功 push(见 `.github/workflows/ci.yml` 的 `push.branches`)→ `next`。PR completion 与失败 CI 不发布。
|
|
16
|
+
发布路由(Actions 真入口,非本地 stamp):`ci` 在仓库默认分支上成功 push → `latest`。非默认分支的 CI completion、PR completion 与失败 CI 不发布。
|
|
30
17
|
|
|
31
18
|
## 读结果
|
|
32
19
|
|
package/package.json
CHANGED
package/souls/quality-law.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
测试只保**调用输入正确**的最短确定性案:从真实入口进入,在外部可见的结构化结果上断言,秒级完成。涉真实宿主、真实 LLM、真实并发、真实网络的行为,不写测试;以真跑为证。
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
修复的证明是**变异真跑**:装回旧逻辑,真实入口秒级报红;恢复后绿。命令与结果入回执:指针(runId/toolCallId)或摘抄结论皆合格,以读者能直接核为准(仓级 CLAUDE.md 证据条款)。不为证明修复造测试;拆掉的证明性测试不得换形再造。
|
|
16
16
|
|
|
17
17
|
测试向 spec 负责,不向实现妥协:不得靠放松断言、删除失败路径或 mock 被测行为使测试变绿。
|
|
18
18
|
|