@gavinmo1/skills 0.0.0-stage → 0.1.0
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/LICENSE +22 -0
- package/README.md +91 -2
- package/bin/cli.mjs +169 -0
- package/package.json +34 -4
- package/skills/plan-review-loop/SKILL.md +192 -0
- package/skills/plan-review-loop/agents/openai.yaml +3 -0
- package/skills/plan-review-loop/references/adversarial-review.md +49 -0
- package/skills/plan-review-loop/references/alternative-review.md +67 -0
- package/skills/plan-review-loop/references/loop-design.md +60 -0
- package/skills/plan-review-loop/references/multi-route-review.md +62 -0
- package/skills/plan-review-loop/references/review-protocol.md +94 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 GavinMo1
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
22
|
+
|
package/README.md
CHANGED
|
@@ -1,3 +1,92 @@
|
|
|
1
|
-
#
|
|
1
|
+
# skills
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Agent skill 集合。每个 skill 是 `skills/` 下的一个目录,目录里必须有 `SKILL.md`(frontmatter 含 `name` 与 `description`),可选 `references/`、`agents/` 等附属文件。
|
|
4
|
+
|
|
5
|
+
## 安装
|
|
6
|
+
|
|
7
|
+
需要 Node.js ≥ 18,无需全局安装任何东西。装完写到 `~/.agents/skills/`,agent 下次启动即可读到。
|
|
8
|
+
|
|
9
|
+
### 方式一:直接从 GitHub 跑(现在可用)
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npx github:GavinMo1/skills-repo add plan-review-loop
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
若报 `EALLOWGIT`(npm 11+ 默认 `allow-git=none`,拒绝从 git 取包),加一个开关:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npx --yes --allow-git=all github:GavinMo1/skills-repo add plan-review-loop
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### 方式二:克隆后本地跑(任何 npm 配置下都可用)
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
git clone https://github.com/GavinMo1/skills-repo
|
|
25
|
+
node skills-repo/bin/cli.mjs add plan-review-loop
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### 方式三:npm(发布后)
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
npx @gavinmo1/skills add plan-review-loop
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
> 这个包**尚未发布到 npm**,现在还不能用这条。
|
|
35
|
+
|
|
36
|
+
### 常用命令
|
|
37
|
+
|
|
38
|
+
下文用 `npx @gavinmo1/skills` 代表下面的安装命令;发布前请等量替换成
|
|
39
|
+
`npx --yes --allow-git=all github:GavinMo1/skills-repo`。
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx @gavinmo1/skills list # 列出可用 skill
|
|
43
|
+
npx @gavinmo1/skills add --all # 全部安装
|
|
44
|
+
npx @gavinmo1/skills add plan-review-loop --project # 装到当前项目 ./.agents/skills
|
|
45
|
+
npx @gavinmo1/skills add plan-review-loop --force # 覆盖,旧版本移入 .trash/
|
|
46
|
+
npx @gavinmo1/skills add plan-review-loop --link # junction 指向本地克隆,改完立即生效
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 装到哪里
|
|
50
|
+
|
|
51
|
+
| 目标 | 命令 | 结果 |
|
|
52
|
+
|---|---|---|
|
|
53
|
+
| 用户级(默认) | `add <name>` | `~/.agents/skills/<name>/` |
|
|
54
|
+
| 当前项目 | `add <name> --project` | `./.agents/skills/<name>/` |
|
|
55
|
+
| 任意目录 | `add <name> --dir <path>` | `<path>/<name>/`(支持 `~`) |
|
|
56
|
+
|
|
57
|
+
若你的 agent 从别的目录读 skill(例如 `~/.claude/skills`),用 `--dir` 指过去即可:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
npx github:GavinMo1/skills-repo add plan-review-loop --dir ~/.claude/skills
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### 安全说明
|
|
64
|
+
|
|
65
|
+
- **不会删除任何东西**:目标已存在时默认拒绝安装;加 `--force` 才覆盖,且旧版本先移到目标目录下的 `.trash/<name>-<时间戳>/`。
|
|
66
|
+
- 默认整目录复制。`--link` 用 junction/符号链接指向你的本地克隆,适合边改边用,不适合长期保留。
|
|
67
|
+
|
|
68
|
+
## 现有 skill
|
|
69
|
+
|
|
70
|
+
| skill | 用途 |
|
|
71
|
+
|---|---|
|
|
72
|
+
| plan-review-loop | 制定或修订要交给用户执行的方案时,用独立评审、修订、复评闭环,产出可直接开工的方案 |
|
|
73
|
+
|
|
74
|
+
## 添加新 skill
|
|
75
|
+
|
|
76
|
+
1. 新建 `skills/<name>/`,放入 `SKILL.md`;附属文件一并放进去(安装器整目录复制)。
|
|
77
|
+
2. 在上面那张表里加一行。
|
|
78
|
+
3. 提交并打版本:`npm version minor` → `git push --follow-tags`。
|
|
79
|
+
|
|
80
|
+
一个 skill 的所有文件都必须留在自己的目录里,不要跨 skill 引用文件——安装是逐目录复制的,跨目录引用装上就断。
|
|
81
|
+
|
|
82
|
+
## 开发
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
node bin/cli.mjs list
|
|
86
|
+
node bin/cli.mjs add plan-review-loop --dir /tmp/skills-test
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## 许可
|
|
90
|
+
|
|
91
|
+
MIT
|
|
92
|
+
|
package/bin/cli.mjs
ADDED
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { readFile, readdir, cp, mkdir, rename, symlink, access } from 'node:fs/promises';
|
|
3
|
+
import os from 'node:os';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
import { fileURLToPath } from 'node:url';
|
|
6
|
+
|
|
7
|
+
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
|
8
|
+
const REPO_SKILLS = path.resolve(HERE, '..', 'skills');
|
|
9
|
+
|
|
10
|
+
const die = (msg) => {
|
|
11
|
+
console.error(`[skills] ${msg}`);
|
|
12
|
+
process.exit(1);
|
|
13
|
+
};
|
|
14
|
+
const exists = async (p) => {
|
|
15
|
+
try {
|
|
16
|
+
await access(p);
|
|
17
|
+
return true;
|
|
18
|
+
} catch {
|
|
19
|
+
return false;
|
|
20
|
+
}
|
|
21
|
+
};
|
|
22
|
+
const stamp = () => new Date().toISOString().replace(/[:.]/g, '-');
|
|
23
|
+
|
|
24
|
+
// 允许 --dir ~/xxx;PowerShell 不保证替原生命令展开 ~
|
|
25
|
+
const expandHome = (p) =>
|
|
26
|
+
p === '~' || p.startsWith('~/') || p.startsWith('~\\') ? path.join(os.homedir(), p.slice(1)) : p;
|
|
27
|
+
|
|
28
|
+
function parseArgs(argv) {
|
|
29
|
+
const opts = { force: false, link: false, all: false, dir: null };
|
|
30
|
+
const positional = [];
|
|
31
|
+
for (let i = 0; i < argv.length; i++) {
|
|
32
|
+
const a = argv[i];
|
|
33
|
+
if (a === '--force' || a === '-f') opts.force = true;
|
|
34
|
+
else if (a === '--link') opts.link = true;
|
|
35
|
+
else if (a === '--all') opts.all = true;
|
|
36
|
+
else if (a === '--project') opts.dir = path.join(process.cwd(), '.agents', 'skills');
|
|
37
|
+
else if (a === '--global') opts.dir = path.join(os.homedir(), '.agents', 'skills');
|
|
38
|
+
else if (a === '--dir') {
|
|
39
|
+
const v = argv[++i];
|
|
40
|
+
if (!v) die('--dir 需要一个路径');
|
|
41
|
+
opts.dir = path.resolve(expandHome(v));
|
|
42
|
+
} else if (a === '-h' || a === '--help') {
|
|
43
|
+
printHelp();
|
|
44
|
+
process.exit(0);
|
|
45
|
+
} else if (a.startsWith('-')) {
|
|
46
|
+
die(`未知参数 ${a}`);
|
|
47
|
+
} else {
|
|
48
|
+
positional.push(a);
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
return { opts, positional };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
const resolveTarget = (opts) => opts.dir ?? path.join(os.homedir(), '.agents', 'skills');
|
|
55
|
+
|
|
56
|
+
async function metaOf(dir) {
|
|
57
|
+
const file = path.join(dir, 'SKILL.md');
|
|
58
|
+
if (!(await exists(file))) return null;
|
|
59
|
+
const text = await readFile(file, 'utf8');
|
|
60
|
+
const fm = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
|
|
61
|
+
if (!fm) return { name: path.basename(dir), description: '(缺 frontmatter)' };
|
|
62
|
+
const pick = (key) => {
|
|
63
|
+
const m = fm[1].match(new RegExp(`^${key}:\\s*(.+)$`, 'm'));
|
|
64
|
+
return m ? m[1].trim().replace(/^["']|["']$/g, '') : '';
|
|
65
|
+
};
|
|
66
|
+
return { name: pick('name') || path.basename(dir), description: pick('description') };
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
async function available() {
|
|
70
|
+
const entries = await readdir(REPO_SKILLS, { withFileTypes: true });
|
|
71
|
+
return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
async function cmdList() {
|
|
75
|
+
const names = await available();
|
|
76
|
+
if (!names.length) {
|
|
77
|
+
console.log('仓库里还没有 skill。在 skills/ 下建一个目录并放入 SKILL.md。');
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
const rows = [];
|
|
81
|
+
for (const n of names) {
|
|
82
|
+
const m = (await metaOf(path.join(REPO_SKILLS, n))) ?? { name: n, description: '(缺 SKILL.md)' };
|
|
83
|
+
rows.push([m.name, m.description]);
|
|
84
|
+
}
|
|
85
|
+
const width = Math.max(...rows.map((r) => r[0].length));
|
|
86
|
+
for (const [n, d] of rows) console.log(`${n.padEnd(width)} ${d}`);
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
async function cmdAdd(names, opts) {
|
|
90
|
+
const have = await available();
|
|
91
|
+
const picked = opts.all ? have : names;
|
|
92
|
+
if (!picked.length) die('用法: add <skill...> 或 add --all(--help 看全部参数)');
|
|
93
|
+
|
|
94
|
+
const missing = picked.filter((n) => !have.includes(n));
|
|
95
|
+
if (missing.length) {
|
|
96
|
+
die(`仓库里没有: ${missing.join(', ')}\n可用: ${have.join(', ') || '(空)'}`);
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
const destRoot = resolveTarget(opts);
|
|
100
|
+
await mkdir(destRoot, { recursive: true });
|
|
101
|
+
|
|
102
|
+
for (const name of picked) {
|
|
103
|
+
const src = path.join(REPO_SKILLS, name);
|
|
104
|
+
const dest = path.join(destRoot, name);
|
|
105
|
+
|
|
106
|
+
if (await exists(dest)) {
|
|
107
|
+
if (!opts.force) {
|
|
108
|
+
die(`${dest} 已存在。确认覆盖请加 --force(旧版本会先移到 ${path.join(destRoot, '.trash')})`);
|
|
109
|
+
}
|
|
110
|
+
const trash = path.join(destRoot, '.trash', `${name}-${stamp()}`);
|
|
111
|
+
await mkdir(path.dirname(trash), { recursive: true });
|
|
112
|
+
await rename(dest, trash);
|
|
113
|
+
console.log(`旧版本已移到 ${trash}`);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
if (opts.link) {
|
|
117
|
+
await symlink(src, dest, 'junction');
|
|
118
|
+
console.log(`✓ ${name} -> ${dest}(junction,指向仓库)`);
|
|
119
|
+
} else {
|
|
120
|
+
await cp(src, dest, { recursive: true, errorOnExist: true, force: false });
|
|
121
|
+
console.log(`✓ ${name} -> ${dest}`);
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
if (!(await exists(path.join(dest, 'SKILL.md')))) {
|
|
125
|
+
console.warn(` 警告: ${name} 安装后没有 SKILL.md,agent 可能无法识别。`);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
console.log(`\n完成,共 ${picked.length} 个。目标目录: ${destRoot}`);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function printHelp() {
|
|
133
|
+
console.log(`skills — 安装本仓库的 agent skill
|
|
134
|
+
|
|
135
|
+
用法:
|
|
136
|
+
skills list 列出仓库里的 skill
|
|
137
|
+
skills add <name...> 安装指定 skill
|
|
138
|
+
skills add --all 安装全部
|
|
139
|
+
skills where 打印默认安装目录
|
|
140
|
+
|
|
141
|
+
选项:
|
|
142
|
+
--dir <path> 装到指定目录
|
|
143
|
+
--project 装到 ./.agents/skills
|
|
144
|
+
--global 装到 ~/.agents/skills(默认)
|
|
145
|
+
--force, -f 目标已存在时覆盖(旧版本移入 .trash/)
|
|
146
|
+
--link 用 junction 指向仓库,不复制文件
|
|
147
|
+
-h, --help 显示本帮助
|
|
148
|
+
|
|
149
|
+
示例:
|
|
150
|
+
npx github:GavinMo1/skills-repo add plan-review-loop
|
|
151
|
+
npx github:GavinMo1/skills-repo add --all --project
|
|
152
|
+
node bin/cli.mjs add plan-review-loop --dir C:\\tmp\\skills-test`);
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
const { opts, positional } = parseArgs(process.argv.slice(2));
|
|
156
|
+
const [cmd, ...rest] = positional;
|
|
157
|
+
|
|
158
|
+
if (!cmd || cmd === 'help') {
|
|
159
|
+
printHelp();
|
|
160
|
+
} else if (cmd === 'list') {
|
|
161
|
+
await cmdList();
|
|
162
|
+
} else if (cmd === 'add' || cmd === 'install') {
|
|
163
|
+
await cmdAdd(rest, opts);
|
|
164
|
+
} else if (cmd === 'where') {
|
|
165
|
+
console.log(resolveTarget(opts));
|
|
166
|
+
} else {
|
|
167
|
+
die(`未知命令 ${cmd},用 --help 看用法`);
|
|
168
|
+
}
|
|
169
|
+
|
package/package.json
CHANGED
|
@@ -1,6 +1,36 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gavinmo1/skills",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Agent skills collection",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"skills": "bin/cli.mjs"
|
|
8
|
+
},
|
|
9
|
+
"files": [
|
|
10
|
+
"bin",
|
|
11
|
+
"skills",
|
|
12
|
+
"README.md",
|
|
13
|
+
"LICENSE"
|
|
14
|
+
],
|
|
15
|
+
"engines": {
|
|
16
|
+
"node": ">=18.17"
|
|
17
|
+
},
|
|
18
|
+
"scripts": {
|
|
19
|
+
"list": "node bin/cli.mjs list"
|
|
20
|
+
},
|
|
21
|
+
"keywords": [
|
|
22
|
+
"agent-skills",
|
|
23
|
+
"skills",
|
|
24
|
+
"npx"
|
|
25
|
+
],
|
|
26
|
+
"license": "MIT",
|
|
27
|
+
"publishConfig": {
|
|
28
|
+
"access": "public",
|
|
29
|
+
"registry": "https://registry.npmjs.org/"
|
|
30
|
+
},
|
|
31
|
+
"repository": {
|
|
32
|
+
"type": "git",
|
|
33
|
+
"url": "git+https://github.com/GavinMo1/skills-repo.git"
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: plan-review-loop
|
|
3
|
+
description: "制定或修订要交给用户执行的方案时,用独立评审、修订、复评闭环,产出用户能直接开工、不必回头追问「当初为什么这么定」的方案。用于写方案、先设计再动手、让 Agent 评审方案。不用于直接编码的小改动、普通问答或仅审查代码。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 方案写评闭环
|
|
7
|
+
|
|
8
|
+
主会话编写方案,核实评审意见,并在授权范围内选择解法。独立评审 Agent 检查方案依据,提出问题,并复核修改。评审不代替用户授权。
|
|
9
|
+
|
|
10
|
+
**用词**:**一路**是一个独立评审分工,由一名 Agent 承担;**一轮**是全部评审路对同一冻结版本完成的一组评审;**一档**是替代解法的甲/乙/丙三种改动尺度,与轮次无关;**收口**指本轮不再修订、转入交付或实测,不等于“通过”(见第 4 节)。
|
|
11
|
+
|
|
12
|
+
## 启动与范围
|
|
13
|
+
|
|
14
|
+
- 如果已有方案,先读取原稿和评审记录,再继续工作。核对用户目标、范围、约束和已确认决策。信息足够时直接开始;缺失信息会影响方案选择时,才向用户提问。
|
|
15
|
+
- 用户指定的评审人数、严重度、轮次和结束条件优先。如果用户指定正式领域流程,按该流程分工和检查,不另加一套审批。普通微调或直接实现请求不自动增加方案审批。
|
|
16
|
+
- **路数由方案失败的代价决定,选择依据写进记录。**
|
|
17
|
+
- **两路**:改动可逆、限于单文件或单模块、不改变用户可见行为、无迁移与切换。用「目标与实现」+「对抗」。
|
|
18
|
+
- **三路**:涉及共享接口、数据迁移、切换与回退、不可逆操作或多人协作。用「目标与实现」「运行与演进」「对抗」。
|
|
19
|
+
- 无论几路,降路必须写明上面哪几条成立;不得降到一路(用户明确指定单路评审时除外,须在记录里写明)。
|
|
20
|
+
- 各路一律用上述中文名指代,**不要写成 A/B/C**——三档替代用甲乙丙,混读会让“路 C(对抗)”与“丙档(不做/缩小)”被当成同一件事。
|
|
21
|
+
- 启动时读取[分工与汇总](references/multi-route-review.md);冻结、派发或恢复时按需读取[评审协议](references/review-protocol.md)的对应章节。派发对抗路前,主会话与该路 Agent 读取[对抗路要求](references/adversarial-review.md)。启用替代路任档时另读[替代路要求](references/alternative-review.md)。修改本 skill 的规则、或想删掉某条规则时,读[设计理由](references/loop-design.md);日常评审不读。
|
|
22
|
+
- 写方案正文前先建**决策登记表**:列出 3–5 个关键选择点(那些一旦选错、后续步骤全要改的地方),每点编一个稳定编号(决策 1、决策 2…),写“选定实现/依据/什么证据会推翻/备选”。它是替代路 乙档与对抗路的共同靶子,也是改动的边界:实质修改应能落到某个决策点上,落不到就要说明为何是兜底修正。
|
|
23
|
+
- 首次派发时,向至少一路明确问一次“不做这个方案、改用现有能力或缩小目标,能覆盖多少需求”(替代路 丙档)。同一个目标往往已有现成机制覆盖大半,这类候选比其他候选更便宜。
|
|
24
|
+
|
|
25
|
+
## 核心任务与核心前提
|
|
26
|
+
|
|
27
|
+
**核心任务**是用户最终必须实现的结果。**核心前提**是结果能够成立的必要条件;缺少它时,依赖它的后续步骤即使正确,也不能实现结果。
|
|
28
|
+
|
|
29
|
+
写方案时,说明核心任务、核心前提和每个前提的依据。用“已证实/待核实/明确不满足”标记前提状态。标“已证实”的核心前提必须给锚点:`文件 :: 符号名`,加一句可证伪条件(“若在该符号内找不到 X,则本条不成立”)。其余断言只需注明依据类别,不必逐条给锚点——证据要求针对核心前提,不平摊给全文。核心前提被证伪会改变某个决策时,正文只引用决策登记表的对应编号,不另写一份推翻条件。
|
|
30
|
+
|
|
31
|
+
区分目标本身的必要条件与当前解法依赖的条件。替代解法可以消除当前解法的依赖,但不能降低用户目标。不要把全部步骤和一般质量偏好都列为核心前提。
|
|
32
|
+
|
|
33
|
+
各路独立检查必要条件是否遗漏、误认或缺少依据。如果某个必要条件不成立,指出该条件为何必要、有什么证据,以及哪些步骤依赖它。优先处理这个阻塞,继续不受影响的检查。待核实不等于失败;尚未执行的检查仍记为未完成。
|
|
34
|
+
|
|
35
|
+
核心前提被证伪时只有两条合法出路,不得含糊放行:
|
|
36
|
+
|
|
37
|
+
- **消除依赖**:改用不依赖该前提的解法(见替代路 甲/乙档);
|
|
38
|
+
- **降级为已披露的残余风险**:仅在前提对本目标不可满足时成立——例如它由上游语义决定(“这类消息在结构上就是用户消息”)、或由用户已确认的范围决定。降级须同时给出:不可解的理由、缓解措施、以及能核查缓解是否生效的验收项,写进风险清单,不得据此声称前提成立或把它改成“部分满足”蒙混过去。
|
|
39
|
+
|
|
40
|
+
评审者不得反复要求解决一个已被合规降级的前提;主会话也不得用降级绕过本可消除的依赖。
|
|
41
|
+
|
|
42
|
+
## 轮次与替代路
|
|
43
|
+
|
|
44
|
+
每路由一名 Agent 承担,不同评审路使用不同 Agent。主会话自评不能充作独立一路。满足通过条件后立即结束,不要求用完预算;轮次上限的用法见第 4 节。
|
|
45
|
+
|
|
46
|
+
预算用尽后不再开轮:按第 4 节交付未复评状态,不宣布通过。只改一行的修订也按普通复评处理,不另找快速通道。
|
|
47
|
+
|
|
48
|
+
替代解法按**改动尺度**分三档,触发条件不同,不要用一个笼统的“要不要加一路”来判断:
|
|
49
|
+
|
|
50
|
+
| 档 | 何时启用 | 成本 |
|
|
51
|
+
|---|---|---|
|
|
52
|
+
| **甲 换路线** | 有依据表明当前解法依赖的核心前提不成立;或当前解法没有可执行的修复动作,但目标可能通过其他机制实现 | 高:需首次盲评 |
|
|
53
|
+
| **乙 换组件** | 每轮都可启用;尤其当同一决策点已被修补两次以上仍未稳定 | 低:直接给候选与推翻条件 |
|
|
54
|
+
| **丙 不做/缩小** | 首次派发时强制问一次;之后按需 | 极低 |
|
|
55
|
+
|
|
56
|
+
各档替换什么、判据与例子见[替代路要求](references/alternative-review.md)。
|
|
57
|
+
|
|
58
|
+
换不换路看改动尺度,不看方案是否通过:**出现甲档触发条件时立即启用甲档;否则作者每轮自问“本轮的争议是否集中在一个决策点上”,是则启用乙档**。
|
|
59
|
+
|
|
60
|
+
未启用 甲档时,作者须在记录里写明判断依据(哪个决策点还没被质疑、哪些证据支持方向成立),不得沉默跳过。乙档与丙档**不新增评审路、不占额外轮次预算**:由现有某一路兼任,探索与对照合起来仍是该路的一项产出。甲档的盲评阶段与对照阶段合起来算该轮的一路,不另计一轮;在轮次结束后才启用甲档时,计入下一轮,不回填旧轮次。
|
|
61
|
+
|
|
62
|
+
启用后,在本循环中保留替代路;每次收到新快照时更新比较,不要求每轮提出新候选。用户固定了路数或设置了更早上限时,遵守该约束,并说明因此没有增加替代路。
|
|
63
|
+
|
|
64
|
+
若目标本身的必要条件只能由用户决策或外部证据解决,不强迫替代路绕开该条件。按退出条件交付阻塞状态。
|
|
65
|
+
|
|
66
|
+
换人、恢复执行、增加评审路或切换解法,都不重新计算已用轮数。在一轮结束前可以针对同一版本增加评审路;一轮结束后再增加,计入下一轮,不回填旧轮次。某一路失败时,其职责由下一轮的换新路补上;该轮记为未完成,仍计入已用轮数,但失败路不记成“无问题”。
|
|
67
|
+
|
|
68
|
+
## 1. 编写并冻结方案
|
|
69
|
+
|
|
70
|
+
核对原始需求、当前实现和现有机制。区分已核实事实、待核实假设和拟议行为。方案需说明目标、前提、范围、需要修改或复用的位置、关键步骤、兼容及失败处理、验证和验收标准。简单方案可用几段写清。
|
|
71
|
+
|
|
72
|
+
复用已有方案及项目文档约定。无约定时使用清晰命名的 Markdown 文件;用户只要对话稿或禁止落盘时保留完整对话稿。方案状态与实现状态分开记录。
|
|
73
|
+
|
|
74
|
+
默认使用**固定版本号和可复现的完整快照**:快照即本轮评审的完整正文,在收到全部评审结果前不修改。
|
|
75
|
+
|
|
76
|
+
影响行为、约束、前提、步骤或验收的修改称为**实质修改**。每次实质修改后,保存新版本并复评;交付前核对正文与最后被评版本是否一致。不改技术含义的「契约精度修订」(消除二义、修引用与常量自洽、收紧断言)仍升版本,但按普通复评处理,不另设快速通道。
|
|
77
|
+
|
|
78
|
+
版本号、正文标记、哈希口径与审计快照见[评审协议](references/review-protocol.md)「版本与快照」与「审计快照与哈希」。
|
|
79
|
+
|
|
80
|
+
方案正文必备一节**已知盲区**,逐条写「盲区名/为何暂不处理/代价/什么条件下必须回来」。移入盲区表不算新增条款,因此“承认这里不知道”永远比“再加一条机制”便宜,删减才停得下来。前提是**该缺口不会让人做错决定**:会让人做错决定的按中问题处理,不许以“已披露”名义移入盲区。
|
|
81
|
+
|
|
82
|
+
## 2. 派发独立评审
|
|
83
|
+
|
|
84
|
+
**每轮的最低配置**:一路未见历史版本的评审者做全量新问题扫描——重读全文,报告新问题;其余复用路只核对闭环表——读正文以核对所引位置,但不做全量扫描,也不承担提出新问题的责任(看到职责外的高/中问题仍要报告)。扫描路的完成标准是全文,复用路的完成标准是闭环表覆盖的位置。复用还是换新的依据见[多路评审](references/multi-route-review.md)。
|
|
85
|
+
|
|
86
|
+
首次派发时优先使用未包含此前方案讨论的新上下文。**盲度由派发消息的内容决定,不由换了哪个 Agent 决定**:消息里只含目标与约束、材料入口、本路职责、冻结正文(含其中已写明的依据锚点与决策登记表)、核心前提及依据;不含评审历史、作者对评审意见的取舍叙述,以及“我们讨论后决定”这类话。派发前把消息读一遍,删掉属于后者的句子。不传其他路当轮结论。不得仅凭“换了个 Agent”宣称盲评成立;工具确实无法隔离上下文时,说明已暴露的材料。**这条只约束首次派发与每轮的扫描路**;复用路必然持有旧意见,其材料见下条。替代路中只有甲档在首次启用时做一次盲评,之后复用同一评审者;乙/丙档直接给候选与对照,不隐藏当前方案。
|
|
87
|
+
|
|
88
|
+
每路获得的材料模板见[评审协议](references/review-protocol.md)「派发材料」。复评时,复用路另附旧意见处理记录;扫描路只附改动清单与改动面,不给旧意见——若确实需要它读闭环表,即为放弃该路本轮的盲度,在记录里写明。
|
|
89
|
+
|
|
90
|
+
输出需包括结论、高/中/低问题计数、有稳定 ID 的问题及依据、检查范围和限制。评审者只读评方案,不修改原文件、不执行拟议实现、不继续派 Agent,也不替用户批准上线。
|
|
91
|
+
|
|
92
|
+
严重度统一为:
|
|
93
|
+
|
|
94
|
+
- **高**:核心方向不可行、明显违反目标或授权,或可能造成严重破坏。
|
|
95
|
+
- **中**:会导致实施错误、关键兼容断裂或无法验收的具体缺口。
|
|
96
|
+
- **低**:不阻碍正确实施的清晰度或维护性建议。
|
|
97
|
+
|
|
98
|
+
只报告有依据的问题,不要求达到某个问题数量。如果评审者需要运行命令才能核实问题,但没有相应工具,应列出所需命令及其目的。主会话只在已有授权内代为执行,再将原始结果交给评审者核实。
|
|
99
|
+
|
|
100
|
+
## 3. 核实意见、修订并复评
|
|
101
|
+
|
|
102
|
+
逐条核对问题证据。高/中问题成立时,修改完整方案,并更新相关步骤和验收标准。根据改进收益决定是否修改低问题。合并重复问题时,保留问题来源和各路新增证据。不因只有一路提出问题就忽略它。
|
|
103
|
+
|
|
104
|
+
按以下方式处理争议:
|
|
105
|
+
|
|
106
|
+
| 类型 | 处理 |
|
|
107
|
+
|---|---|
|
|
108
|
+
| 事实或严重度争议 | 主会话提供原始依据,请提出问题的评审者复核。如果证据不足或实质争议尚未解决,保留未决状态,不自行降低严重度或删除问题 |
|
|
109
|
+
| 满足既定约束的方案偏好 | 主会话可在授权范围内选择解法,并说明理由。存在更优替代解法,不代表当前方案有缺陷 |
|
|
110
|
+
| 两路对同一结论判断相反 | 不取多数、不取较高严重度。要求双方各给一个可判定的最小验证(一条命令、一个输入、要读哪个符号);主会话在授权内执行一次,把原始结果交双方复核。构造不出验证的,记为未决并列入交付——属于第 4 节退出清单里的“争议无法解决”,按未收敛交付,不标通过 |
|
|
111
|
+
| 业务目标、扩权或推翻用户决策 | 列出选项和影响,交用户决定。继续不依赖该决定的工作 |
|
|
112
|
+
|
|
113
|
+
每次实质修改后,主会话向本轮全部评审路提供新全文和修改说明。扫描路重读全文,自行判断改动影响;复用路核对闭环表所引位置及其关联前提与关键步骤。
|
|
114
|
+
|
|
115
|
+
**每项实质修改都要声明本轮改动面**:触及哪几个决策点、是否新增机制(几个;新参数/新状态/新依赖/新时序各计一个)。作者不逐条枚举一致性结论;交界处的交叉由复评方的闭环表与证据锚点核对(见评审协议)。
|
|
116
|
+
|
|
117
|
+
改动面受两条硬线约束:
|
|
118
|
+
|
|
119
|
+
- **不靠新增条款回应新发现**。判据是内容不是计数:删掉这条,会不会有人因此做错决定?不会就不要加;两条规则在说同一件事,先合并再改。不统计条款数。
|
|
120
|
+
- **单轮最多新增一个机制**。“机制”指需要新状态、新参数、新依赖或新时序的改动;单纯增加一个动作步骤不算,但同一轮新增动作超过两处,先合并再改。
|
|
121
|
+
|
|
122
|
+
超线时先删或合并再改,不写成“下轮注意”。
|
|
123
|
+
|
|
124
|
+
新发现必须先过一道判别,再决定它进正文还是别处——**能否被廉价实测发现?失败是单点还是灾难性的?**
|
|
125
|
+
|
|
126
|
+
| 能否实测 | 失败重数/严重度 | 去向 |
|
|
127
|
+
|---|---|---|
|
|
128
|
+
| 不能(授权、语义、数据模型) | 多,或有一个灾难性 | 写进正文 |
|
|
129
|
+
| 不能 | 单点、不灾难 | 写入已知盲区,一句话 |
|
|
130
|
+
| 能 | 任意 | 写成**判死项**:一句可执行的判定(什么输入/状态下直接判失败)+一句兜底动作,不写机制 |
|
|
131
|
+
| 能且已知答案 | — | 写成常量或默认值,不讨论 |
|
|
132
|
+
|
|
133
|
+
这一栏是止膨胀的主要手段:绝大多数“看起来该写进方案”的发现,正确答案是判死项、常量或盲区,不是新条款。
|
|
134
|
+
|
|
135
|
+
未受影响的部分可沿用既有证据,但须确认仍适用并注明原版本与覆盖范围;只转发旧的“通过”不算当前版本复评。修改跨越多个模块、或改变核心前提与技术路线时,相关路扩大检查范围并处理新出现的高/中问题。评审者必须核查实际修改,不能只接受“已修复”声明。沿用与扩范围的细则见[评审协议](references/review-protocol.md)「复评与证据沿用」。
|
|
136
|
+
|
|
137
|
+
每轮记录按评审协议的「最小记录」执行。用户打断或上下文恢复后,从记录与实际 Agent 状态接续,不重复派单。
|
|
138
|
+
|
|
139
|
+
## 4. 判断继续、通过或退出
|
|
140
|
+
|
|
141
|
+
每轮完成后,先检查是否满足通过条件;未通过且有可执行的核实或修订动作时,按下面的判据决定要不要开下一轮。需要探索其他解法时,按前述三档分流的条件启用对应档位。
|
|
142
|
+
|
|
143
|
+
**停止修订只有一个判据:本轮的新发现里,有哪一条会改变实施动作?**没有的,按第 3 节的判别处置完即收口;有的才继续。下面三条是这条判据的操作提示,不单独构成停止或继续的理由:
|
|
144
|
+
|
|
145
|
+
- **同一决策点被修订两次仍不稳定**:换档(乙档换组件),不加条款。
|
|
146
|
+
- **连续两轮没有任何高/中问题被关闭**:冻结去实测,剩余风险写进已知盲区。
|
|
147
|
+
- **本轮既找不到可删或可合并的条款,又只能靠新增条款回应新发现**:说明方案已过厚,同样冻结去实测,不继续修。
|
|
148
|
+
|
|
149
|
+
轮次上限为 10 轮,**只是防失控的兜底,不是可用额度**;达到上限按“预算用尽”退出,不因为还剩额度就继续。“改一版应该就好了”“多数路都判低”都不构成继续的理由。
|
|
150
|
+
|
|
151
|
+
提前结束与收口不构成通过——通过仍按下面六条判定。
|
|
152
|
+
|
|
153
|
+
本 skill 将满足全部通过条件称为“收敛”。只有同时满足以下条件,才标“评审通过”:
|
|
154
|
+
|
|
155
|
+
1. **先回答终局问题:交付的方案能不能让人直接开工,而不用回来问“这里当初为什么这么定”?**列出读者最可能回头追问的 3 个问题(这一步怎么用、当初为什么这么定、哪里不能改),逐条指到决策登记表的编号或盲区条目;指不到的即为未完成,不必再看其余条件。
|
|
156
|
+
2. 每条问题(本轮新提出的,以及闭环表里仍未关闭的)都有至少一路给出的“已关闭/未关闭”判定。旧问题由复用路判定;本轮没有复用路时,指定一路接收闭环表,并在记录里写明放弃该路本轮的盲度——旧版本作废时,改为声明旧问题清单随之作废及理由。扫描路对本轮新提出的问题给出位置与依据即可。关闭项附正文位置;“部分关闭”按未关闭计。未关闭项里没有高或中。
|
|
157
|
+
3. 每一处沿用旧证据的地方,都注明了原版本与覆盖范围。
|
|
158
|
+
4. 每路的限制清单逐条列出本轮未检查的区域;逐条对照后确认,这些区域里没有未关闭问题所在的位置。
|
|
159
|
+
5. 拟交付方案没有阻碍实施的未核实项或必需的待用户决策。
|
|
160
|
+
6. 交付正文与最终被评正文为同一版本;仅排版、错字或「契约精度修订」差异须注明并确认技术含义不变。
|
|
161
|
+
|
|
162
|
+
高/中/低计数只作汇总显示,**不作为继续或收口的依据**,也不得为把某路计数刷到 0 而开轮。
|
|
163
|
+
|
|
164
|
+
通过仅表示:**在已检查范围和现有证据下,未发现尚未解决的阻碍实施问题。** 它不保证没有遗漏,不证明实现、测试或上线已完成。低问题可披露保留;不按多数票或平均分宣布通过。
|
|
165
|
+
|
|
166
|
+
发生以下情况时,保存当前方案和记录,按未收敛交付,不为达到某个轮数而继续:
|
|
167
|
+
|
|
168
|
+
- 必需的用户决定、外部证据或访问能力缺失,且无可继续推进的独立工作;
|
|
169
|
+
- 有具体依据的争议仍无法解决,当前也没有新证据、可执行核查、修订或可行的替代探索;
|
|
170
|
+
- 达到轮次上限;
|
|
171
|
+
- 工具恢复次数已用尽,仍无法完成所需独立评审路。
|
|
172
|
+
|
|
173
|
+
退出时,标明“阻塞/预算用尽/评审未完成”等原因,并列出恢复条件。不要将退出写成通过。如果用户要求等待或停止,优先遵从。
|
|
174
|
+
|
|
175
|
+
区分当前方案与未采纳的替代候选。**候选本身不阻止通过**,但必须在决策登记表里逐条留痕(采纳/拒绝 + 理由);未留痕的候选视为未处理,该轮不通过。**例外**:若某候选表明"照当前方案做会白做"(典型是甲档指出当前路线依赖的核心前提不成立),它按缺陷处理,可以直接阻断。采纳候选时,其实施必需条件纳入核查。
|
|
176
|
+
|
|
177
|
+
## 5. 交付与后续授权
|
|
178
|
+
|
|
179
|
+
交付时提供以下内容:
|
|
180
|
+
|
|
181
|
+
- 方案位置或完整正文,以及实施顺序摘要。
|
|
182
|
+
- 当前版本、已完成轮数、路数与选路依据、各路状态及高/中/低计数(仅作摘要)。
|
|
183
|
+
- 各路的限制清单:本轮检查覆盖了什么、没覆盖什么。
|
|
184
|
+
- 决策登记表(哪个选择点选了哪个实现、什么证据会推翻)、未决项、替代解法的选择理由和核查限制。
|
|
185
|
+
- 未核实项台账及其处置:哪些转成了实施期必办条目,哪些已代跑核实,哪些仍开放及恢复条件。
|
|
186
|
+
- 实现状态:未实施/实施中/已实施。
|
|
187
|
+
|
|
188
|
+
尚未完成的评审路标“未完成”,不写成“无问题”。
|
|
189
|
+
|
|
190
|
+
“先出方案”任务到此结束。原任务已授权继续实施,且没有“只出方案/等我确认”等限制时,通过后沿原授权继续,不增加确认环节。未收敛不自动转实施。提交、对外写入和发布仍遵守既有授权边界。
|
|
191
|
+
|
|
192
|
+
通过后进入实施,若发现需要偏离已评正文:改动涉及核心前提或技术路线,保存新版本并重开一轮;其余偏离(步骤实现细节、局部顺序、等价替换)就地改,并在记录里补一条“实施期偏离:改了什么/为什么/影响哪些验收项”,交一路复核该条。不得以“实施中才发现”为由绕过已评正文的约束,也不得为每条实现细节重开整轮。
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# 对抗路:用反例检验当前方案
|
|
2
|
+
|
|
3
|
+
## 定义与边界
|
|
4
|
+
|
|
5
|
+
对抗路检查当前方案。寻找会使关键假设、预期结果或失败处理失效的具体输入、状态和操作顺序。回答“这个方案在什么条件下会失败,依据是什么”。它挑战方案成立的条件,也可指出核心方向不可行;不预设方案必须有问题。
|
|
6
|
+
|
|
7
|
+
共同输入输出、严重度、授权、轮数与复评规则遵循[主文件](../SKILL.md),角色协作见[多路评审](multi-route-review.md)。本文件只补充对抗审查方法。
|
|
8
|
+
|
|
9
|
+
对抗路交付可核查的反例及修复所需条件;[替代路](alternative-review.md)负责探索不同解法并比较取舍。对抗路可以提出局部修复,也可以指出局部修复不足;发现替代方向时另列线索,不把重新设计整套方案作为本路的必需产物。
|
|
10
|
+
|
|
11
|
+
## 如何构造有效反例
|
|
12
|
+
|
|
13
|
+
按[主文件的核心任务与核心前提](../SKILL.md#核心任务与核心前提),优先尝试用具体场景推翻核心前提或关键因果关系:即使各步骤照做,核心结果是否仍可能不成立?再沿原始实现或资料构造失败路径,不只检查作者已经列出的假设。按任务选择相关切入点,不机械遍历全部清单:
|
|
14
|
+
|
|
15
|
+
| 切入点 | 要挑战的假设 | 可构造的场景 |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| 输入与状态 | 输入总是完整、合法,已有状态符合预期 | 空值、重复数据、历史残留、混合版本 |
|
|
18
|
+
| 顺序与并发 | 步骤按既定顺序发生且只执行一次 | 重试、重复触发、乱序、检查后状态变化 |
|
|
19
|
+
| 部分失败 | 中断后仍能恢复或保持一致 | 写入一半失败、超时但操作实际成功、回滚再次失败 |
|
|
20
|
+
| 边界与依赖 | 权限、外部契约或资源条件始终成立 | 权限变化、依赖不可用、容量或时限达到边界 |
|
|
21
|
+
| 验收与可观察性 | 验收通过足以证明目标达成 | 测试通过但遗漏消费者、只核对声明或表面状态 |
|
|
22
|
+
| **条目内部自洽** | 规则、性质、断言三者一致 | 把同一节的“规则”与其下“性质/断言”逐条代入同一输入:例如规则写 `has(x) 即拒绝`,性质却要求 `has(x) 时放行且不计费`;或规则要求“失败不扣额”,而某维度按状态转移扣费 |
|
|
23
|
+
|
|
24
|
+
**“条目内部自洽”要单独查,不要指望它被其他切入点覆盖。** 这类缺陷不需要外部输入,只需要两句话相互代入;而其他切入点都从“外部世界怎么打破它”出发,会从旁边绕过去。同一份文档被反复修补时,新缺陷最常落在这里:修补者只读了自己改的那一段。
|
|
25
|
+
|
|
26
|
+
对每个候选反例,检查以下三点:
|
|
27
|
+
|
|
28
|
+
1. 该场景是否可能在当前范围内发生。
|
|
29
|
+
2. 实际执行路径是否存在,或方案是否遗漏了必需处理。
|
|
30
|
+
3. 后果是否违反用户目标、约束或方案承诺。
|
|
31
|
+
|
|
32
|
+
不要仅凭“理论上可能”就宣布存在缺陷,也不要以发生概率低为由忽略有证据的严重后果。
|
|
33
|
+
|
|
34
|
+
如果方案尚未实施,可以根据已有实现、依赖方约定和计划步骤推导后果。将结论标为“方案推演”,不要写成已复现的运行结果。证据不足时列待核实假设及最小验证,不编造调用路径或实测。
|
|
35
|
+
|
|
36
|
+
## 反例输出
|
|
37
|
+
|
|
38
|
+
沿用主文件的缺陷条目,补足以下证据链,无须另造一套计数:
|
|
39
|
+
|
|
40
|
+
> 被挑战的承诺或假设 → 具体触发输入/初始状态 → 操作或调用顺序 → 失效点及可观察后果 → 原始依据 → 最小验证 → 修复所需条件。
|
|
41
|
+
|
|
42
|
+
例如,方案声称“失败后重试不会重复扣款”,但只规定“调用扣款,成功后写完成标记”。评审者构造以下顺序:扣款成功,写标记前进程中断,恢复后重试。检查系统是否已有幂等键或去重记录,再判断是否会重复扣款。如果已有机制排除了重复扣款,说明排除依据,不把该场景列为缺陷。
|
|
43
|
+
|
|
44
|
+
## 核查纪律与复评
|
|
45
|
+
|
|
46
|
+
- 用具体证据挑战假设,不以强硬语气、泛泛风险清单或换个措辞重复其他路结论充当对抗。与其他路发现相同缺陷时,提供独立核查依据即可,不为独特性编新问题。
|
|
47
|
+
- “存在另一种写法”本身不是缺陷;审查强度不等于缺陷数量。没有成立的反例时,说明实际检查过的关键假设、被排除的场景及核查限制。
|
|
48
|
+
- 验证时,优先使用能回答当前问题的只读检查、推演或隔离样例。如果需要执行操作,遵守主文件的授权与代跑规则。不要通过破坏真实数据或执行计划中的实现来证明观点。
|
|
49
|
+
- 复评重新检查原触发条件是否仍能造成后果,以及修复是否引出新的失败路径;不能仅凭新增了一句“处理异常”就关闭反例。
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# 替代路:探索其他解法
|
|
2
|
+
|
|
3
|
+
## 定义与边界
|
|
4
|
+
|
|
5
|
+
替代路用于探索当前方案之外的解法,按改动尺度分 甲/乙/丙三档(见下文「三档替代」)。甲档在现有路数之外单独加一路:先依据用户目标和硬约束探索不同解法,不预先采用当前方案的架构、机制或步骤;乙档与丙档不新增路,可在现有评审路内完成。判断其他解法能否解决当前方案无法解决的问题。甲档一旦出现触发条件(核心前提不成立、或缺少可行修复)应立即启用,不必等固定轮次;乙/丙档按主文件的分流规则按轮启用。具体启用时机、轮次和退出条件遵循[主文件](../SKILL.md),角色协作见[多路评审](multi-route-review.md)。
|
|
6
|
+
|
|
7
|
+
| 维度 | 对抗路 | 替代路 |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| 核心问题 | 当前方案在什么条件下会失败? | 同一目标是否有另一条更合适的路? |
|
|
10
|
+
| 思考起点 | 当前方案及其假设 | 用户目标、硬约束和原始事实 |
|
|
11
|
+
| 主要产物 | 反例、触发路径、后果及验证 | 替代候选、可行性依据、比较及推荐 |
|
|
12
|
+
| 修改尺度 | 修复失败的局部修改 | 可重选机制、职责、依赖或实施顺序 |
|
|
13
|
+
|
|
14
|
+
## 三档替代
|
|
15
|
+
|
|
16
|
+
替代解法不只等于“换掉整套方案”。按改动尺度分三档,判据是**相对于被替代对象**的差别,不是相对于整个方案:
|
|
17
|
+
|
|
18
|
+
| 档 | 替代对象 | 判什么 | 典型例子 |
|
|
19
|
+
|---|---|---|---|
|
|
20
|
+
| **甲 换路线** | 技术路线、架构骨架 | 换路后原方案无法满足的核心前提是否消失、新增了什么条件 | 原方案反复处理“双写后如何补偿不一致” → 探索“单一权威源加派生视图”,并核查延迟、迁移与兼容代价 |
|
|
21
|
+
| **乙 换组件** | 决策登记表里的**一个**选择点 | 同一决策点上换实现后,原方案的性质是否仍成立、代价是什么 | 记额度的模型在“计数器/预占+条件释放/定期扫描”之间选;归属边界在“精确相等/路径前缀/复用上游谓词”之间选;分帧在“随机 nonce 定界/围栏代码块/全量转义”之间选 |
|
|
22
|
+
| **丙 不做/缩小** | 需求本身 | 现有能力覆盖多少、缩小后还值不值得做 | 目标里已有的跨会话消息能力是否已覆盖大半;能否把“任意会话”收窄为“同项目会话” |
|
|
23
|
+
|
|
24
|
+
三档的轻重不同,不要用一个判据套:
|
|
25
|
+
|
|
26
|
+
- **甲档**才需要“与当前方案有实质区别”这个高标准,也只有它需要首次盲评。
|
|
27
|
+
- **乙档**是替换一个决策点,天然算是“实质区别”,不需要独立探索。判断它是否成立,看**被替换的那一点**是否真的换掉、原方案依赖该点的性质是否仍在。仅补充边界条件、改名称、改措辞仍然不算替代解法。
|
|
28
|
+
- **丙档**只需回答“覆盖多少、缺什么”,不要求产出新方案。
|
|
29
|
+
|
|
30
|
+
同一轮里可以同时给 乙档候选与当前方案的修订建议;乙档的推荐不因“只动一点”而降级。
|
|
31
|
+
|
|
32
|
+
保留用户目标和硬约束。可以重新选择作者自行决定的技术路线。如果候选解法需要扩大权限、降低目标或改变用户已确认的决策,将它标为条件性建议,并说明所需变更。不要声称它已满足现有约束。
|
|
33
|
+
|
|
34
|
+
## 首次盲评与后续复用
|
|
35
|
+
|
|
36
|
+
乙档与丙档直接进入对照评审:它们本来就是在已知方案内部做选择,隐藏方案没有意义,隐藏反而得不到可比的候选。
|
|
37
|
+
|
|
38
|
+
甲档只在**首次启用**时做一次盲评:主会话仅提供目标、硬约束、原始材料位置和本手册,不提供当前方案、作者的选择理由与历史意见;评审者先返回候选方向,并说明事实依据和关键假设。收到方向后,主会话再提供共同快照与未决意见,由同一评审者比较候选与当前方案,并按统一格式输出结论。
|
|
39
|
+
|
|
40
|
+
此后复用同一评审者,按新快照和已确认事实更新比较,不重复从零探索。如果工具不能隔离上下文,说明已暴露的材料,不宣称盲评。
|
|
41
|
+
|
|
42
|
+
## 候选质量与输出
|
|
43
|
+
|
|
44
|
+
对每个候选解法,说明关键机制、修改位置、可复用的现有实现、需要新增的依赖和可能的失败方式。说明它如何解决原方案的阻塞。提出能核实关键假设的最小实验或检查。只给架构名称或说“换技术”,不足以判断是否可行。
|
|
45
|
+
|
|
46
|
+
对照阶段按[主文件的核心任务与核心前提](../SKILL.md#核心任务与核心前提),检查候选能否绕开原路径无法满足的核心前提。说明哪些条件因换路而不再需要、新增条件有何依据;用户目标本身的必要条件仍须满足,不能通过降低目标声称绕开阻塞。
|
|
47
|
+
|
|
48
|
+
提供有可行性依据、且有实质区别的候选解法。甲档的“实质区别”针对整套技术路线;乙档针对**被替代的那个决策点**;丙档针对需求范围。如果没有找到,说明探索过哪些方向、为何排除,以及还有哪些不确定性。不要编造候选。允许有依据地推荐继续修订当前方案。
|
|
49
|
+
|
|
50
|
+
在主文件统一输出之外,补充:
|
|
51
|
+
|
|
52
|
+
1. **目标与阻塞**:必须保留哪些目标和硬约束,什么问题阻碍当前方案实施。
|
|
53
|
+
2. **替代候选**:说明机制、关键步骤、可复用的实现,以及候选如何消除阻塞。如果没有可行候选,说明排除依据。
|
|
54
|
+
3. **比较**:目标覆盖、约束符合度、复杂度、实施及迁移成本、兼容及回退、主要风险;用事实支持,不用主观分数制造精确度。
|
|
55
|
+
4. **验证与推荐**:最小验证、按归属区分的未核实和待决策项,以及保留、局部吸收或切换路径的建议及条件。候选的可选实验与当前方案实施必需的核查分别列出。
|
|
56
|
+
|
|
57
|
+
按档补充:
|
|
58
|
+
|
|
59
|
+
- **乙档**额外给:被替代的决策点及其原选定实现;“成立条件”一栏——该决策点的选择依赖哪些事实,哪些证据一变就必须改选;以及**与当前方案其余条款的交叉清单**(换掉这一点后,哪些既有性质、断言、验收项要跟着改)。这一栏比候选本身更有用:反复修补同一个决策点几乎总是因为交叉清单没列全。
|
|
60
|
+
- **丙档**额外给:现有能力清单(哪个已装组件/已有入口能覆盖到什么程度)、缺口、以及缩小目标后仍然成立的核心前提。
|
|
61
|
+
- **甲档**按上文「首次盲评与后续复用」执行,不需要交叉清单(整条路线都换了)。
|
|
62
|
+
|
|
63
|
+
## 取舍与后续工作
|
|
64
|
+
|
|
65
|
+
主会话核实依据后,选择保留当前方案、采用候选中的部分内容,或切换到候选解法。记录选择理由,再按主文件处理验证、授权和复评。评审者分开报告方案缺陷与探索建议,不因自己的候选未被采用而阻止通过。
|
|
66
|
+
|
|
67
|
+
后续复评时,替代路检查候选在约束和方案改变后是否仍可行。根据依据保留、调整或撤回推荐,不要求每轮提出新方向。
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# 设计理由与沿革
|
|
2
|
+
|
|
3
|
+
**这是维护者文档,不是运行时指令。** 日常评审不读它;读它的时机只有两个:要改本 skill 的某条规则,或觉得某条规则多余、想删掉它。
|
|
4
|
+
|
|
5
|
+
理由在这里,规则的正文在 [主文件](../SKILL.md)。两处不一致时以主文件为准,并回来更新本文件。
|
|
6
|
+
|
|
7
|
+
## 每条硬规则在防什么
|
|
8
|
+
|
|
9
|
+
改规则前先确认它防的失败还存不存在。不存在才删;只是“看起来啰嗦”不是理由。
|
|
10
|
+
|
|
11
|
+
| 规则 | 防的失败 | 删掉会发生什么 |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| 核心前提必须给锚点四件套 | 用“看起来有依据”代替有依据;片段支持结论而全文推翻它 | 评审变成措辞互评,谁也核实不了谁的断言 |
|
|
14
|
+
| 判别表(能否实测 × 失败重数) | 方案每轮都在长条款 | 每个新发现都变成一节新正文,方案越修越不可实施 |
|
|
15
|
+
| 已知盲区表 + 移入盲区不算新增条款 | 作者不能承认“这里我不知道” | 承认无知的成本高于加机制,删减永远停不下来 |
|
|
16
|
+
| 闭环表 + 位置证据 | 只转发“已修复”,不指到条款 | 复评退化成复述作者的说法 |
|
|
17
|
+
| 不按票数/平均分通过 | 用“多数路判低”掩盖真问题 | 最省事的收口方式变成默认方式 |
|
|
18
|
+
| 两路结论相反时要求最小验证 | 把可行性分歧当严重度分歧,用“取较高者”糊过去 | 分歧被数字消化,方向错误被计成“低问题” |
|
|
19
|
+
| 盲度由派发消息内容定义 | 换了 Agent 就宣称盲评,作者的理由混进消息 | “独立评审”退化成第二个复述者 |
|
|
20
|
+
| 每轮只一路全量扫描,扫描路读全文、复用路只读闭环表所引位置 | 每轮全路重读全文,成本与收益脱钩;“是否真做了全量检查”不可观察,会退化成口号 | 复用路被要求全量重读,成本回升,规则被绕过;或者复用路凭记忆判关闭,闭环表失去证据 |
|
|
21
|
+
| 作者不逐条枚举一致性结论 | 作者枚举的永远是他想到的那些 | 修补引入的新缺陷几乎总落在条款交界处,而作者的系统性自查正是从这里漏过去;交界处的交叉改由复评方按闭环表和锚点核对 |
|
|
22
|
+
| 替代解法分甲乙丙三档 | 用“要不要加一路”这一个开关处理三种不同尺度的改动 | 小事惊动整条路线重估,大事又被当成局部修补 |
|
|
23
|
+
|
|
24
|
+
## 已删除的规则与删除理由
|
|
25
|
+
|
|
26
|
+
这些规则曾经存在,删掉时各自的保护意图都还在,但换成了别的机制来实现。不要在维护时把它们改回来。
|
|
27
|
+
|
|
28
|
+
**固定三路(“简单方案也用三路,不为简化任务减少路数”)。** 防的是作者用“这个很简单”逃掉评审。意图成立,机制选错了:它取消了判断,而不是让判断留下痕迹。现由“两路/三路按失败代价选,依据写进记录,不得降到一路”承接——沉默跳过仍然被禁止,成本随风险变化。
|
|
29
|
+
|
|
30
|
+
**预算用尽后的 diff 复评(最多 2 轮)。** 防的是在“为一行修订重开整轮”和“把未收敛写成通过”之间做不诚实的记账。但它与“契约精度修订按普通复评处理”以及“预算用尽交付未复评状态”两处互相覆盖,同一个状态下出现三种答复,现场必然按最省的一种解释。现在改的是成本端:每轮只有一路做全量扫描,一轮本来就很便宜,不需要第二个出口。
|
|
31
|
+
|
|
32
|
+
**面积不增长(条款数+参数数+验收项数)。** 防的是方案膨胀。但计数会诱发合并与改写以规避计数,“条款”本身也没有可数的定义,最后变成一条被普遍忽略的规则。现由内容判据承接:“删掉这条,会不会有人因此做错决定?”不会就不要加。
|
|
33
|
+
|
|
34
|
+
**“第 3 轮两点满足即加第四路”的机械规则。** 只看方案是否通过,看不出问题性质,会把“方向正确、精度不足”的方案强制换路。现由“换不换路看改动尺度”承接。
|
|
35
|
+
|
|
36
|
+
**通过闸写成“各路高0/中0”。** 计数同时是终点线,又被禁止追求(“不得为计数归零开轮”),作者被迫在“优化计数”和“别优化计数”之间做隐性选择,最常见的结果是降严重度。现由闭环表承接:每条问题都要有开/关判定,关闭项要指到正文位置;计数降为摘要。
|
|
37
|
+
|
|
38
|
+
**路名写作 A/B/C。** 三档替代改用甲乙丙之后,字母与档位的对应关系已经消失,留着只会让“路 C”和“丙档”被读成同一件事。现在三路一律用中文全名。
|
|
39
|
+
|
|
40
|
+
## 为什么不评分、不投票、不设加权
|
|
41
|
+
|
|
42
|
+
评分把“能不能直接开工”替换成一个与它没有稳定关系的数。一旦有数,作者优化数,评审者优化数,而方案是否可实施无人负责。同理,多数票把“没人反对”当成了“没有问题”,而单路发现的真问题恰恰是票数最少的那类。
|
|
43
|
+
|
|
44
|
+
## 维护检查清单
|
|
45
|
+
|
|
46
|
+
改这个 skill 时逐条过一遍:
|
|
47
|
+
|
|
48
|
+
1. **这条规则防的失败,现在还发生吗?** 发生过就保留并写清触发条件;从没发生过、只是听起来稳妥的,删。
|
|
49
|
+
2. **它会不会和已有规则给出不同答复?** 同一个状态下出现两种答复,现场一定选省事的那个。先消除冲突,再加内容。
|
|
50
|
+
3. **判断依据是可观察的吗?** “是否真正独立”“是否理解了”不可观察,作者既不能设定也不能证明;“派发消息里有没有作者的理由”可观察。不可观察的判据会被绕过。
|
|
51
|
+
4. **完成标准可检查吗?** “覆盖充分”不可检查,“每条问题有开/关判定且关闭项有位置”可检查。
|
|
52
|
+
5. **删掉的规则其保护意图由谁承接?** 没有承接就不要删;有承接就在本文件记一笔,否则下一任维护者会把缺口当遗漏补回去。
|
|
53
|
+
6. **这次的改动能用一句话说清它改了什么判断吗?** 说不清就说明它只是措辞变动,别动结构。
|
|
54
|
+
7. **同一条规则只有一个维护点。** 详细分支放 references,主文件只留动作、条件、完成标准。
|
|
55
|
+
|
|
56
|
+
## 已知的残余风险
|
|
57
|
+
|
|
58
|
+
- 主文件仍是单页读完的体量,长方案评审时会占用可观上下文;若将来出现“读了主文件就急着开工”的案例,先检查每节的完成标准是否清楚,再考虑拆分,不要为字数拆。
|
|
59
|
+
- “两路”与“三路”的边界靠失败代价判断,作者仍有解释空间。锚点写成了可列举的四条(可逆/单模块/不改用户可见行为/无迁移),但组合判断仍可能偏差;出现偏差时改这四条,不要改成更抽象的原则。
|
|
60
|
+
- 替代路乙档的“换组件”与对抗路的“局部修复”在边界上可能重叠;重叠不构成缺陷,两路结论一致时按合并处理即可。
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# 多路评审:分工、派发与汇总
|
|
2
|
+
|
|
3
|
+
## 职责分工
|
|
4
|
+
|
|
5
|
+
按主文件选定的路数安排不同的 Agent。分工规定各路优先检查的内容,不限制各路报告有依据的问题。
|
|
6
|
+
|
|
7
|
+
| 路 | 检查重点 | 应交付的依据 |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| 目标与实现 | 是否解决正确的问题且确实能实现:目标覆盖、事实与假设、实现入口、职责划分、现有机制复用、关键链路、验收有效性 | 目标与步骤的对应关系、源码或文档依据、遗漏的链路或约束、验收能否证明目标达成 |
|
|
10
|
+
| 运行与演进 | 投入使用、逐步切换及后续维护时是否仍成立:状态变化、依赖与消费者、兼容、部分失败与恢复、迁移与回退、维护成本 | 受影响消费者与生命周期场景、状态和版本过渡、失败恢复及回退依据、可重复验证方式 |
|
|
11
|
+
| 对抗 | 用反例检验当前方案的关键假设与失败路径 | 按[对抗路要求](adversarial-review.md)交付反例、依据及验证方法 |
|
|
12
|
+
| 替代 | 按改动尺度分三档:甲 换路线、乙 换组件、丙 不做/缩小 | 按[替代路要求](alternative-review.md)交付候选、比较及推荐;乙档须给「该决策点的成立条件」与「与其余条款的交叉清单」 |
|
|
13
|
+
|
|
14
|
+
“运行与演进”系统检查生命周期中的处理是否完整;对抗路主动构造具体反例,检验方案承诺能否被推翻。两路可接触相同主题,以检查重点和方法形成差异,不要求结论完全互斥。
|
|
15
|
+
|
|
16
|
+
按[主文件的核心任务与核心前提](../SKILL.md#核心任务与核心前提)组织核查:目标与实现路重点判断核心任务是否准确、必要条件有无依据、关键步骤能否产生目标结果;运行与演进路重点判断这些条件在切换、运行和维护中能否持续成立。对抗和替代路的具体方法见各自手册。
|
|
17
|
+
|
|
18
|
+
### 前两路的任务变体
|
|
19
|
+
|
|
20
|
+
主会话可按任务收紧前两路的重点,并在派发时说明各自要核查的问题。以下只是示例,不增加角色,也不要求每次套用:
|
|
21
|
+
|
|
22
|
+
| 任务 | 目标与实现侧重 | 运行与演进侧重 |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| 数据迁移 | 数据语义、转换正确性、目标数据是否满足业务约束 | 切换过程、兼容、增量同步、失败恢复与回退 |
|
|
25
|
+
| 接口改造 | 接口契约、调用链、目标行为与实现衔接 | 消费者兼容、版本共存、发布过渡与回退 |
|
|
26
|
+
|
|
27
|
+
### 聚焦核查与职责外发现
|
|
28
|
+
|
|
29
|
+
各路优先检查本路负责的内容,不必完整重复其他路的检查。如果发现本路职责外、有具体依据的高/中问题,也必须报告(复用路的完成标准见[主文件第 2 节](../SKILL.md),不因此被要求全量扫描)。不要因分工而略过问题,也不要假定其他路会报告。
|
|
30
|
+
|
|
31
|
+
多路可以独立发现同一个问题,不要求各路结论互不相同。不要为了区别于其他路而编造问题。评价分工时,检查各路是否完成重点核查、提供独立依据,或补充了其他路未检查的内容。不要求独有问题数量或重合率达到某个指标。
|
|
32
|
+
|
|
33
|
+
## 派发与补路
|
|
34
|
+
|
|
35
|
+
按[评审协议](review-protocol.md)提供版本、材料和统一输入输出,追加该路职责。派发对抗路前,主会话及该路Agent读取[对抗路要求](adversarial-review.md)。升级时保留原路职责并补齐缺少的独立评审者。替代路开始前读取其专属手册。
|
|
36
|
+
|
|
37
|
+
### 复用还是换新
|
|
38
|
+
|
|
39
|
+
“复用”指同一路沿用前几轮的 Agent;“换新”指为该路起一个未见过历史版本的评审者。
|
|
40
|
+
|
|
41
|
+
| 职责 | 用谁 | 依据 |
|
|
42
|
+
|---|---|---|
|
|
43
|
+
| 首轮全部路 | 必须换新 | 换新只是提高盲度的手段;盲度由派发消息里有没有作者理由决定(见主文件第 2 节) |
|
|
44
|
+
| 复评“我提的问题是否真被改掉” | 复用 | 只有他自己持有证据链和旧版本;换新等于重查 |
|
|
45
|
+
| 复评“这一版有没有引入新问题” | **该轮至少一路换新** | 复用者对自己批准过的设计会形成盲区:它记得“这个设计我通过了”,于是不再问“这个设计还需要什么配套” |
|
|
46
|
+
| 跨版本一致性(谓词句是否逐字未变、真值表是否被翻) | 复用 | 没有旧版本的评审者做不了 |
|
|
47
|
+
| 某路连续两轮没有任何高/中问题 | 下轮换新 | 复用价值已耗尽;换人正好检验“是真没问题还是看惯了” |
|
|
48
|
+
| 版本跨度大(改换技术路线) | 全部换新 | 旧快照已无参考价值 |
|
|
49
|
+
|
|
50
|
+
每轮的最低配置以[主文件第 2 节](../SKILL.md)为准:一路换新做全量新问题扫描,其余路复用核对闭环表所引位置。换新者仍须拿到完整正文,但不必拿到历史意见。换人后记录里注明各路是复用还是换新,以及换新者看到的材料范围。
|
|
51
|
+
|
|
52
|
+
各路对共同正文形成独立结论后再汇总,不提前分享当轮意见。记录每路实际检查范围、版本及限制,区分新检查与旧证据复用。
|
|
53
|
+
|
|
54
|
+
## 汇总与复核
|
|
55
|
+
|
|
56
|
+
合并关于同一缺陷的重复意见。保留原问题 ID、提出问题的评审路,以及各路新增的证据、触发条件和影响。如果两个缺陷需要不同修复,不要仅因主题相同就合并。只有一路发现的问题或提出的异议,也必须保留,不按票数淘汰。事实争议用代码、约束或获准执行的验证解决,严重度争议请相关评审者复核。满足既定约束的方案偏好由主会话在授权范围内取舍。
|
|
57
|
+
|
|
58
|
+
**同一缺陷被不同路判到不同严重度时,采用较高者**,并把判得较低的那一路的理由记在旁边。若两路不是严重度不同,而是对同一结论的可行性判断相反(一路说“走不通”、另一路说“有可行路线”),不套本条,按[主文件](../SKILL.md)第 3 节争议表处理。降级只能由该路在复核后给出依据(“这段只是措辞,不改变任何拒绝条件”),不能由主会话按“多数路都判低”下调。反过来,判得较高的一路若给不出具体触发条件,由它自己撤回,主会话不代为降级。业务目标、扩权和已确认决策交用户决定。如果实质争议没有新证据,也没有可执行的解决动作,按主文件记录未决,不反复派发同一争议。
|
|
59
|
+
|
|
60
|
+
复评时,向本轮全部评审路提供完整新快照、合并后的问题和处理依据。扫描路检查全文与其改动影响,复用路检查闭环表所引位置及关联前提。对于未受影响部分,各路可沿用既有证据,但须确认仍适用,并注明原版本和覆盖范围。各路据此给出当前版本的结论。评审者必须核查实际处理结果,不能只接受主会话的“已处理”声明,也不能只转发旧的通过结论。
|
|
61
|
+
|
|
62
|
+
复评输出必须含**闭环表**(义务归复用路):旧问题逐条给出 已关闭/部分关闭/未关闭,并附依据位置;扫描路未收到旧问题时写“本路无旧问题”。**没写依据位置的关闭不算关闭**——只写“已修复”而不指到具体条款的,按未关闭处理。
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# 评审协议:快照、记录与工具恢复
|
|
2
|
+
|
|
3
|
+
冻结或派发时读“版本与快照”和“派发材料”。需要审计、换人或故障恢复时读对应章节。路线选择、轮次和通过条件以 [SKILL.md](../SKILL.md) 为准。
|
|
4
|
+
|
|
5
|
+
## 版本与快照
|
|
6
|
+
|
|
7
|
+
为冻结正文指定唯一版本号,例如 v1、v2。版本与轮次分开记录:补路或换人不自动产生新正文版本。
|
|
8
|
+
|
|
9
|
+
将完整正文保存为冻结副本,或写入派发消息。将状态和评审记录与正文分开,不强制使用特殊标记。同一轮各路收到相同内容。如果派发消息引用可编辑的共享文件,另保留一份本轮不再修改的副本。在全部结果返回前,不覆盖正文。
|
|
10
|
+
|
|
11
|
+
影响行为、约束、前提、步骤或验收的修改必须新建版本。仅排版或错字修复可注明差异,但必须确认技术含义不变。用户中途改要求时保留已评版本,新要求进入下一版本,不混用不同版本的通过结论。
|
|
12
|
+
|
|
13
|
+
**契约精度修订**的定义与计入方式见[主文件](../SKILL.md)第 1 节,本协议只补一条操作性判据:改动若让某个既有断言从红变绿,或改变了任何默认值、阈值、拒绝条件,就按实质修改处理。它仍新建版本并重算哈希,并按普通复评处理,不设快速通道。
|
|
14
|
+
|
|
15
|
+
可只保留一份当前冻结副本;当前轮结束并记录结果后再覆盖,不要求逐轮存档。
|
|
16
|
+
|
|
17
|
+
## 审计快照与哈希
|
|
18
|
+
|
|
19
|
+
涉及多文件、异步交接或明确审计要求时增加 SHA256。用户禁止落盘时使用完整对话快照,明确未生成文件哈希,不为满足本协议违规写文件。
|
|
20
|
+
|
|
21
|
+
单文件可用各占一行的 `<!-- plan:start -->`、`<!-- plan:end -->` 分隔正文与记录。若使用标记,各出现一次且顺序正确。对标记行之间的正文计算哈希;CRLF 或 CR 统一为 LF,以 UTF-8 无 BOM 编码,不额外去除空白,记录末尾换行口径。无标记时明确被哈希的正文范围,不强改已有格式。
|
|
22
|
+
|
|
23
|
+
多文件记录相对路径、版本及逐文件哈希,采用相同文本口径。向各路提供同一份清单和完整内容。将原始依据与方案文件分开记录。如果依据或环境改变,复核受影响的结论。
|
|
24
|
+
|
|
25
|
+
哈希只用于确认内容身份,不证明 Agent 已阅读或方案正确。不得只留版本号或哈希而丢失正文。
|
|
26
|
+
|
|
27
|
+
## 派发材料
|
|
28
|
+
|
|
29
|
+
每路获得以下材料,并按本路职责检查:
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
目标:用户要求、硬约束、已确认决策与授权。
|
|
33
|
+
职责:本路重点检查范围。
|
|
34
|
+
版本:轮次、冻结版本;适用时附哈希或文件清单。
|
|
35
|
+
方案:完整正文、核心任务与前提、依据及状态。
|
|
36
|
+
原始资料:可读取的需求、实现、配置和文档入口。
|
|
37
|
+
复评材料:复用路附旧问题、修改说明、处置依据和影响范围;扫描路只附改动清单与改动面,不给旧意见。
|
|
38
|
+
输出:结论;**一句话收口判断(可收口/还需一轮,附依据:本轮新发现里有没有一条会改变实施动作)**;高/中/低计数;问题稳定ID、严重度、位置、触发条件、后果、证据及建议;旧问题处置**以闭环表给出(逐条:已关闭/部分关闭/未关闭 + 依据位置)**,这条义务归复用路;扫描路未收到旧问题时写“本路无旧问题”;未核实项、待决策项及限制。**禁止照抄旧结论充作本轮结论**:未受影响部分可在注明原版本与覆盖范围后沿用证据,但不得原样复述已关闭条目的细节。
|
|
39
|
+
边界:只读评方案,不改文件、不执行拟议实现、不再派Agent,不代替用户授权。
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
派发时有五条硬要求:
|
|
43
|
+
|
|
44
|
+
1. **每路至少一个定向追问**,且必须能用具体输入构造(“请攻击:目标 busy 时投递是否会……”)。泛泛的“请评审”命中率明显更低。定向追问会收窄视野,所以最多三个,并同时写明“本路职责外的新发现同样必须报告”(复用路按[主文件](../SKILL.md)第 2 节的完成标准执行,不因这句话被要求全量扫描)。
|
|
45
|
+
2. **扫描路的复评消息必须写“请重新读取冻结文件全文,不要依赖你记忆中的版本”**;复用路至少读闭环表所引的位置,同样不得凭记忆。靠记忆的复评会漏掉条号漂移、常量不一致这类只有全文搜索才能发现的缺陷。
|
|
46
|
+
3. **复用的 Agent 不得声称盲评**。它对旧版本的记忆就是已暴露材料,记录里要写明“本路为复用评审者,已见历次版本”。
|
|
47
|
+
4. 复评时先给“**改动清单 + 改动面**”,再给全文。改动面是作者自报的改动量,口径见[主文件](../SKILL.md)第 3 节;评审者仍须自行判断交界处的交叉。
|
|
48
|
+
5. **每条缺陷必须给证据锚点四件套**:①`文件 :: 符号名`(行号仅作提示,版本间会漂移)②该符号内的原文片段 ③**可证伪条件**(写成“若在该符号内找不到 X,则本条不成立”)④若结论依赖调用/引用/配置关系,给出足以判定该关系存在的锚点(不必穷举)。作者的核验动作固定为“打开该锚点符号读全文,并逐个核对关系锚点”——片段只用于确认定位,**不替代阅读**:同文件相邻位置的代码完全可能推翻片段支持的结论。
|
|
49
|
+
|
|
50
|
+
替代路的**甲档**在首次启用时做一次盲评:只给候选方向所需材料,不提供当前方案;形成方向后再补共同正文与未决意见,此后复用同一评审者更新比较,不重复从零探索。**乙/丙档**不做隐藏:直接给完整正文与该决策点的候选列表。
|
|
51
|
+
|
|
52
|
+
## 复评与证据沿用
|
|
53
|
+
|
|
54
|
+
向本轮全部评审路提供新全文和修改说明。扫描路据全文判断改动影响,复用路据闭环表所引位置判断;都不只接受作者的影响判断。
|
|
55
|
+
|
|
56
|
+
对于受影响部分,检查新内容、关联前提、关键步骤之间的关系和旧问题。对于未受影响部分,可以沿用证据,但须注明原版本、覆盖范围及仍适用的原因。
|
|
57
|
+
|
|
58
|
+
各路给出当前版本的完整检查结论,不只复制旧计数。尚未完成的首次检查不能记为证据沿用。不要缩小职责来避开本路完成标准内的新问题(两种完成标准见[主文件](../SKILL.md)第 2 节)。
|
|
59
|
+
|
|
60
|
+
为问题保留稳定 ID。关闭旧问题时说明依据;新问题另记 ID。未解决的事实或严重度争议记录双方依据、已做核实和缺少证据,不以作者裁定或反复要求重评代替解决。
|
|
61
|
+
|
|
62
|
+
## 最小记录
|
|
63
|
+
|
|
64
|
+
复用方案记录区或已有项目日志,不另建审批文件。记录:
|
|
65
|
+
|
|
66
|
+
- 当前版本、已完成轮次与进行中轮次;适用的哈希或清单;评审状态与实现状态分别记。
|
|
67
|
+
- 各路身份、职责与状态(未开始/进行中/已完成/失败),附检查覆盖、沿用证据的原版本与限制、问题计数。
|
|
68
|
+
- 稳定问题 ID、处置依据、未决项及其归属。
|
|
69
|
+
- **本轮改动面**:口径见[主文件](../SKILL.md)第 3 节,并写明是否靠新增条款回应了新发现、本轮新增机制数。
|
|
70
|
+
- **未核实项台账**:每条写“谁发现的/为何不能核实/由谁在什么时候核实”,处置列只能取“转实施期必办(带验证步骤)/已代跑核实(附结果)/仍开放(附恢复条件)”三者之一;不允许连轮原样重复。
|
|
71
|
+
- 下一步可执行动作,或退出原因与恢复条件。
|
|
72
|
+
|
|
73
|
+
记录区常在哈希边界之外:凡含影响信任的断言(“已执行”“主要修法来自评审”),须附可核证据,否则标注“仅供参考”。
|
|
74
|
+
|
|
75
|
+
同一目标下换路不重置预算。用户实际替换核心任务时,记录新循环及依据,不通过改名重置轮数。
|
|
76
|
+
|
|
77
|
+
## 并发与故障恢复
|
|
78
|
+
|
|
79
|
+
按工具能力并发或顺序完成各路。如果 Agent 名额不足,先保存已完成的意见,再用客户端支持的方式释放资源。如果没有释放接口,顺序继续剩余评审,或报告能力限制。不得省略评审路,也不得把顺序执行说成并发。
|
|
80
|
+
|
|
81
|
+
某一路明确失败,或有限等待后确认无进展时:
|
|
82
|
+
|
|
83
|
+
1. 先核对实际状态,正常运行且有进展不算失败。
|
|
84
|
+
2. 同一路同一轮最多追加2次恢复尝试,换人和重连共用预算,不新增轮次。
|
|
85
|
+
3. 向接续的评审者提供原职责、共同快照、已完成检查和未决项。该评审者不能把他人未核实的结论记成已完成检查。
|
|
86
|
+
4. 恢复用尽或环境无法完成所需路线时,保存结果并按“评审未完成”退出。未完成不记为0问题。
|
|
87
|
+
|
|
88
|
+
完全没有独立 Agent 能力时,可交草案或明确标注的自查,状态写“未独立评审”,不伪造评审通过。
|
|
89
|
+
|
|
90
|
+
## 交付核对
|
|
91
|
+
|
|
92
|
+
确认最终正文与各路最新结论属于同一版本;纯排版或错字差异已注明且不改变技术含义。哈希模式重新核对正文范围、清单及哈希,变更后须留下更新记录,不能冒称旧哈希匹配。
|
|
93
|
+
|
|
94
|
+
存在未复评的实质修改时进入下一轮;预算已用尽时,交付未复评状态,不宣布通过,也不再开只核差异的复评。
|