openone-workflow-kit 0.1.0

package/examples/ecommerce/team-profile.example.yaml

@@ -0,0 +1,141 @@
+schema_version: "1.0"
+generated_at: "2026-06-05T00:00:00.000Z"
+generated_by: "agent-workflow-init (ecommerce example)"
+
+# Example profile for an ecommerce team that runs both a customer-facing
+# storefront and a backoffice for merchants. Replace placeholders before use.
+
+team:
+  name: "Example Storefront Team"
+  business_definition: "Direct-to-consumer storefront and merchant backoffice."
+  target_users:
+    - "shopper"
+    - "merchant operator"
+    - "fulfillment partner"
+
+industries:
+  - ecommerce
+
+enabled_tools:
+  - codex
+  - claude
+  - cursor
+  - copilot
+
+detected_tools: []
+
+source_materials:
+  business_intro:
+    label: "业务介绍"
+    status: "provided_by_user"
+    paths:
+      - "docs/product/overview.md"
+  project_docs:
+    label: "项目资料"
+    status: "provided_by_user"
+    paths:
+      - "docs/product/"
+      - "docs/merchant-runbook.md"
+  ui_specs:
+    label: "UI 设计文件"
+    status: "provided_by_user"
+    paths:
+      - "docs/design/storefront-tokens.md"
+      - "docs/design/backoffice-tokens.md"
+  frontend_rules:
+    label: "前端开发规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/frontend-rules.md"
+  backend_rules:
+    label: "后端开发规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/backend-rules.md"
+  testing_rules:
+    label: "测试规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/testing-rules.md"
+
+repos:
+  - path: "apps/storefront"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "react"
+      - "next"
+      - "typescript"
+    family: "frontend-web"
+    role: "customer storefront"
+  - path: "apps/backoffice"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "vue"
+      - "typescript"
+    family: "frontend-web"
+    role: "merchant backoffice"
+  - path: "services/catalog"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "catalog and search"
+  - path: "services/orders"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "order lifecycle"
+  - path: "services/payments"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "payment integration"
+
+branch_model:
+  type: "gitflow"
+  production_branch: "main"
+  integration_branch: "develop"
+  feature_branch_rule: "feature/{ticket}-{slug}"
+  worktree_dir: "_worktrees"
+
+risk_policy:
+  remote_git_operations: "manual-only"
+  branch_creation: "manual-only"
+  push_and_release: "manual-only"
+  database_writes: "manual-only"
+  config_writes: "manual-only"
+  high_risk_files:
+    - "ci/**"
+    - "deploy/**"
+    - "*.env*"
+    - "infra/**"
+    - "package.json"
+    - "lockfiles"
+    - "openapi/**"
+    - "payments/config/**"
+
+workflow:
+  features_dir: "features"
+  core_dir: "workflow/core"
+  adapters_dir: "workflow/adapters"
+  require_stage_gate_for_code: true
+  require_feature_branch_for_code: true
+  same_repo_parallel_policy: "worktree-required-after-implementation-stage"
+
+# Ecommerce teams should prioritize release safety, contract tracing
+# (between catalog/orders/payments), and UI baseline review for the storefront.
+enabled_capabilities:
+  - branch-gatekeeper
+  - release-safety-checker
+  - prd-code-diff-checker
+  - contract-tracer
+  - ui-baseline-reviewer
+  - security-reviewer
+  - test-evidence-reviewer

package/examples/education/team-profile.example.yaml

@@ -0,0 +1,143 @@
+schema_version: "1.0"
+generated_at: "2026-06-05T00:00:00.000Z"
+generated_by: "agent-workflow-init (education example)"
+
+# Example profile for a learning platform team that runs a learner-facing
+# web app, an instructor console, and backend services. Replace placeholders
+# before use; do not commit real learner, instructor, school, or billing data.
+
+team:
+  name: "Example Learning Platform"
+  business_definition: "Learning platform for course delivery, assessments, and instructor operations."
+  target_users:
+    - "learner"
+    - "instructor"
+    - "school admin"
+    - "support operator"
+
+industries:
+  - education
+
+enabled_tools:
+  - codex
+  - claude
+  - cursor
+
+detected_tools: []
+
+source_materials:
+  business_intro:
+    label: "业务介绍"
+    status: "provided_by_user"
+    paths:
+      - "docs/product/overview.md"
+  project_docs:
+    label: "项目资料"
+    status: "provided_by_user"
+    paths:
+      - "docs/product/"
+      - "docs/learning-content/"
+  ui_specs:
+    label: "UI 设计文件"
+    status: "provided_by_user"
+    paths:
+      - "docs/design/learner-tokens.md"
+      - "docs/design/instructor-tokens.md"
+  frontend_rules:
+    label: "前端开发规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/frontend-rules.md"
+  backend_rules:
+    label: "后端开发规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/backend-rules.md"
+  testing_rules:
+    label: "测试规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/testing-rules.md"
+
+repos:
+  - path: "apps/learner-web"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "react"
+      - "typescript"
+    family: "frontend-web"
+    role: "learner-facing web app"
+  - path: "apps/instructor-console"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "vue"
+      - "typescript"
+    family: "frontend-web"
+    role: "instructor operations console"
+  - path: "services/course"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "course catalog and enrollment"
+  - path: "services/assessment"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "quiz and assessment workflow"
+  - path: "services/notification"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "email and in-app notifications"
+
+branch_model:
+  type: "trunk-based"
+  production_branch: "main"
+  integration_branch: "main"
+  feature_branch_rule: "feature/{ticket}-{slug}"
+  worktree_dir: "_worktrees"
+
+risk_policy:
+  remote_git_operations: "manual-only"
+  branch_creation: "manual-only"
+  push_and_release: "manual-only"
+  database_writes: "manual-only"
+  config_writes: "manual-only"
+  high_risk_files:
+    - "ci/**"
+    - "deploy/**"
+    - "*.env*"
+    - "infra/**"
+    - "package.json"
+    - "lockfiles"
+    - "content-import/**"
+    - "privacy/**"
+
+workflow:
+  features_dir: "features"
+  core_dir: "workflow/core"
+  adapters_dir: "workflow/adapters"
+  require_stage_gate_for_code: true
+  require_feature_branch_for_code: true
+  same_repo_parallel_policy: "worktree-required-after-implementation-stage"
+
+# Learning platforms should prioritize contract tracing for course and
+# assessment flows, privacy review for learner data, and evidence-based
+# verification of learner and instructor journeys.
+enabled_capabilities:
+  - branch-gatekeeper
+  - release-safety-checker
+  - prd-code-diff-checker
+  - contract-tracer
+  - ui-baseline-reviewer
+  - security-reviewer
+  - test-evidence-reviewer
+  - verify-app

package/examples/saas-to-b/team-profile.example.yaml

@@ -0,0 +1,130 @@
+schema_version: "1.0"
+generated_at: "2026-06-05T00:00:00.000Z"
+generated_by: "agent-workflow-init (saas-to-b example)"
+
+# Example profile for a SaaS to B team building a multi-tenant web product.
+# Replace placeholders with real, non-confidential information before use.
+
+team:
+  name: "Example B2B SaaS"
+  business_definition: "Multi-tenant workflow product for mid-size operations teams."
+  target_users:
+    - "operations admin"
+    - "team lead"
+    - "external auditor"
+
+industries:
+  - saas-to-b
+
+enabled_tools:
+  - codex
+  - claude
+  - cursor
+
+detected_tools: []
+
+source_materials:
+  business_intro:
+    label: "业务介绍"
+    status: "provided_by_user"
+    paths:
+      - "docs/product/overview.md"
+  project_docs:
+    label: "项目资料"
+    status: "provided_by_user"
+    paths:
+      - "docs/product/"
+  ui_specs:
+    label: "UI 设计文件"
+    status: "provided_by_user"
+    paths:
+      - "docs/design/tokens.md"
+      - "docs/design/components.md"
+  frontend_rules:
+    label: "前端开发规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/frontend-rules.md"
+  backend_rules:
+    label: "后端开发规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/backend-rules.md"
+  testing_rules:
+    label: "测试规范"
+    status: "provided_by_user"
+    paths:
+      - "docs/testing-rules.md"
+
+repos:
+  - path: "apps/web"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "react"
+      - "typescript"
+      - "vite"
+    family: "frontend-web"
+    role: "tenant-facing web app"
+  - path: "apps/admin"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "react"
+      - "typescript"
+    family: "frontend-web"
+    role: "internal admin console"
+  - path: "services/api"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+      - "fastify"
+    family: "backend-api"
+    role: "tenant-facing API gateway"
+  - path: "services/billing"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "typescript"
+    family: "backend-service"
+    role: "subscription billing"
+
+branch_model:
+  type: "trunk-based"
+  production_branch: "main"
+  integration_branch: "main"
+  feature_branch_rule: "feature/{ticket}-{slug}"
+  worktree_dir: "_worktrees"
+
+risk_policy:
+  remote_git_operations: "manual-only"
+  branch_creation: "manual-only"
+  push_and_release: "manual-only"
+  database_writes: "manual-only"
+  config_writes: "manual-only"
+  high_risk_files:
+    - "ci/**"
+    - "deploy/**"
+    - "*.env*"
+    - "infra/**"
+    - "package.json"
+    - "lockfiles"
+    - "openapi/**"
+
+workflow:
+  features_dir: "features"
+  core_dir: "workflow/core"
+  adapters_dir: "workflow/adapters"
+  require_stage_gate_for_code: true
+  require_feature_branch_for_code: true
+  same_repo_parallel_policy: "worktree-required-after-implementation-stage"
+
+# Recommended capabilities to adopt first for a SaaS to B product.
+enabled_capabilities:
+  - branch-gatekeeper
+  - release-safety-checker
+  - prd-code-diff-checker
+  - contract-tracer
+  - security-reviewer
+  - ui-baseline-reviewer

package/examples/team-profile.example.yaml

@@ -0,0 +1,69 @@
+schema_version: "1.0"
+generated_at: "2026-06-05T00:00:00.000Z"
+generated_by: "agent-workflow-init 0.1.0"
+
+team:
+  name: "Example Team"
+  business_definition: "A placeholder product team used for starter-kit demonstration."
+  target_users:
+    - "internal users"
+    - "external customers"
+
+enabled_tools:
+  - codex
+  - claude
+  - cursor
+
+source_materials:
+  business_intro:
+    label: "业务介绍"
+    status: "detected"
+    paths:
+      - "docs/business-overview.md"
+  project_docs:
+    label: "项目资料"
+    status: "detected"
+    paths:
+      - "docs/product/"
+  ui_specs:
+    label: "UI 设计文件"
+    status: "missing"
+    paths: []
+  frontend_rules:
+    label: "前端开发规范"
+    status: "detected"
+    paths:
+      - "docs/frontend-rules.md"
+  backend_rules:
+    label: "后端开发规范"
+    status: "detected"
+    paths:
+      - "docs/backend-rules.md"
+  testing_rules:
+    label: "测试规范"
+    status: "detected"
+    paths:
+      - "docs/testing-rules.md"
+
+repos:
+  - path: "apps/web"
+    marker: "node"
+    tech_stack:
+      - "node"
+      - "react"
+      - "typescript"
+    family: "frontend-web"
+    role: "customer web app"
+  - path: "services/api"
+    marker: "maven"
+    tech_stack:
+      - "java-maven"
+    family: "backend-api"
+    role: "business API"
+
+branch_model:
+  type: "prod-test"
+  production_branch: "main"
+  integration_branch: "develop"
+  feature_branch_rule: "feature/{ticket}-{slug}"
+  worktree_dir: "_worktrees"

package/install.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+
+# 前置检查：需要 Node.js >= 18。
+if ! command -v node >/dev/null 2>&1; then
+  echo "错误：未安装 Node.js，请安装 Node.js 18 或更高版本。" >&2
+  echo "  https://nodejs.org/" >&2
+  exit 1
+fi
+
+NODE_MAJOR=$(node -e 'process.stdout.write(String(process.versions.node.split(".")[0]))' 2>/dev/null || echo 0)
+if [ "$NODE_MAJOR" -lt 18 ]; then
+  echo "错误：当前 Node.js 为 $(node -v 2>/dev/null || echo unknown)，需要 18 或更高版本。" >&2
+  echo "  当前: $(node -v 2>/dev/null || echo unknown)。要求: >= v18" >&2
+  exit 1
+fi
+
+if [ "$#" -eq 0 ]; then
+  TARGET="."
+else
+  TARGET="$1"
+  shift
+fi
+
+exec node "$SCRIPT_DIR/bin/init-workspace.cjs" --target "$TARGET" "$@"

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "openone-workflow-kit",
+  "version": "0.1.0",
+  "private": false,
+  "description": "面向独立开发者的工具无关 Agent 研发与商业化双轨工作流 kit，支持可验证交付、多工具适配、发布与增长复盘。",
+  "keywords": [
+    "agent-workflow",
+    "workflow",
+    "codex",
+    "claude-code",
+    "cursor",
+    "github-copilot",
+    "codebuddy",
+    "kiro",
+    "trae",
+    "solo-developer",
+    "product-management",
+    "commercialization",
+    "software-delivery"
+  ],
+  "homepage": "https://github.com/bluecoast1379/openone-workflow-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bluecoast1379/openone-workflow-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bluecoast1379/openone-workflow-kit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "CHANGELOG.md",
+    "INIT.md",
+    "LICENSE",
+    "NOTICE",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "install.sh",
+    "bin/",
+    "scripts/",
+    "workflow/",
+    "templates/",
+    "examples/",
+    "docs/",
+    "test/"
+  ],
+  "bin": {
+    "agent-workflow-init": "bin/init-workspace.cjs",
+    "openone-workflow-init": "bin/init-workspace.cjs",
+    "agent-workflow-check-sanitized": "bin/check-sanitized.cjs",
+    "openone-workflow-check-contract": "bin/check-contract.cjs"
+  },
+  "scripts": {
+    "check": "node --check bin/init-workspace.cjs && node --check bin/check-sanitized.cjs && node --check bin/check-contract.cjs && node --check test/smoke.cjs && node --check test/release-readiness.cjs && node --check scripts/release-source-state.cjs && node --check scripts/build-release.cjs && node bin/check-sanitized.cjs && node test/smoke.cjs && node test/release-readiness.cjs",
+    "build:release": "node scripts/build-release.cjs",
+    "init:dry-run": "node bin/init-workspace.cjs --target . --dry-run"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "Apache-2.0"
+}