openone-workflow-kit 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.
Files changed (109) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/CODE_OF_CONDUCT.md +25 -0
  3. package/CONTRIBUTING.md +51 -0
  4. package/INIT.md +81 -0
  5. package/LICENSE +201 -0
  6. package/NOTICE +6 -0
  7. package/README.md +195 -0
  8. package/SECURITY.md +39 -0
  9. package/bin/check-contract.cjs +137 -0
  10. package/bin/check-sanitized.cjs +93 -0
  11. package/bin/init-workspace.cjs +966 -0
  12. package/docs/assets/PROVENANCE.md +20 -0
  13. package/docs/assets/architecture.svg +112 -0
  14. package/docs/assets/hero.svg +83 -0
  15. package/docs/assets/quick-demo.svg +74 -0
  16. package/docs/assets/social-preview.svg +57 -0
  17. package/docs/assets/visual-manifest.json +52 -0
  18. package/docs/definition-of-done.md +80 -0
  19. package/docs/dual-track-workflow.md +90 -0
  20. package/docs/local-merge-notes.md +21 -0
  21. package/docs/maintainer-handoff.md +150 -0
  22. package/docs/manual-publish.md +119 -0
  23. package/docs/private-denylist.example.txt +11 -0
  24. package/docs/publication-decisions.md +36 -0
  25. package/docs/release-checklist.md +72 -0
  26. package/docs/releases/v0.1.0.md +70 -0
  27. package/docs/shareable-install.md +51 -0
  28. package/docs/tool-install-recipes.md +103 -0
  29. package/examples/ecommerce/team-profile.example.yaml +141 -0
  30. package/examples/education/team-profile.example.yaml +143 -0
  31. package/examples/saas-to-b/team-profile.example.yaml +130 -0
  32. package/examples/team-profile.example.yaml +69 -0
  33. package/install.sh +27 -0
  34. package/package.json +65 -0
  35. package/scripts/build-release.cjs +141 -0
  36. package/scripts/release-source-state.cjs +38 -0
  37. package/templates/AGENTS.template.md +26 -0
  38. package/test/release-readiness.cjs +214 -0
  39. package/test/smoke.cjs +272 -0
  40. package/workflow/adapters/README.md +16 -0
  41. package/workflow/core/README.md +38 -0
  42. package/workflow/core/capabilities/README.md +61 -0
  43. package/workflow/core/capabilities/acceptance-oracle-tracker.md +45 -0
  44. package/workflow/core/capabilities/branch-gatekeeper.md +57 -0
  45. package/workflow/core/capabilities/channel-experiment-tracker.md +32 -0
  46. package/workflow/core/capabilities/ci-cd-automation-governor.md +123 -0
  47. package/workflow/core/capabilities/contract-tracer.md +53 -0
  48. package/workflow/core/capabilities/data-change-safety-checker.md +52 -0
  49. package/workflow/core/capabilities/definition-lint.md +81 -0
  50. package/workflow/core/capabilities/deployment-readiness-checker.md +57 -0
  51. package/workflow/core/capabilities/impact-scope-analyzer.md +50 -0
  52. package/workflow/core/capabilities/knowledge-capture-maintainer.md +32 -0
  53. package/workflow/core/capabilities/market-evidence-grader.md +33 -0
  54. package/workflow/core/capabilities/memory-curator.md +48 -0
  55. package/workflow/core/capabilities/personal-git-operator.md +41 -0
  56. package/workflow/core/capabilities/personal-release-checklist.md +49 -0
  57. package/workflow/core/capabilities/prd-code-diff-checker.md +53 -0
  58. package/workflow/core/capabilities/protocol-state-machine-checker.md +57 -0
  59. package/workflow/core/capabilities/release-safety-checker.md +61 -0
  60. package/workflow/core/capabilities/repo-baseline-scanner.md +48 -0
  61. package/workflow/core/capabilities/rule-extractor.md +48 -0
  62. package/workflow/core/capabilities/runtime-evidence-triage.md +53 -0
  63. package/workflow/core/capabilities/security-reviewer.md +48 -0
  64. package/workflow/core/capabilities/test-evidence-reviewer.md +50 -0
  65. package/workflow/core/capabilities/ui-baseline-reviewer.md +50 -0
  66. package/workflow/core/capabilities/verify-app.md +51 -0
  67. package/workflow/core/capabilities/worktree-isolator.md +53 -0
  68. package/workflow/core/commands/01-/351/234/200/346/261/202/350/256/250/350/256/272.md +36 -0
  69. package/workflow/core/commands/02-/344/272/247/345/223/201/346/226/207/346/241/243.md +35 -0
  70. package/workflow/core/commands/02B-UI/350/256/276/350/256/241.md +75 -0
  71. package/workflow/core/commands/03-06-/347/240/224/345/217/221/345/207/206/345/244/207.md +30 -0
  72. package/workflow/core/commands/03-/346/212/200/346/234/257/346/236/266/346/236/204.md +32 -0
  73. package/workflow/core/commands/04-/344/273/243/347/240/201/345/256/236/347/216/260.md +32 -0
  74. package/workflow/core/commands/04A-/345/211/215/347/253/257/344/273/243/347/240/201/345/256/236/347/216/260.md +36 -0
  75. package/workflow/core/commands/04B-/345/220/216/347/253/257/344/273/243/347/240/201/345/256/236/347/216/260.md +31 -0
  76. package/workflow/core/commands/05-/344/273/243/347/240/201/345/256/241/346/237/245.md +31 -0
  77. package/workflow/core/commands/06-/346/265/213/350/257/225/347/224/250/344/276/213.md +34 -0
  78. package/workflow/core/commands/07-/346/265/213/350/257/225/346/211/247/350/241/214.md +33 -0
  79. package/workflow/core/commands/08-/345/217/221/345/270/203/345/207/206/345/244/207.md +44 -0
  80. package/workflow/core/commands/09-/345/217/221/345/270/203/346/211/247/350/241/214.md +39 -0
  81. package/workflow/core/commands/10-/345/244/215/347/233/230/346/200/273/347/273/223.md +41 -0
  82. package/workflow/core/commands/B1-B8-/345/225/206/344/270/232/345/214/226/345/207/206/345/244/207.md +30 -0
  83. package/workflow/core/commands/B1-/344/270/232/345/212/241/345/256/232/344/275/215.md +38 -0
  84. package/workflow/core/commands/B2-/345/225/206/344/270/232/346/250/241/345/274/217.md +38 -0
  85. package/workflow/core/commands/B3-PMF/344/270/216/345/256/242/346/210/267/347/224/273/345/203/217.md +39 -0
  86. package/workflow/core/commands/B4-/345/234/272/346/231/257/344/270/216/350/264/255/344/271/260/346/227/205/347/250/213.md +37 -0
  87. package/workflow/core/commands/B5-/346/270/240/351/201/223/346/274/217/346/226/227/346/230/240/345/260/204.md +39 -0
  88. package/workflow/core/commands/B6-/350/220/245/351/224/200/350/216/267/345/256/242/347/255/226/347/225/245.md +38 -0
  89. package/workflow/core/commands/B7-/350/220/245/351/224/200/351/242/204/347/256/227.md +36 -0
  90. package/workflow/core/commands/B8-/346/270/240/351/201/223/346/211/247/350/241/214/347/255/226/347/225/245.md +39 -0
  91. package/workflow/core/commands/B9-/347/255/226/347/225/245/345/244/215/347/233/230.md +38 -0
  92. package/workflow/core/commands/README.md +56 -0
  93. package/workflow/core/commands/init-workspace.md +29 -0
  94. package/workflow/core/commands/new-feature.md +33 -0
  95. package/workflow/core/commands/new-product.md +28 -0
  96. package/workflow/core/commands/workflow-status.md +30 -0
  97. package/workflow/core/commands//344/270/200/350/207/264/346/200/247/346/243/200/346/237/245.md +35 -0
  98. package/workflow/core/commands//344/272/244/344/273/230/350/207/263/345/256/214/346/210/220.md +40 -0
  99. package/workflow/core/commands//345/256/232/344/271/211/345/256/214/346/210/220.md +41 -0
  100. package/workflow/core/commands//346/276/204/346/270/205.md +31 -0
  101. package/workflow/core/templates/00-business-status.md +43 -0
  102. package/workflow/core/templates/00-workflow-status.md +50 -0
  103. package/workflow/core/templates/README.md +12 -0
  104. package/workflow/core/templates/business-stage-document.md +49 -0
  105. package/workflow/core/templates/completion-contract.md +114 -0
  106. package/workflow/core/templates/constitution.template.md +50 -0
  107. package/workflow/core/templates/living-spec.md +35 -0
  108. package/workflow/core/templates/stage-document.md +42 -0
  109. package/workflow/core/templates/team-profile.template.yaml +104 -0
@@ -0,0 +1,32 @@
1
+ # /03-技术架构
2
+
3
+ ## Goal
4
+
5
+ 技术架构: 识别项目族、影响仓库、调用链、分支基线和实现准入风险。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Previous stage documents under workspace-level `features/{feature}/`
12
+ - Local code, local docs, and user-provided source materials listed in team-profile
13
+
14
+ ## Execution Rules
15
+
16
+ - Read local facts before writing conclusions.
17
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
18
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
19
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
20
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
21
+ - This stage does not authorize business code changes unless the current command is an implementation command and all gates pass.
22
+
23
+
24
+
25
+ ## Required Outputs
26
+
27
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
28
+ - Update workspace-level `features/{feature}/00-工作流状态.md` when stage status changes.
29
+ - Record unresolved questions and evidence gaps explicitly.
30
+ - For implementation-track work, record the intended CI/CD automation level, required CI checks, deployment target, secret boundary, and rollback assumption.
31
+ - 产出**数据流与状态机草案**:数据来源/去向/唯一真相源、关键实体状态机与不变量,供 `/定义完成` 编译进完成合同。
32
+ - 从既有代码库提取本需求适用的规范(命名、目录、错误处理、依赖选型等模式),沉淀或更新到 `workflow/standards/`;已有规范直接引用,不重复发明。
@@ -0,0 +1,32 @@
1
+ # /04-代码实现
2
+
3
+ ## Goal
4
+
5
+ 代码实现总览: 在准入通过后记录后端、前端、配置、数据和发布影响的真实改动。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Previous stage documents under workspace-level `features/{feature}/`
12
+ - Local code, local docs, and user-provided source materials listed in team-profile
13
+
14
+ ## Execution Rules
15
+
16
+ - Read local facts before writing conclusions.
17
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
18
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
19
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
20
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
21
+ - Code changes are allowed only after the feature branch gate, implementation stage gate, and same-repo parallel gate all pass.
22
+ - **完成合同闸门**:M/L 档需求必须存在已冻结且 Definition Lint 通过的 `features/{feature}/00-完成合同.md`;S 档必须有 ★ 必填节完整的迷你合同。合同缺失或未冻结时,先运行 `/定义完成`。
23
+ - 实现只能在合同影响边界内进行;发现必须越界时停下上报,不得静默扩权。合同 Oracle 覆盖的代码变更后,对应 PASS 项置 STALE(见 `workflow/core/capabilities/acceptance-oracle-tracker.md`)。
24
+ - 遵循 `workflow/constitution.md` 与 `workflow/standards/`;与宪法冲突的实现路径必须先走宪法修订,不得先斩后奏。
25
+
26
+
27
+
28
+ ## Required Outputs
29
+
30
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
31
+ - Update workspace-level `features/{feature}/00-工作流状态.md` when stage status changes.
32
+ - Record unresolved questions and evidence gaps explicitly.
@@ -0,0 +1,36 @@
1
+ # /04A-前端代码实现
2
+
3
+ ## Goal
4
+
5
+ 前端代码实现: 记录页面、组件、接口、状态、回显和前端验证。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Previous stage documents under workspace-level `features/{feature}/`
12
+ - Workspace-level `features/{feature}/02B-UI设计.md`
13
+ - Local code, local docs, and user-provided source materials listed in team-profile
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
19
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
20
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
21
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
22
+ - Code changes are allowed only after the feature branch gate, implementation stage gate, and same-repo parallel gate all pass.
23
+ - **完成合同闸门**:M/L 档需求必须存在已冻结且 Definition Lint 通过的 `features/{feature}/00-完成合同.md`;S 档必须有 ★ 必填节完整的迷你合同。合同 Oracle 覆盖的代码变更后,对应 PASS 项置 STALE。
24
+ - 遵循 `workflow/constitution.md` 与 `workflow/standards/`;实现保持在合同影响边界内,越界先上报。
25
+ - Frontend implementation must follow `features/{feature}/02B-UI设计.md`: information architecture, user flows, screen inventory, component specs, design tokens, platform adaptation, accessibility, localization, and visual QA requirements.
26
+ - If `02B-UI设计.md` is missing or does not cover the UI surface being implemented, stop implementation and complete `/02B-UI设计` first unless the user explicitly grants a scoped design waiver.
27
+ - Record every intentional deviation from `02B-UI设计.md` with reason, affected UI surface, risk, and follow-up owner.
28
+ - UI verification should include screenshots or equivalent visual evidence for the device/viewport/state matrix defined in `02B-UI设计.md` whenever a runnable app or prototype exists.
29
+
30
+
31
+
32
+ ## Required Outputs
33
+
34
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
35
+ - Update workspace-level `features/{feature}/00-工作流状态.md` when stage status changes.
36
+ - Record unresolved questions and evidence gaps explicitly.
@@ -0,0 +1,31 @@
1
+ # /04B-后端代码实现
2
+
3
+ ## Goal
4
+
5
+ 后端代码实现: 记录接口、服务、数据、事务、消息、配置和后端验证。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Previous stage documents under workspace-level `features/{feature}/`
12
+ - Local code, local docs, and user-provided source materials listed in team-profile
13
+
14
+ ## Execution Rules
15
+
16
+ - Read local facts before writing conclusions.
17
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
18
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
19
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
20
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
21
+ - Code changes are allowed only after the feature branch gate, implementation stage gate, and same-repo parallel gate all pass.
22
+ - **完成合同闸门**:M/L 档需求必须存在已冻结且 Definition Lint 通过的 `features/{feature}/00-完成合同.md`;S 档必须有 ★ 必填节完整的迷你合同。合同 Oracle 覆盖的代码变更后,对应 PASS 项置 STALE。
23
+ - 遵循 `workflow/constitution.md` 与 `workflow/standards/`;实现保持在合同影响边界内,越界先上报。
24
+
25
+
26
+
27
+ ## Required Outputs
28
+
29
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
30
+ - Update workspace-level `features/{feature}/00-工作流状态.md` when stage status changes.
31
+ - Record unresolved questions and evidence gaps explicitly.
@@ -0,0 +1,31 @@
1
+ # /05-代码审查
2
+
3
+ ## Goal
4
+
5
+ 代码审查: 以问题优先方式审查真实 diff、发布边界、PRD 一致性和残余风险。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Previous stage documents under workspace-level `features/{feature}/`
12
+ - Local code, local docs, and user-provided source materials listed in team-profile
13
+
14
+ ## Execution Rules
15
+
16
+ - Read local facts before writing conclusions.
17
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
18
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
19
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
20
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
21
+ - This stage does not authorize business code changes unless the current command is an implementation command and all gates pass.
22
+
23
+ - Findings lead the output. Order issues by severity and cite files, diffs, tests, or runtime evidence.
24
+ - 以 `features/{feature}/00-完成合同.md` 为审查基准:diff 是否越出影响边界(范围漂移)、是否触碰禁止清单、是否与 `workflow/constitution.md` 和 `workflow/standards/` 冲突、Oracle 覆盖的行为是否被实现真实满足。
25
+ - 检查是否存在"改标准换通过":测试阈值、Oracle 判定、blocking 标记的任何变更都必须有合同修订记录,否则按高危问题上报。
26
+
27
+ ## Required Outputs
28
+
29
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
30
+ - Update workspace-level `features/{feature}/00-工作流状态.md` when stage status changes.
31
+ - Record unresolved questions and evidence gaps explicitly.
@@ -0,0 +1,34 @@
1
+ # /06-测试用例
2
+
3
+ ## Goal
4
+
5
+ 测试用例: 以风险驱动方式输出正常流、异常流、边界流、权限和回归覆盖矩阵,每条用例可直接绑定为完成合同的验收 Oracle。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - `workflow/constitution.md`(质量与测试底线)
12
+ - Previous stage documents under workspace-level `features/{feature}/`(含 01/02/02B/03 与合同草稿)
13
+ - Workspace-level `specs/` 现有行为基线(回归范围来源)
14
+ - Local code, local docs, and user-provided source materials listed in team-profile
15
+
16
+ ## Execution Rules
17
+
18
+ - Read local facts before writing conclusions.
19
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
20
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
21
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
22
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
23
+ - This stage does not authorize business code changes unless the current command is an implementation command and all gates pass.
24
+ - **风险驱动**:按「出错概率 × 出错代价」给用例分配深度——高风险路径(动钱、动数据、动对外契约、不可逆操作)要求边界与并发用例齐全;低风险路径允许仅做冒烟覆盖,并显式记录"浅覆盖+理由"。不做平均主义覆盖。
25
+ - **Oracle-ready**:每条用例必须绑定可复现验证方法(命令/脚本/测试名,或带步骤与判定标准的人工检查),能自动化的优先自动化;用例编写后标注哪些应提升为完成合同的 blocking Oracle。
26
+ - 断言必须落在可观察行为与数字上(EARS 或 Given/When/Then 句式),禁止"功能正常""表现良好"式断言。
27
+ - 回归范围对照 `specs/` 行为清单圈定:本次改动可能影响的已有行为编号必须出现在回归矩阵。
28
+
29
+ ## Required Outputs
30
+
31
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
32
+ - Update workspace-level `features/{feature}/00-工作流状态.md` when stage status changes.
33
+ - 输出风险分级矩阵(用例 × 风险级 × 验证方法 × 是否 Oracle 候选);标注建议进入合同的 blocking Oracle 清单。
34
+ - Record unresolved questions and evidence gaps explicitly.
@@ -0,0 +1,33 @@
1
+ # /07-测试执行
2
+
3
+ ## Goal
4
+
5
+ 测试执行: 记录真实执行结果、证据、阻塞、缺陷和发布候选差异核查。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Previous stage documents under workspace-level `features/{feature}/`
12
+ - Local code, local docs, and user-provided source materials listed in team-profile
13
+
14
+ ## Execution Rules
15
+
16
+ - Read local facts before writing conclusions.
17
+ - Distinguish verified facts, design intent, assumptions, and missing evidence.
18
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
19
+ - Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
20
+ - Local branch creation, commit, tag, and local merge may be executed by the agent for personal projects after scope and working-tree checks. Remote Git refresh, push, release, deployment, database write, and production config write require explicit user authorization.
21
+ - This stage does not authorize business code changes unless the current command is an implementation command and all gates pass.
22
+
23
+
24
+
25
+ - **Oracle 状态流转**:本阶段是(除 `/交付至完成` 外)唯一有权翻转完成合同 Oracle 状态的命令。只能翻转状态并附证据(命令、输出、退出码、commit、截图路径),不得修改标准、阈值或 blocking 标记;PASS 后相关代码再变更的 Oracle 置 STALE 并复验;WAIVED 仅可记录用户书面确认。详见 `workflow/core/capabilities/acceptance-oracle-tracker.md`。
26
+
27
+ ## Required Outputs
28
+
29
+ - Update or create the corresponding file under workspace-level `features/{feature}/`.
30
+ - 同步更新 `features/{feature}/00-完成合同.md` 的 Oracle 状态表(状态、证据、更新时间)。
31
+ - Update workspace-level `features/{feature}/00-工作流状态.md`(Oracle 汇总:blocking x/y PASS)。
32
+ - Record unresolved questions and evidence gaps explicitly.
33
+ - Record the exact CI/local commands that passed or failed, the commit they ran against, and whether the evidence is sufficient for `main` testing and `prod` release promotion.
@@ -0,0 +1,44 @@
1
+ # /08-发布准备
2
+
3
+ ## Goal
4
+
5
+ 发布准备: 完成个人项目的本地集成、版本号、tag、发布清单、回滚点和渠道材料。不执行远程发布动作,除非用户在本阶段明确授权。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `features/{feature}/` 下的 01 到 07 阶段文档
12
+ - 目标仓库当前 Git 状态、测试结果、构建结果和发布渠道要求
13
+ - 商业化基线(如存在):workspace-level `business/{product}/B5-渠道漏斗映射.md`、`B8-渠道执行策略.md`
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - Distinguish verified facts, assumptions, and missing evidence.
19
+ - 默认使用简体中文展示阶段产物;专有名词、命令、路径、分支名、API、SDK、框架和官方英文术语保留原文。
20
+ - Agent may create or rename local personal-project branches, create local commits, create local tags, and perform local merges when the target repo is personal, the working tree is clean or deliberately staged, and the action matches the recorded scope.
21
+ - Remote push, GitHub release, npm publish, App Store / Chrome Web Store / Edge Add-ons submission, Vercel / Cloudflare / server deployment, database writes, and production config writes require explicit user authorization.
22
+ - Use `prod` as the production branch and `main` as the integration/testing branch unless `team-profile.yaml` overrides it.
23
+ - Do not create a separate `test` branch for personal projects.
24
+ - For browser extensions, CLI tools, desktop apps, and mobile apps, record the package artifact, version number, store/channel checklist, and rollback point.
25
+ - 若工作区存在 `business/{product}/` 商业化基线:渠道材料清单对照 B5/B8 的渠道计划准备(landing 页更新、SEO 元数据、商店文案、发布帖草稿、邮件通知草稿);商业化基线缺失时记录缺口,不阻塞发布。
26
+ - **发布准入闸门**:完成合同的 blocking Oracle 必须全部 PASS,或为 WAIVED 且附用户确认记录;存在 NOT_RUN/FAIL/STALE 的 blocking 项时不得进入 `/09-发布执行`,只能记录阻塞。
27
+
28
+ ## Required Outputs
29
+
30
+ - Create or update workspace-level `features/{feature}/08-发布准备.md`.
31
+ - Update workspace-level `features/{feature}/00-工作流状态.md`.
32
+ - Record release candidate commit, source branch, target branch, version/tag plan, test/build evidence, artifact paths, release notes draft, and rollback command.
33
+ - Record any publish-blocking gaps before `/09-发布执行`.
34
+
35
+ ## Suggested Structure
36
+
37
+ 1. **发布范围**:本次发布包含和不包含的功能、修复、文档和配置。
38
+ 2. **本地 Git 状态**:当前分支、基线、diff、未跟踪文件、是否需要 worktree。
39
+ 3. **本地集成计划**:从 `prod` 到开发分支、合并到 `main`、tag、再提升到 `prod` 的步骤。
40
+ 4. **版本与 tag**:版本号、tag 名、tag message、与商店/包版本的对应关系。
41
+ 5. **验证证据**:测试、构建、lint、浏览器检查、截图或人工验证结果。
42
+ 6. **渠道清单**:Web、Chrome/Edge 扩展、CLI、桌面应用、移动应用或其他渠道的发布材料;有商业化基线时对照 B5/B8 补齐发布营销材料(landing、SEO 元数据、商店文案、发布帖与邮件草稿)。
43
+ 7. **回滚点**:可回退的 branch/tag/commit、回滚命令和数据影响。
44
+ 8. **发布执行准入**:哪些条件满足后才能进入 `/09-发布执行`。
@@ -0,0 +1,39 @@
1
+ # /09-发布执行
2
+
3
+ ## Goal
4
+
5
+ 发布执行: 在用户明确授权后执行远程 push、GitHub release、商店/平台发布或部署,并记录真实证据。未获授权时只生成执行清单,不执行远程或生产动作。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `features/{feature}/08-发布准备.md`
12
+ - 用户对远程 push、release、部署或商店提交的明确授权
13
+ - 目标平台登录状态、CLI 状态、发布渠道要求和回滚方案
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - Do not claim a push, release, deployment, store submission, or production config change succeeded unless it was actually executed and verified.
19
+ - Local git operations may be executed for personal projects when scoped; remote and production actions require explicit user authorization in the current task.
20
+ - Before remote publish, verify release candidate commit, branch, tag, test/build evidence, and rollback plan still match `/08-发布准备`.
21
+ - If authorization is missing, stop at a runnable checklist and mark the stage as blocked by authorization.
22
+ - Do not publish secrets, private URLs, personal tokens, ticket IDs, QR codes, or receipt identifiers into public release artifacts.
23
+
24
+ ## Required Outputs
25
+
26
+ - Create or update workspace-level `features/{feature}/09-发布执行.md`.
27
+ - Update workspace-level `features/{feature}/00-工作流状态.md`.
28
+ - Record exact commands executed, command results, remote URLs or release identifiers safe to share, artifact paths, verification evidence, and rollback readiness.
29
+ - Record any failed command, partial publish state, or manual follow-up.
30
+ - 若工作区存在 `business/{product}/B8-渠道执行策略.md`:发布完成后生成本次发布的渠道分发清单(发布帖、邮件、社区、目录站等),逐项标注等待用户授权或自行执行;不自动对外发布。
31
+
32
+ ## Suggested Structure
33
+
34
+ 1. **授权记录**:用户授权的具体范围和禁止事项。
35
+ 2. **执行前核查**:branch、commit、tag、测试、构建、artifact、回滚点。
36
+ 3. **执行记录**:按时间列出真实执行的命令或平台动作。
37
+ 4. **发布验证**:远端分支/tag/release、部署 URL、商店状态或包版本的验证证据。
38
+ 5. **回滚准备**:需要时如何恢复 `prod`、撤回 release、回滚部署或下架 artifact。
39
+ 6. **遗留项**:未完成事项、平台审核等待项、监控或后续响应。
@@ -0,0 +1,41 @@
1
+ # /10-复盘总结
2
+
3
+ ## Goal
4
+
5
+ 复盘总结: 沉淀个人项目级结论、可复用规则、知识库更新和下一轮改进项,让高价值经验不只停留在聊天记录里。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `features/{feature}/` 下的前序阶段文档
12
+ - 发布记录、测试证据、缺陷、用户反馈、运行数据或人工观察
13
+ - 发布后的增长信号(如有):渠道流量、转化、激活与留存数据,workspace-level `business/{product}/B9-策略复盘.md`
14
+ - 可选知识沉淀位置,例如 `llm-wiki-pilot/wiki/`、Obsidian Vault 或项目 README / CHANGELOG
15
+
16
+ ## Execution Rules
17
+
18
+ - Read local facts before writing conclusions.
19
+ - Separate what happened, why it happened, what was learned, and what will change next time.
20
+ - Do not store secrets, private URLs, personal tokens, payment details, ticket IDs, QR codes, or receipt identifiers in retrospective or wiki pages.
21
+ - If updating a long-term wiki, preserve source provenance and update index/log together.
22
+ - Public-facing README, CHANGELOG, release notes, store listing, and privacy policy can live in code repos when they are intentionally public release materials; internal PRD/research/decision notes stay under `features/<feature>/`.
23
+
24
+ ## Required Outputs
25
+
26
+ - Create or update workspace-level `features/{feature}/10-复盘总结.md`.
27
+ - Update workspace-level `features/{feature}/00-工作流状态.md`.
28
+ - **更新 living specs**:把本次已发布的行为增量按 `workflow/core/templates/living-spec.md` 合并进工作区级 `specs/`(新增/修改的行为条目、数据模型、契约与变更历史);未发布或未验证的行为不进 specs。
29
+ - Record reusable rules, process improvements, technical debt, follow-up issues, and knowledge-base updates.
30
+
31
+ ## Suggested Structure
32
+
33
+ 1. **结果摘要**:目标、实际完成、未完成、发布状态。
34
+ 2. **合同对账**:完成合同目标逐条对照实际交付;Oracle 终态表;冻结后修订记录复盘(哪些定义当初没写清、返工代价多大)——这是提升"一次性定义清楚"能力的核心反馈回路。
35
+ 3. **关键证据**:测试、构建、发布、截图、用户反馈或运行数据。
36
+ 4. **有效做法**:可复制到下一次的流程、工具、命令、检查清单。
37
+ 5. **问题与根因**:范围漂移、测试缺口、发布摩擦、设计缺口、自动化缺口。
38
+ 6. **规则更新候选**:可以沉淀到 workflow core、项目 README、wiki、`workflow/constitution.md` 或 `workflow/standards/` 的规则。
39
+ 7. **知识沉淀**:更新了哪些 specs/wiki/README/CHANGELOG/release notes;未更新则说明原因。
40
+ 8. **增长信号回流**:本次发布带来的渠道与转化观察,写明哪些需要进入下一轮 `/B9-策略复盘`;无商业化基线时记录为缺口。
41
+ 9. **下一步**:下一轮 feature、bugfix、重构、监控、发布或商业化事项。
@@ -0,0 +1,30 @@
1
+ # /B1-B8-商业化准备
2
+
3
+ ## Goal
4
+
5
+ 商业化准备编排: 在 `/new-product` 容器初始化后,串联生成 B1 到 B8 的商业化文档,形成从业务定位到渠道执行策略的完整基线;不授权任何对外投放、发布或代码实现。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `business/{product}/00-商业化状态.md`
12
+ - 产品现状材料、市场与竞品资料、用户反馈与数据(按各阶段要求)
13
+
14
+ ## Execution Rules
15
+
16
+ - Read local facts before writing conclusions.
17
+ - 按 B1 → B2 → B3 → B4 → B5 → B6 → B7 → B8 顺序生成,每个阶段遵守其自身契约。
18
+ - 在关键决策点必须停下让用户确认后再继续:定位陈述(B1)、定价假设(B2)、ICP 与负面画像(B3)、主攻渠道(B6)、预算(B7)。
19
+ - 某阶段资料不足时,停在该阶段并记录证据缺口,不虚构填充后继续。
20
+ - 编排完成不等于策略生效:对外动作仍需用户逐项授权,营销工程需求仍需走 `/new-feature` 研发轨。
21
+ - `/B9-策略复盘` 不在编排范围内,按周期单独执行。
22
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
23
+ - 本编排命令只准备 B1 到 B8 文档,不授权修改业务代码。
24
+
25
+ ## Required Outputs
26
+
27
+ - Create or update workspace-level `business/{product}/B1-业务定位.md` 到 `B8-渠道执行策略.md`。
28
+ - Update workspace-level `business/{product}/00-商业化状态.md`。
29
+ - 输出汇总:关键决策记录、待验证假设总表、营销工程需求清单、待授权对外动作清单。
30
+ - Record unresolved questions and evidence gaps explicitly.
@@ -0,0 +1,38 @@
1
+ # /B1-业务定位
2
+
3
+ ## Goal
4
+
5
+ 业务定位: 基于产品与服务盘点、市场调研和竞争对手分析,形成可证伪的定位陈述、细分市场选择和差异化主张。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `business/{product}/00-商业化状态.md`
12
+ - 产品现状材料:README、功能清单、交付形态、已有用户反馈或使用数据
13
+ - 竞品名单或线索、市场资料(公开报告、社区讨论、搜索趋势)
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - 区分一手证据(用户访谈、自有使用数据)、二手证据(公开报告、竞品公开信息、社区讨论)和推断;市场结论必须标注来源和采集日期,不得编造数据、用户评价、竞品价格或市场规模。
19
+ - 竞品分析必须来自可核查来源(官网、定价页、changelog、公开评价、社区讨论),逐条注明采集日期;无法核实的写入待确认项。
20
+ - 市场规模允许量级估算,但必须写出估算方法和输入假设。
21
+ - 定位陈述必须可证伪:说清为谁、解决什么、不为谁、不做什么。
22
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
23
+ - 本阶段只产出分析和文档,不授权修改业务代码,不授权对外动作。
24
+
25
+ ## Required Outputs
26
+
27
+ - Create or update workspace-level `business/{product}/B1-业务定位.md`.
28
+ - Update workspace-level `business/{product}/00-商业化状态.md`.
29
+ - Record unvalidated assumptions and evidence gaps explicitly(喂给 `/B3-PMF与客户画像` 验证)。
30
+
31
+ ## Suggested Structure
32
+
33
+ 1. **产品与服务盘点**:当前能力、可收费交付物、产品形态(CLI/SaaS/插件/模板/内容/服务)、技术依赖与约束。
34
+ 2. **市场调研**:目标市场与细分、目标用户聚集地(社区/平台/线下场景)、趋势信号、现有解决方式(包括"手动解决、不用工具")。
35
+ 3. **竞争对手分析**:直接竞品 / 间接竞品 / 替代方案矩阵——定价、目标用户、主要渠道、优势、弱点、用户公开抱怨点(来源+日期)。
36
+ 4. **定位陈述**:For [目标细分] who [痛点/任务],[产品] 是一个 [品类],提供 [核心收益];unlike [主要替代方案],它 [差异化]。
37
+ 5. **细分选择与放弃**:主攻细分、暂缓细分、明确不做的细分及理由。
38
+ 6. **证据分级与待验证假设**:一手/二手/推断清单,按风险排序。
@@ -0,0 +1,38 @@
1
+ # /B2-商业模式
2
+
3
+ ## Goal
4
+
5
+ 商业模式: 梳理价值主张、收入模式与定价假设、成本结构、单位经济和关键假设,形成个人开发者可维护的精益画布。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `business/{product}/B1-业务定位.md`
12
+ - 成本事实:基础设施、第三方 API、支付通道费率、必要工具订阅
13
+ - 竞品定价对照(B1 已采集)、已有收入或转化数据(如有)
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - 单位经济必须使用真实成本数字;拿不到真实数字时使用明确标注的假设值,不得把假设写成事实。
19
+ - 定价假设必须给出竞品锚点对照和选择理由。
20
+ - 关键假设按"证伪代价 × 不确定性"排序,并标注验证方式(喂给 `/B3-PMF与客户画像`)。
21
+ - 区分一手证据、二手证据和推断;数据标注来源和日期。
22
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
23
+ - 本阶段只产出分析和文档,不授权修改业务代码,不授权改动线上定价或支付配置。
24
+
25
+ ## Required Outputs
26
+
27
+ - Create or update workspace-level `business/{product}/B2-商业模式.md`.
28
+ - Update workspace-level `business/{product}/00-商业化状态.md`.
29
+ - Record unvalidated assumptions and evidence gaps explicitly.
30
+
31
+ ## Suggested Structure
32
+
33
+ 1. **精益画布**:问题 / 客户细分 / 独特价值主张 / 解决方案 / 渠道 / 收入流 / 成本结构 / 关键指标 / 门槛优势(个人开发者常见护城河:迭代速度、细分聚焦、分发位、社区信任)。
34
+ 2. **收入模式选择**:一次性买断 / 订阅 / 用量计费 / 免费+付费层 / 赞助 / 服务化,以及与产品形态和 ICP 付费习惯的匹配理由。
35
+ 3. **定价假设**:免费层边界、付费触发点、价格档位与锚点、月付/年付策略、退款政策。
36
+ 4. **成本结构与单位经济**:固定成本、边际成本、支付手续费、目标毛利;由毛利与预期 LTV 推导 CAC 上限。
37
+ 5. **关键指标**:北极星指标 + 漏斗核心指标的定义与统计口径。
38
+ 6. **关键假设清单**:按风险排序,每条标注验证实验和判定标准。
@@ -0,0 +1,39 @@
1
+ # /B3-PMF与客户画像
2
+
3
+ ## Goal
4
+
5
+ PMF 与客户画像: 用定义好的信号验证产品市场匹配度,确定可操作的理想客户画像 ICP 和负面画像。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `business/{product}/B1-业务定位.md`、`B2-商业模式.md`
12
+ - 用户访谈记录、支持对话、公开评论和反馈
13
+ - 使用与留存数据、waitlist / 预售 / landing 转化数据(如有)
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - PMF 判定必须基于事先定义的信号阈值,不得凭感觉宣布达到 PMF;证据不足时明确记录"未验证"。
19
+ - 访谈和调研结论必须注明样本量、招募渠道和时间;小样本结论标注置信限制。
20
+ - ICP 和负面画像都必须可操作:给出识别信号,而不是空泛描述。
21
+ - 未达 PMF 信号前,`/B5-渠道漏斗映射` 到 `/B8-渠道执行策略` 的投放建议保持最小实验档。
22
+ - 区分一手证据、二手证据和推断;不得编造用户反馈。
23
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
24
+ - 本阶段只产出分析和文档,不授权修改业务代码;验证实验涉及的对外动作(发问卷、发帖招募、预售页上线)需要用户明确授权或自行执行。
25
+
26
+ ## Required Outputs
27
+
28
+ - Create or update workspace-level `business/{product}/B3-PMF与客户画像.md`.
29
+ - Update workspace-level `business/{product}/00-商业化状态.md`(含 PMF 判定结论)。
30
+ - Record unvalidated assumptions and evidence gaps explicitly.
31
+
32
+ ## Suggested Structure
33
+
34
+ 1. **PMF 信号定义**:留存曲线是否走平、Sean Ellis "非常失望"占比(参考阈值 40%)、付费转化率、自然增长与口碑推荐占比;早期可用替代信号(访谈复购意愿、waitlist 转化、预售定金)。
35
+ 2. **验证实验**:问题访谈、landing 冒烟测试、预售、MVP 留存测量——每个实验记录假设、样本、判定标准、真实结果。
36
+ 3. **当前判定**:未验证 / 弱信号 / 达标,附证据列表和下一步验证计划。
37
+ 4. **理想客户画像 ICP**:角色与场景、触发事件、预算与付费能力、技术水平、聚集渠道、识别信号、优先级排序。
38
+ 5. **负面画像**:明确不服务的对象、原因(支持成本高 / 需求偏离路线图 / 流失快 / 价格错配)、识别信号、礼貌拒绝与引导话术。
39
+ 6. **对研发轨的影响**:ICP 修正带来的需求优先级调整建议,回流 `/01-需求讨论` 和 `/02-产品文档`。
@@ -0,0 +1,37 @@
1
+ # /B4-场景与购买旅程
2
+
3
+ ## Goal
4
+
5
+ 场景与购买旅程: 用 JTBD 口径深挖客户使用场景,并画出从认知到推荐的付费购买旅程、异议清单和流失点。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `business/{product}/B1-业务定位.md`、`B3-PMF与客户画像.md`
12
+ - 访谈记录、支持对话、产品使用路径数据
13
+ - 竞品公开评价中的场景与异议线索
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - 每个场景按"触发事件 → 要完成的任务 → 现有替代 → 摩擦 → 期望结果"描述,不写成功能清单。
19
+ - 旅程每一步必须对应可观察的用户行为和可准备的材料,避免只写心理描写。
20
+ - 异议必须来自真实听到或看到的表述并注明出处;推测的异议单独标注为假设。
21
+ - 区分一手证据、二手证据和推断;数据标注来源和日期。
22
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
23
+ - 本阶段只产出分析和文档,不授权修改业务代码,不授权对外动作。
24
+
25
+ ## Required Outputs
26
+
27
+ - Create or update workspace-level `business/{product}/B4-场景与购买旅程.md`.
28
+ - Update workspace-level `business/{product}/00-商业化状态.md`.
29
+ - Record unvalidated assumptions and evidence gaps explicitly.
30
+
31
+ ## Suggested Structure
32
+
33
+ 1. **场景清单(JTBD)**:每个场景记录触发事件、要完成的任务、现有替代方案、摩擦点、期望结果、出现频率。
34
+ 2. **场景优先级**:按 频率 × 痛感 × 付费意愿 打分,选出主攻场景和暂缓场景。
35
+ 3. **购买旅程表**:认知 → 考虑 → 试用 → 付费 → 留存 → 推荐;每步记录用户行为与关注点、接触点、需要的证据材料(内容 / demo / 对比页 / 案例)、常见异议与应对、流失原因。
36
+ 4. **付费触发与阻力**:谁掏钱、价格敏感度、付款方式偏好(月付/年付/买断)、退款与发票等交易摩擦。
37
+ 5. **材料缺口清单**:旅程各步缺失的内容、页面和产品钩子,喂给 `/B8-渠道执行策略` 与研发轨。
@@ -0,0 +1,39 @@
1
+ # /B5-渠道漏斗映射
2
+
3
+ ## Goal
4
+
5
+ 渠道漏斗映射: 明确线下与线上各候选渠道在转化漏斗中的位置、作用、金钱与时间成本、见效周期和 ICP 匹配度。
6
+
7
+ ## Required Inputs
8
+
9
+ - `AGENTS.md`
10
+ - `workflow/team-profile.yaml`
11
+ - Workspace-level `business/{product}/B3-PMF与客户画像.md`(ICP 聚集渠道)、`B4-场景与购买旅程.md`
12
+ - 已有渠道数据(如有)
13
+ - `business/{product}/B7-营销预算.md`(如已存在,作为约束)
14
+
15
+ ## Execution Rules
16
+
17
+ - Read local facts before writing conclusions.
18
+ - 先定义漏斗层口径,再做渠道映射;不同产品可以简化漏斗层,但必须显式写出。
19
+ - 每个候选渠道必须回答"ICP 真的在这里吗",并给出证据或标注为待验证。
20
+ - 个人开发者同时主攻渠道数默认不超过 2-3 个;超出必须写明理由,避免时间预算被摊薄。
21
+ - 区分一手证据、二手证据和推断;渠道成本与效果数据标注来源和日期,不得编造。
22
+ - 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
23
+ - 本阶段只产出分析和文档,不授权修改业务代码,不授权任何投放或发布动作。
24
+
25
+ ## Required Outputs
26
+
27
+ - Create or update workspace-level `business/{product}/B5-渠道漏斗映射.md`.
28
+ - Update workspace-level `business/{product}/00-商业化状态.md`.
29
+ - Record unvalidated assumptions and evidence gaps explicitly.
30
+
31
+ ## Suggested Structure
32
+
33
+ 1. **漏斗定义**:认知 Awareness → 获取 Acquisition → 激活 Activation → 付费 Revenue → 留存 Retention → 推荐 Referral;按产品实际情况简化并写明口径。
34
+ 2. **渠道清单与评估**:
35
+ - offline: events / conferences、local meetups、hackathons、线下工作坊等。
36
+ - online: paid ads、SEO、cold outreach、influencer marketing、social media、email marketing、partnership、开发者社区、应用与插件市场、目录站、开源仓库分发等。
37
+ - 每个渠道记录:漏斗位置、作用(拉新 / 养育 / 转化 / 留存 / 召回)、金钱成本、时间成本、见效周期、可扩展性、ICP 匹配证据、平台规则风险。
38
+ 3. **渠道-漏斗矩阵**:一张表看清每个漏斗层由哪些渠道负责,标出没有渠道覆盖的层。
39
+ 4. **主攻候选与放弃清单**:进入 `/B6-营销获客策略` 决策的候选渠道、明确暂不做的渠道及理由。