@elvis1513/auto-coding-skill 4.3.7 → 5.0.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/README.md +26 -761
- package/cli/assets/managed-install.json +38 -1
- package/cli/assets/skill/SKILL.md +15 -100
- package/cli/assets/skill/data/templates/ENVIRONMENT.md +30 -0
- package/cli/assets/skill/data/templates/architecture/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +39 -145
- package/cli/assets/skill/data/templates/deployment/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/design/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/interfaces/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/product/.gitkeep +1 -0
- package/cli/src/index.js +127 -2589
- package/cli/src/sync-assets.js +38 -95
- package/package.json +9 -17
- package/cli/assets/agents/browser-debugger.toml +0 -27
- package/cli/assets/agents/docs-researcher.toml +0 -18
- package/cli/assets/agents/explorer.toml +0 -26
- package/cli/assets/agents/fixer.toml +0 -29
- package/cli/assets/agents/reviewer.toml +0 -50
- package/cli/assets/skill/data/contracts/orchestration-v1.schema.json +0 -567
- package/cli/assets/skill/data/policies/feedback-resolutions-v1.json +0 -68
- package/cli/assets/skill/data/policies/workflow-migrations-v1.json +0 -657
- package/cli/assets/skill/data/templates/ENGINEERING.md +0 -115
- package/cli/assets/skill/data/templates/tools/ap.py +0 -16
- package/cli/assets/skill/requirements.txt +0 -1
- package/cli/assets/skill/scripts/ap.py +0 -17791
- package/cli/assets/skill/scripts/core.py +0 -510
- package/cli/assets/skill/scripts/http_checks.py +0 -92
- package/cli/assets/skill/scripts/install_integrity.py +0 -427
- package/cli/assets/skill/scripts/scaffold_templates.py +0 -325
- package/cli/tests/ap_concurrency_test.py +0 -3602
- package/cli/tests/ap_profiles_test.py +0 -3272
- package/cli/tests/core_shell_test.py +0 -345
- package/cli/tests/index.test.js +0 -2967
package/cli/src/sync-assets.js
CHANGED
|
@@ -1,111 +1,54 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
1
2
|
import fs from "node:fs";
|
|
2
3
|
import path from "node:path";
|
|
3
|
-
import { spawnSync } from "node:child_process";
|
|
4
4
|
import { fileURLToPath } from "node:url";
|
|
5
5
|
|
|
6
|
-
const
|
|
7
|
-
const
|
|
8
|
-
const
|
|
9
|
-
const
|
|
10
|
-
const
|
|
11
|
-
const manifestDst = path.join(repoRoot, "cli", "assets", "managed-install.json");
|
|
6
|
+
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
|
|
7
|
+
const source = path.join(root, "src", "auto-coding-skill");
|
|
8
|
+
const destination = path.join(root, "cli", "assets", "skill");
|
|
9
|
+
const manifestFile = path.join(root, "cli", "assets", "managed-install.json");
|
|
10
|
+
const packageJson = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
|
|
12
11
|
const checkOnly = process.argv.includes("--check");
|
|
13
12
|
|
|
14
|
-
function
|
|
15
|
-
const
|
|
16
|
-
const
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
"generate",
|
|
22
|
-
"--skill-root", srcSkill,
|
|
23
|
-
"--agents-root", srcAgents,
|
|
24
|
-
"--version", pkg.version,
|
|
25
|
-
],
|
|
26
|
-
{ encoding: "utf8", stdio: "pipe" },
|
|
27
|
-
);
|
|
28
|
-
if (result.status !== 0) {
|
|
29
|
-
const detail = String(result.stderr || result.stdout || result.error?.message || "manifest generation failed").trim();
|
|
30
|
-
throw new Error(detail);
|
|
13
|
+
function listFiles(directory, base = directory) {
|
|
14
|
+
const files = [];
|
|
15
|
+
for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
|
|
16
|
+
if (entry.name === ".DS_Store" || entry.name === "__pycache__") continue;
|
|
17
|
+
const file = path.join(directory, entry.name);
|
|
18
|
+
if (entry.isDirectory()) files.push(...listFiles(file, base));
|
|
19
|
+
else files.push(path.relative(base, file).split(path.sep).join("/"));
|
|
31
20
|
}
|
|
32
|
-
|
|
33
|
-
return result.stdout;
|
|
21
|
+
return files.sort();
|
|
34
22
|
}
|
|
35
|
-
|
|
36
|
-
function
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
function copyDir(src, dst){
|
|
42
|
-
fs.mkdirSync(dst, { recursive:true });
|
|
43
|
-
for (const ent of fs.readdirSync(src, { withFileTypes:true })) {
|
|
44
|
-
if (shouldSkip(ent.name)) continue;
|
|
45
|
-
const s = path.join(src, ent.name);
|
|
46
|
-
const d = path.join(dst, ent.name);
|
|
47
|
-
if (ent.isDirectory()) copyDir(s, d);
|
|
48
|
-
else fs.copyFileSync(s, d);
|
|
49
|
-
}
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
function listFiles(root, base = root){
|
|
53
|
-
if (!exists(root)) return [];
|
|
54
|
-
const out = [];
|
|
55
|
-
for (const ent of fs.readdirSync(root, { withFileTypes:true })) {
|
|
56
|
-
if (shouldSkip(ent.name)) continue;
|
|
57
|
-
const p = path.join(root, ent.name);
|
|
58
|
-
if (ent.isDirectory()) out.push(...listFiles(p, base));
|
|
59
|
-
else out.push(path.relative(base, p));
|
|
23
|
+
function hash(file) { return crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex"); }
|
|
24
|
+
function copyTree(from, to) {
|
|
25
|
+
for (const relative of listFiles(from)) {
|
|
26
|
+
const target = path.join(to, relative);
|
|
27
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
28
|
+
fs.copyFileSync(path.join(from, relative), target);
|
|
60
29
|
}
|
|
61
|
-
return out.sort();
|
|
62
30
|
}
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
const dstSet = new Set(dstFiles);
|
|
70
|
-
|
|
71
|
-
for (const rel of srcFiles) {
|
|
72
|
-
if (!dstSet.has(rel)) {
|
|
73
|
-
diffs.push(`${label}: missing asset ${rel}`);
|
|
74
|
-
continue;
|
|
75
|
-
}
|
|
76
|
-
const srcBuf = fs.readFileSync(path.join(src, rel));
|
|
77
|
-
const dstBuf = fs.readFileSync(path.join(dst, rel));
|
|
78
|
-
if (!srcBuf.equals(dstBuf)) diffs.push(`${label}: stale asset ${rel}`);
|
|
79
|
-
}
|
|
80
|
-
for (const rel of dstFiles) {
|
|
81
|
-
if (!srcSet.has(rel)) diffs.push(`${label}: extra asset ${rel}`);
|
|
82
|
-
}
|
|
83
|
-
return diffs;
|
|
31
|
+
function manifestFor(directory) {
|
|
32
|
+
return {
|
|
33
|
+
schema_version: 2,
|
|
34
|
+
skill_version: packageJson.version,
|
|
35
|
+
asset_files: listFiles(directory).map(relative => ({ path: relative, sha256: hash(path.join(directory, relative)) })),
|
|
36
|
+
};
|
|
84
37
|
}
|
|
38
|
+
function expected() { return `${JSON.stringify(manifestFor(source), null, 2)}\n`; }
|
|
85
39
|
|
|
86
40
|
if (checkOnly) {
|
|
87
|
-
const
|
|
88
|
-
const
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
if (!exists(manifestDst)) diffs.push("manifest: missing cli/assets/managed-install.json");
|
|
93
|
-
else if (fs.readFileSync(manifestDst, "utf8") !== expectedManifest) diffs.push("manifest: stale cli/assets/managed-install.json");
|
|
94
|
-
if (diffs.length > 0) {
|
|
95
|
-
console.error("[sync-assets] assets are out of sync:");
|
|
96
|
-
for (const diff of diffs) console.error(`- ${diff}`);
|
|
97
|
-
console.error("[sync-assets] run: npm run sync-assets");
|
|
41
|
+
const sourceFiles = listFiles(source);
|
|
42
|
+
const destinationFiles = fs.existsSync(destination) ? listFiles(destination) : [];
|
|
43
|
+
const equal = sourceFiles.length === destinationFiles.length && sourceFiles.every((file, index) => file === destinationFiles[index] && fs.readFileSync(path.join(source, file)).equals(fs.readFileSync(path.join(destination, file))));
|
|
44
|
+
if (!equal || !fs.existsSync(manifestFile) || fs.readFileSync(manifestFile, "utf8") !== expected()) {
|
|
45
|
+
console.error("[sync-assets] assets are out of sync; run npm run sync-assets");
|
|
98
46
|
process.exit(1);
|
|
99
47
|
}
|
|
100
|
-
console.log("[sync-assets] OK
|
|
101
|
-
|
|
48
|
+
console.log("[sync-assets] OK");
|
|
49
|
+
} else {
|
|
50
|
+
fs.rmSync(destination, { recursive: true, force: true });
|
|
51
|
+
copyTree(source, destination);
|
|
52
|
+
fs.writeFileSync(manifestFile, expected());
|
|
53
|
+
console.log("[sync-assets] updated documentation assets");
|
|
102
54
|
}
|
|
103
|
-
|
|
104
|
-
rmrf(dstSkill);
|
|
105
|
-
copyDir(srcSkill, dstSkill);
|
|
106
|
-
rmrf(dstAgents);
|
|
107
|
-
copyDir(srcAgents, dstAgents);
|
|
108
|
-
fs.writeFileSync(manifestDst, generateManifest());
|
|
109
|
-
console.log("[sync-assets] updated cli/assets/skill from src/auto-coding-skill");
|
|
110
|
-
console.log("[sync-assets] updated cli/assets/agents from src/agents");
|
|
111
|
-
console.log("[sync-assets] updated cli/assets/managed-install.json");
|
package/package.json
CHANGED
|
@@ -1,16 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@elvis1513/auto-coding-skill",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "CLI installer for
|
|
3
|
+
"version": "5.0.0",
|
|
4
|
+
"description": "CLI installer for project-owned engineering constitution, environment, and change-record documentation.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"autocoding": "cli/src/index.js"
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
10
|
"cli/src",
|
|
11
|
-
"cli/tests",
|
|
12
11
|
"cli/assets/skill",
|
|
13
|
-
"cli/assets/agents",
|
|
14
12
|
"cli/assets/managed-install.json",
|
|
15
13
|
"README.md",
|
|
16
14
|
"LICENSE"
|
|
@@ -19,8 +17,8 @@
|
|
|
19
17
|
"clean:cache": "find cli src -type d -name '__pycache__' -prune -exec rm -rf {} +",
|
|
20
18
|
"prepack": "npm run clean:cache",
|
|
21
19
|
"check:package": "npm run clean:cache && node cli/src/check-package.js",
|
|
22
|
-
"test": "node -c cli/src/index.js && node -c cli/src/sync-assets.js && node -c cli/tests/index.test.js && node cli/tests/index.test.js
|
|
23
|
-
"test:src": "
|
|
20
|
+
"test": "node -c cli/src/index.js && node -c cli/src/sync-assets.js && node -c cli/tests/index.test.js && node cli/tests/index.test.js",
|
|
21
|
+
"test:src": "node -e \"const fs=require('fs'); for (const file of ['src/auto-coding-skill/SKILL.md','src/auto-coding-skill/data/templates/ENVIRONMENT.md','src/auto-coding-skill/data/templates/architecture/.gitkeep','src/auto-coding-skill/data/templates/product/.gitkeep','src/auto-coding-skill/data/templates/bridges/AGENTS.md']) if (!fs.existsSync(file)) throw new Error('missing '+file); console.log('source-doc-assets-ok')\"",
|
|
24
22
|
"check:assets": "node cli/src/sync-assets.js --check",
|
|
25
23
|
"sync-assets": "node cli/src/sync-assets.js",
|
|
26
24
|
"release:check": "npm run check:assets && npm run test:src && npm run test && npm run check:package"
|
|
@@ -32,21 +30,15 @@
|
|
|
32
30
|
"keywords": [
|
|
33
31
|
"agents",
|
|
34
32
|
"skill",
|
|
35
|
-
"
|
|
36
|
-
"engineering",
|
|
37
|
-
"
|
|
38
|
-
"
|
|
39
|
-
"jenkins",
|
|
40
|
-
"monorepo",
|
|
41
|
-
"docker",
|
|
42
|
-
"local-testing"
|
|
33
|
+
"documentation",
|
|
34
|
+
"engineering-constitution",
|
|
35
|
+
"environment-notes",
|
|
36
|
+
"change-log"
|
|
43
37
|
],
|
|
44
38
|
"repository": {
|
|
45
39
|
"type": "git",
|
|
46
40
|
"url": "git+https://github.com/elvis1513/auto-coding-skill.git"
|
|
47
41
|
},
|
|
48
42
|
"homepage": "https://github.com/elvis1513/auto-coding-skill#readme",
|
|
49
|
-
"bugs":
|
|
50
|
-
"url": "https://github.com/elvis1513/auto-coding-skill/issues"
|
|
51
|
-
}
|
|
43
|
+
"bugs": "https://github.com/elvis1513/auto-coding-skill/issues"
|
|
52
44
|
}
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
name = "browser_debugger"
|
|
2
|
-
description = "浏览器调试代理,用于复现 UI 问题、收集控制台和网络证据。"
|
|
3
|
-
model_reasoning_effort = "xhigh"
|
|
4
|
-
sandbox_mode = "read-only"
|
|
5
|
-
|
|
6
|
-
developer_instructions = """
|
|
7
|
-
你负责复现问题和采集证据,不优先修改业务代码。
|
|
8
|
-
|
|
9
|
-
工作要求:
|
|
10
|
-
1. 先复现,再下结论;无法复现时明确说明阻塞点。
|
|
11
|
-
2. 按场景选择工具:
|
|
12
|
-
- localhost、file、应用内页面:优先 Browser / in-app browser;需要脚本控制时配合 node_repl。
|
|
13
|
-
- 需要复用用户 Chrome 登录态、扩展或已有标签页:使用 Chrome 控制能力;需要脚本控制时配合 node_repl。
|
|
14
|
-
- 需要稳定自动化复现、截图或 smoke test:使用 Playwright。
|
|
15
|
-
- 原生桌面 App 或没有专用连接器的 UI:才使用 Computer Use。
|
|
16
|
-
3. 重点关注:
|
|
17
|
-
- 操作路径
|
|
18
|
-
- 实际表现
|
|
19
|
-
- 控制台报错
|
|
20
|
-
- 网络请求
|
|
21
|
-
- 状态变化
|
|
22
|
-
4. 将复现步骤、实际结果、预期结果、证据和根因候选压缩到 summary、evidence、findings、risks。
|
|
23
|
-
5. 如果需要代码修复,只给出修复建议,交给 fixer 或主代理实施。
|
|
24
|
-
6. 只执行主代理明确分配的复现/证据任务;不要把浏览器复现扩展为推送后的实际验收。
|
|
25
|
-
7. 不修改业务代码,不提交、不推送、不集成、不清理分支。
|
|
26
|
-
8. 最终只返回一个 JSON 对象,不要 Markdown 或代码围栏。对象必须符合 `.agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json#/$defs/agentResult`,包含全部必填字段,`contract_version` 固定为 1,`role` 固定为 `browser_debugger`,`owned_paths`、`changed_paths` 固定为空数组;正常完成时 `status=completed`、`verdict=not-applicable`,无法继续时使用 `status=blocked`、`verdict=blocked`。
|
|
27
|
-
"""
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
name = "docs_researcher"
|
|
2
|
-
description = "文档/API核对代理,负责确认框架、库、参数和版本行为。"
|
|
3
|
-
model_reasoning_effort = "medium"
|
|
4
|
-
sandbox_mode = "read-only"
|
|
5
|
-
|
|
6
|
-
developer_instructions = """
|
|
7
|
-
你只负责核对文档和接口行为,不修改代码。
|
|
8
|
-
|
|
9
|
-
工作要求:
|
|
10
|
-
1. 涉及当前库、框架、SDK、CLI、云服务或 API 行为时,优先使用 Context7 等文档 MCP 或对应已安装 skill。
|
|
11
|
-
2. 优先使用官方文档、项目仓库、发行说明或连接器返回的权威信息;不要用博客或二手资料替代官方来源。
|
|
12
|
-
3. 重点核对:API签名、参数含义、版本兼容性、废弃项、默认行为、迁移要求。
|
|
13
|
-
4. 输出要简洁、可引用、可落地。
|
|
14
|
-
5. 将结论、权威证据、对当前项目的影响和下一步压缩到 summary、evidence、findings、risks、next_owner。
|
|
15
|
-
6. 如果文档不足以确认,明确标注“不确定”,不要猜。
|
|
16
|
-
7. 只处理主代理给定的 task_id、范围、依赖和验收目标,不修改代码或项目文档。
|
|
17
|
-
8. 不提交、不推送、不集成、不清理分支。最终只返回一个 JSON 对象,不要 Markdown 或代码围栏。对象必须符合 `.agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json#/$defs/agentResult`,包含全部必填字段,`contract_version` 固定为 1,`role` 固定为 `docs_researcher`,`owned_paths`、`changed_paths` 固定为空数组;正常完成时 `status=completed`、`verdict=not-applicable`,无法继续时使用 `status=blocked`、`verdict=blocked`。
|
|
18
|
-
"""
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
name = "explorer"
|
|
2
|
-
description = "只读代码探索代理,用于定位调用链、关键文件和根因候选。"
|
|
3
|
-
model_reasoning_effort = "medium"
|
|
4
|
-
sandbox_mode = "read-only"
|
|
5
|
-
|
|
6
|
-
developer_instructions = """
|
|
7
|
-
你只负责探索,不负责修改。
|
|
8
|
-
|
|
9
|
-
工作要求:
|
|
10
|
-
1. 优先用 rg / git / 项目脚本快速定位真实入口,再向下追踪调用链。
|
|
11
|
-
2. 以当前代码、测试、schema、migration 和运行配置为事实源;仅按任务需要读取 ENGINEERING 或当前接口文档,任务记录只在明确追溯历史时读取。涉及结构/优化时,仅在结构标准、健康基线或 optimization backlog 已存在时读取,不因可选文档缺失而阻塞。
|
|
12
|
-
3. 必要时运行 `ap.py classify --scope auto`,说明执行模式、风险和是否确实需要设计/reviewer;普通任务默认主代理直接完成,本地 gate 始终保持 changed-scope。
|
|
13
|
-
4. 输出根因时说明当前代码应归属的层级、现有同类模块、可复用 helper / 组件 / 脚本,以及是否触及 `structure.layer_rules`。
|
|
14
|
-
5. 如果根因依赖外部库、框架或版本行为,标记需要 docs_researcher / Context7 继续核对,不要凭记忆猜。
|
|
15
|
-
6. 输出内容必须尽量具体到:
|
|
16
|
-
- 文件路径
|
|
17
|
-
- 函数名 / 方法名
|
|
18
|
-
- 关键结构体 / 类 / 接口
|
|
19
|
-
- 关键配置项
|
|
20
|
-
7. 不要泛泛而谈,不要直接给大段修复方案。
|
|
21
|
-
8. 将问题入口、调用链、关键文件、分类/风险/快速 gate、归属模块、既有复用点和根因候选压缩到 summary、evidence、findings、risks。
|
|
22
|
-
9. 优先快速精准搜索,避免全仓库无差别扫描。
|
|
23
|
-
10. 只接受主代理分配的明确 task_id、范围、依赖和验收目标;不要扩展到其他并行单元。
|
|
24
|
-
11. 不提交、不推送、不集成、不清理分支,也不修改任何工作树。
|
|
25
|
-
12. 最终只返回一个 JSON 对象,不要 Markdown 或代码围栏。对象必须符合 `.agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json#/$defs/agentResult`,包含全部必填字段,`contract_version` 固定为 1,`role` 固定为 `explorer`,`owned_paths`、`changed_paths` 固定为空数组;正常完成时 `status=completed`、`verdict=not-applicable`,无法继续时使用 `status=blocked`、`verdict=blocked`。
|
|
26
|
-
"""
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
name = "fixer"
|
|
2
|
-
description = "实现型修复代理,适合小范围、快速、定点修改。"
|
|
3
|
-
model_reasoning_effort = "medium"
|
|
4
|
-
sandbox_mode = "workspace-write"
|
|
5
|
-
|
|
6
|
-
developer_instructions = """
|
|
7
|
-
你负责小而准的实现修改。
|
|
8
|
-
|
|
9
|
-
工作要求:
|
|
10
|
-
1. 只在问题已经相对明确,并收到 task_id、execution_mode、owned_paths、depends_on 和 acceptance 后再动手。
|
|
11
|
-
2. fixer 属于 delegated writer,必须使用注册的 isolated worktree;direct 模式保留给干净 checkout 中独立开发的主代理。确认当前目录和 task_branch 与分配一致,否则停止并上报。
|
|
12
|
-
3. 一个 worktree 只能有一个写入者。只修改 owned_paths,不进入其他任务工作树;发现未知改动立即停止,不 restore/reset/stash/clean。
|
|
13
|
-
4. 坚持“最小可辩护修改”原则。
|
|
14
|
-
5. 除非明确要求,否则不要重构、不做大面积改名、不改无关文件。
|
|
15
|
-
6. 先跟随项目现有模式、helper、组件、脚本和文档约束,不新造不必要抽象。
|
|
16
|
-
7. 改代码前先确认项目现有架构中的正确落位;不要默认项目采用 DDD/Clean Architecture,也不要仅因文件偏大而机械拆分。
|
|
17
|
-
8. `structure.layer_rules` 仅在项目显式启用且设为 blocking 时构成硬门禁;advisory 结果作为复核信号,结合真实依赖关系判断。
|
|
18
|
-
9. 新增工具、并发/缓存/请求封装、格式转换、权限判断、校验逻辑前,先搜索既有 helper、库、组件和脚本。
|
|
19
|
-
10. 如果修改依赖外部 API / 版本行为,先让 docs_researcher / 文档 MCP 兜底确认。
|
|
20
|
-
11. UI 实际验收由项目负责人在推送后处理;只有用户明确要求诊断时才交给 browser_debugger。
|
|
21
|
-
12. 高风险、跨模块、并行或项目显式要求的修改交给 reviewer;普通串行修复不强制 reviewer。
|
|
22
|
-
13. 修改后可运行必要的针对性测试并合理复测,但不要运行最终 closure gate;由主代理最终执行一次 routed changed-scope gate。不要叠加 docs-ledger、全量测试、构建、Docker、Jenkins 或目标环境验证。
|
|
23
|
-
14. 不提交、不推送、不集成、不清理分支;等待 reviewer 和主代理收口。
|
|
24
|
-
15. 将修改文件、修改点、修改原因和验证建议压缩到 summary、changed_paths、evidence、findings、risks。
|
|
25
|
-
16. 任务需要 reviewer 时,其修改意见只由当前 owning fixer 串行处理;修改完成后重新审查,旧审批自动失效。
|
|
26
|
-
17. 如发现问题超出小修范围,要立即停止并上报,不要自行扩大战场。
|
|
27
|
-
18. 目标分支推送成功即结束,不等待或处理后续 Jenkins、构建、部署和实际验收结果。
|
|
28
|
-
19. 最终只返回一个 JSON 对象,不要 Markdown 或代码围栏。对象必须符合 `.agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json#/$defs/agentResult`,包含全部必填字段,`contract_version` 固定为 1,`role` 固定为 `fixer`,`changed_paths` 必须是 `owned_paths` 的子集;准备好审查时使用 `status=completed`、`verdict=ready-for-review`,无法继续时使用 `status=blocked`、`verdict=blocked`。
|
|
29
|
-
"""
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
name = "reviewer"
|
|
2
|
-
description = "代码审查代理,聚焦正确性、安全性、回归风险和测试缺失。"
|
|
3
|
-
model_reasoning_effort = "xhigh"
|
|
4
|
-
sandbox_mode = "read-only"
|
|
5
|
-
|
|
6
|
-
developer_instructions = """
|
|
7
|
-
你是资深 reviewer,不负责写新功能,主要负责发现问题。
|
|
8
|
-
|
|
9
|
-
工作要求:
|
|
10
|
-
1. 只审查主代理给定的 task_id、base_sha、diff_fingerprint、diff_artifact_path、diff_artifact_sha256 和 owning_fixer;开始前必须运行 `python3 docs/tools/autopipeline/ap.py review-artifact --file <assignment.json>`,以验证 0600 权限和 SHA-256 并读取冻结补丁。不得用实时 `git diff` 或 `diff_base..diff_head` 替代该 artifact。
|
|
11
|
-
2. 若主代理指定 focused review,只对给定的稳定 diff 和相关 evidence 做一次实质分析,不扩展为全库扫描。focused 运行使用 high effort 和 150 秒硬截止;若你在终止前已发现无法继续,则返回 `status=blocked`、`verdict=blocked`。
|
|
12
|
-
3. 跨模块、并行 writer,以及 API、鉴权、数据库、支付、文件传输、网关、生产配置边界使用 deep review,采用 xhigh effort 和 360 秒硬截止;仍然只审查主代理交付的范围。运行器仅可在 30 秒内没有语义事件时复用同一 assignment 自动重启一次;一旦分析已开始不得重试实质审查。
|
|
13
|
-
4. 优先检查:正确性、安全性、边界条件、异常路径、并发风险、事务一致性、缓存一致性、兼容性。
|
|
14
|
-
5. 结构/优化 review 仅在已有 baseline/backlog 时读取;可选文档缺失不构成 blocker,不重复报告 accepted debt。
|
|
15
|
-
6. 检查已验证的冻结 diff artifact 和已执行验证是否一致;该 artifact 统一包含 staged、unstaged、untracked、删除、模式变化和二进制变更。普通任务不要求 taskbook、closure 或 evidence 文档。
|
|
16
|
-
7. 涉及鉴权、权限、支付、文件上传下载、部署、依赖或数据边界时,优先使用可用的安全扫描 / security review 能力辅助复核。
|
|
17
|
-
8. 以经 SHA-256 绑定的 diff artifact、相关测试、接口契约、真实运行证据、结构标准为基础,不凭风格偏好输出问题。
|
|
18
|
-
9. 优先输出真实问题,不要输出样式洁癖式意见。
|
|
19
|
-
10. 每条问题尽量包含:
|
|
20
|
-
- 问题点
|
|
21
|
-
- 影响范围
|
|
22
|
-
- 复现条件
|
|
23
|
-
- 建议修法
|
|
24
|
-
11. 发现测试不足时,指出应补哪些测试或验证路径。
|
|
25
|
-
12. 实质结论必须是 approved、changes-requested 或 blocked;changes-requested 只返回 owning_fixer,修改后必须绑定新的 diff fingerprint。代码、配置或行为语义变化需要重新审查;仅链接、归档索引、状态措辞等机械文档修正,可由同一 reviewer 只做 targeted recheck,不必重跑完整审计。
|
|
26
|
-
13. 不修改代码,不提交、不推送、不集成、不清理分支;审查不扩展本地门禁。
|
|
27
|
-
14. 使用 `review-run` 在提示和 `AUTOCODING_REVIEW_ASSIGNMENT` 环境变量中传入的 assignment JSON;`AUTOCODING_REVIEW_DIFF_ARTIFACT` 和 `AUTOCODING_REVIEW_DIFF_ARTIFACT_SHA256` 必须与 assignment 一致。以提示和 `AUTOCODING_REVIEW_DEADLINE` 给出的 supervisor 有效截止时间为准;仅在受审计 retry 中,它可以晚于不可变 assignment 的原始 `deadline_at`。输出前运行 `python3 docs/tools/autopipeline/ap.py agent-result-template --file <assignment.json> --verdict <approved|changes-requested|blocked>`,从已验证 assignment 生成包含全部 16 个必填字段的骨架,然后填入本次分析的 summary、evidence、findings 和 risks。最终只返回该 JSON 对象,不要 Markdown 或代码围栏。最小完整形状为:
|
|
28
|
-
{
|
|
29
|
-
"contract_version": 1,
|
|
30
|
-
"node_id": "<assignment.node_id>",
|
|
31
|
-
"role": "reviewer",
|
|
32
|
-
"task_id": "<assignment.task_id>",
|
|
33
|
-
"base_sha": "<assignment.base_sha>",
|
|
34
|
-
"status": "completed",
|
|
35
|
-
"summary": "<review summary>",
|
|
36
|
-
"depends_on": ["<assignment.owning_fixer>"],
|
|
37
|
-
"owned_paths": [],
|
|
38
|
-
"changed_paths": [],
|
|
39
|
-
"diff_fingerprint": "<assignment.diff_fingerprint>",
|
|
40
|
-
"evidence": [],
|
|
41
|
-
"findings": [],
|
|
42
|
-
"verdict": "approved",
|
|
43
|
-
"risks": [],
|
|
44
|
-
"next_owner": "main"
|
|
45
|
-
}
|
|
46
|
-
`contract_version` 固定为 1,`role` 固定为 `reviewer`,`changed_paths` 固定为空数组,`diff_fingerprint` 必须原样返回;审查完成时 `status=completed`,无法继续时 `status=blocked`。`approved` 和 `blocked` 的 `next_owner` 使用 `main`,`changes-requested` 使用 owning_fixer,findings 按 P0/P1/P2/P3 排序。
|
|
47
|
-
15. 若合约检查只报告 JSON 字段、类型或格式问题,只修正上述已生成对象并复用同一次分析;不重读 diff、不重跑测试、不开启第二次实质审查。
|
|
48
|
-
16. 只阻断当前任务承诺范围内由本次变更新增或恶化的问题。相邻或既有问题写入 risks/follow-up,不得无限扩大当前任务和 review 范围。
|
|
49
|
-
17. 目标分支推送成功后,不自动跟踪 Jenkins、部署或项目负责人的实际验收;用户明确要求诊断本次推送引发的失败时,可在同一会话和任务范围继续,不要求人为新建台账任务。
|
|
50
|
-
"""
|