@captain_z/zsk 1.4.3 → 1.6.0

package/templates/project-init/.zsk/learning/proposals/.gitkeep

@@ -0,0 +1 @@
+

package/templates/project-init/.zsk/resource-manifest.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "resources": {
+    "configured-sources": {
+      "source": ".zsk/config.yaml",
+      "status": "present",
+      "evidence": []
+    },
+    "resource-manifest": {
+      "source": ".zsk/resource-manifest.json",
+      "status": "present",
+      "evidence": []
+    },
+    "requirements": {
+      "source": ".raws/requirements",
+      "status": "missing",
+      "evidence": []
+    },
+    "api-contracts": {
+      "source": ".raws/api-contracts",
+      "status": "missing",
+      "evidence": []
+    },
+    "backend-repositories": {
+      "source": ".raws/backend-repositories",
+      "status": "missing",
+      "evidence": []
+    },
+    "design-sources": {
+      "source": ".raws/design-sources",
+      "status": "missing",
+      "evidence": []
+    },
+    "design-assets": {
+      "source": ".raws/design-assets",
+      "status": "missing",
+      "evidence": []
+    },
+    "test-cases": {
+      "source": ".raws/testing",
+      "status": "missing",
+      "evidence": []
+    },
+    "issue-records": {
+      "source": ".issues",
+      "status": "present",
+      "evidence": []
+    },
+    "learning-proposals": {
+      "source": ".zsk/learning/proposals",
+      "status": "present",
+      "evidence": []
+    }
+  }
+}

package/templates/project-init/.zsk/workflow-state.json

@@ -0,0 +1,6 @@
+{
+  "version": 1,
+  "modules": {},
+  "updatedAt": "__INIT_TIMESTAMP__"
+}
+

package/templates/project-init/docs/_module-index.md

@@ -1,7 +1,15 @@
 # Module Index
 
-This file is maintained by `zsk prep` and AI-assisted module discovery.
+This file is the entry point for project modules. It is maintained by `zsk prep`, `zsk module init`, and AI-assisted module discovery.
+
+Use it to answer three questions before starting a skill stage:
+
+- which modules exist;
+- where each module's `module.yaml` lives;
+- whether the module is ready for proposal/spec/design/task/coding work.
 
 | Module | Name | Config | Status |
 | --- | --- | --- | --- |
 | `<module-id>` | `<module-name>` | `docs/<module-id>/module.yaml` | pending |
+
+Status values are project-owned. Recommended baseline: `pending`, `active`, `blocked`, `verified`, `archived`.

package/templates/project-init/project-config.md

@@ -92,7 +92,7 @@ examples:
 | Design sources | `.raws/design-sources/index.md` | `.zsk/config.yaml#sources` | Figma、Modao、MCP、设计交付源 |
 | Design assets | `.raws/design-assets/index.md` | `.zsk/config.yaml#sources` | token、图片、图标、截图、静态设计资产 |
 | Testing assets | `.raws/testing/index.md` | `.zsk/config.yaml#sources` + `docs/{module}/module.yaml` | QA、验收、发布测试用例 |
-| Issues / evidence | `.issues/README.md` | `.zsk/config.yaml#paths.issues` | bug、截图、日志、复测证据 |
+| Issues / evidence | `.issues/README.md` / `.issues/index.md` / `.issues/{module}/index.md` | `.zsk/config.yaml#paths.issues` | bug、截图、日志、复测证据、模块状态索引、全局统计 |
 
 ## 3. `.raws` / `docs` / `.issues` 边界
 
@@ -113,6 +113,8 @@ examples:
 > 设计资产：`.raws/design-assets/{module}/`
 > 测试资产：`.raws/testing/{case-file}`
 > 本地问题：`.issues/{module}/BUG-0001-short-slug/issue.md`
+> 模块索引：`.issues/{module}/index.md`
+> 全局统计：`.issues/index.md`
 ```
 
 模块级映射写入 `docs/{module}/module.yaml`，项目级来源写入 `.zsk/config.yaml#sources`。
@@ -125,7 +127,7 @@ examples:
 | Language | `<language>` | TypeScript / Java / Go / etc. |
 | Build | `<build command>` | 与 package manager 保持一致 |
 | Test | `<test command>` | CI 和本地验收都应可复用 |
-| UI / Runtime verification | `computer_use / browser_use` | 具体工具以 `.zsk/config.yaml#tools` 为准 |
+| UI / Runtime verification | `playwright_cli / playwright_mcp / browser_use / computer_use` | Playwright 默认执行与证据；Browser Use 复用登录态；Computer Use 处理视觉/系统级场景 |
 
 ## 6. 冲突处理顺序
 
@@ -149,4 +151,4 @@ examples:
 - [ ] `.raws/index.md` 与相关分类 `index.md`
 - [ ] 受影响模块的 `docs/{module}/module.yaml`
 - [ ] 受影响模块的 `docs/{module}/spec.md` / `design.md`
-- [ ] 必要时新增或更新 `.issues/{module}/BUG-xxxx/issue.md`
+- [ ] 必要时新增或更新 `.issues/{module}/BUG-xxxx/issue.md`，并同步 `.issues/{module}/index.md` 与 `.issues/index.md`