global-app-skill 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "global-app-skill",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Thin skill bootstrap and GitHub resource runner for overseas Android app research",
   "type": "module",
   "license": "UNLICENSED",

package/skills/global-app-analysis/SKILL.md

@@ -16,3 +16,8 @@ npx -y --prefer-online global-app-skill@latest context resolve --mode MODE
 CLI 自动发现已安装的 skill 并同步入口，检查 `skillUpdate` 并报告失败；新入口在客户端重新加载后采用。依次读取全部 `mustRead`，以 `resourceRoot` 解析资源并按流程执行。新任务重新 resolve，同一任务沿用已读快照。资源更新或校验失败时停止依赖工作，不静默使用旧资源。
 
 脚本通过 `npx -y --prefer-online global-app-skill@latest run SCRIPT --mode MODE --resource-root RESOURCE_ROOT -- 参数` 执行；参数见解析后的 CLI 文档。业务判断与页面操作由 agent 按文档编排，CLI 成功不代表调研完成；关键进度仍须输出到聊天正文。
+
+## 必检入口
+
+解析资源后，先读取当前 `resourceRoot` 下的 `references/rules.md`。读取失败时暂停依赖该规则的工作。
+到达规则定义的检查点时执行对应校验并记录结果。通过后才可正式或阶段性交付，包括复用、重发已有报告或链接。校验未通过时按规则回退或说明阻塞与恢复条件。

package/src/protocol.mjs

@@ -7,6 +7,7 @@ export const RELEASE_BASE = 'https://github.com/shiguang-lab/global-app-skill/re
 export const FEED = `${RELEASE_BASE}/latest/download/latest.json`;
 export const RELEASE_TAG = /^(?:v|resources-v)(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 export const MAX_BYTES = 16 * 1024 * 1024;
+export const RULES_PATH = 'references/rules.md';
 export const MODES = {
   download: 'references/download-workflow.md',
   research: 'references/research-workflow.md',
@@ -21,7 +22,7 @@ export function validateMode(mode) {
   return mode;
 }
 
-export function validateManifest(manifest) {
+export function validateManifest(manifest, { requireRules = true } = {}) {
   const hash = /^[a-f0-9]{64}$/;
   if (manifest?.schemaVersion !== 1 || !RELEASE_TAG.test(manifest.releaseTag) || !hash.test(manifest.resourceHash) ||
       !/^\d+\.\d+\.\d+$/.test(manifest.minCliVersion) ||
@@ -44,7 +45,9 @@ export function validateManifest(manifest) {
   if (identity(manifest.files) !== manifest.resourceHash) throw new Error('Resource manifest hash mismatch');
   const required = ['references/guide.md', 'references/cli.md', 'references/orchestration.md',
     ...Object.values(MODES), ...SCRIPTS.map(name => `scripts/${name}.py`), 'scripts/apk_utils.py', 'scripts/progress.py'];
-  if (required.some(name => !seen.has(name))) throw new Error('Resource manifest is missing workflow files');
+  if (requireRules) required.unshift(RULES_PATH, 'references/delivery-record.md', 'scripts/check_delivery.py');
+  const missing = required.filter(name => !seen.has(name));
+  if (missing.length) throw new Error(`Resource manifest is missing workflow files: ${missing.join(', ')}`);
   const installed = VERSION.split('.').map(Number);
   const minimum = manifest.minCliVersion.split('.').map(Number);
   for (let i = 0; i < 3; i++) {

package/src/resources.mjs

@@ -3,7 +3,7 @@ import { homedir } from 'node:os';
 import path from 'node:path';
 import { setTimeout as delay } from 'node:timers/promises';
 import { gunzipSync } from 'node:zlib';
-import { bundleUrl, FEED, MAX_BYTES, MODES, sha256, validateManifest, validateMode } from './protocol.mjs';
+import { bundleUrl, FEED, MAX_BYTES, MODES, RULES_PATH, sha256, validateManifest, validateMode } from './protocol.mjs';
 
 async function download(url, limit) {
   const response = await fetch(url, { cache: 'no-store', signal: AbortSignal.timeout(30000) });
@@ -20,12 +20,12 @@ async function download(url, limit) {
   return Buffer.concat(chunks);
 }
 
-export async function readSnapshot(resourceRoot) {
+export async function readSnapshot(resourceRoot, options) {
   resourceRoot = path.resolve(resourceRoot);
   if (!(await lstat(resourceRoot)).isDirectory()) throw new Error('Resource root must be a real directory');
   const manifestPath = path.join(resourceRoot, 'manifest.json');
   if (!(await lstat(manifestPath)).isFile()) throw new Error('Resource manifest must be a regular file');
-  const manifest = validateManifest(JSON.parse(await readFile(manifestPath, 'utf8')));
+  const manifest = validateManifest(JSON.parse(await readFile(manifestPath, 'utf8')), options);
   if (path.basename(resourceRoot) !== manifest.resourceHash) throw new Error('Resource root does not match its snapshot hash');
   for (const file of manifest.files) {
     let directory = resourceRoot;
@@ -107,7 +107,7 @@ export async function resolveContext({ mode, feed = FEED, cacheDir, progress = (
   }
   await readSnapshot(resourceRoot);
   progress(updated ? 'Resource snapshot ready' : 'Verified cached snapshot is current');
-  const mustRead = ['references/cli.md', 'references/guide.md', 'references/orchestration.md', MODES[mode]]
+  const mustRead = [RULES_PATH, 'references/cli.md', 'references/guide.md', 'references/orchestration.md', MODES[mode]]
     .map(name => path.join(resourceRoot, name));
   return { ok: true, source: url.origin === 'https://github.com' ? 'github' : 'custom', feed: url.href,
     mode, releaseTag: manifest.releaseTag, resourceHash: manifest.resourceHash, resourceRoot,

package/src/run.mjs

@@ -7,7 +7,8 @@ import { readSnapshot, resolveContext } from './resources.mjs';
 export async function runScript(script, args, options = {}) {
   if (!SCRIPTS.includes(script)) throw new Error(`Unknown script; choose ${SCRIPTS.join(', ')}`);
   const resourceRoot = options.resourceRoot ? path.resolve(options.resourceRoot) : (await resolveContext(options)).resourceRoot;
-  await readSnapshot(resourceRoot);
+  // A task that already resolved an earlier snapshot may finish on it.
+  await readSnapshot(resourceRoot, { requireRules: !options.resourceRoot });
   await promisify(execFile)('python3', ['-c', 'import sys; sys.exit(0 if sys.version_info >= (3, 9) else 1)'])
     .catch(() => { throw new Error('Python >=3.9 must be available as python3'); });
   return new Promise((resolve, reject) => {