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.
- package/CHANGELOG.md +21 -0
- package/CODE_OF_CONDUCT.md +25 -0
- package/CONTRIBUTING.md +51 -0
- package/INIT.md +81 -0
- package/LICENSE +201 -0
- package/NOTICE +6 -0
- package/README.md +195 -0
- package/SECURITY.md +39 -0
- package/bin/check-contract.cjs +137 -0
- package/bin/check-sanitized.cjs +93 -0
- package/bin/init-workspace.cjs +966 -0
- package/docs/assets/PROVENANCE.md +20 -0
- package/docs/assets/architecture.svg +112 -0
- package/docs/assets/hero.svg +83 -0
- package/docs/assets/quick-demo.svg +74 -0
- package/docs/assets/social-preview.svg +57 -0
- package/docs/assets/visual-manifest.json +52 -0
- package/docs/definition-of-done.md +80 -0
- package/docs/dual-track-workflow.md +90 -0
- package/docs/local-merge-notes.md +21 -0
- package/docs/maintainer-handoff.md +150 -0
- package/docs/manual-publish.md +119 -0
- package/docs/private-denylist.example.txt +11 -0
- package/docs/publication-decisions.md +36 -0
- package/docs/release-checklist.md +72 -0
- package/docs/releases/v0.1.0.md +70 -0
- package/docs/shareable-install.md +51 -0
- package/docs/tool-install-recipes.md +103 -0
- package/examples/ecommerce/team-profile.example.yaml +141 -0
- package/examples/education/team-profile.example.yaml +143 -0
- package/examples/saas-to-b/team-profile.example.yaml +130 -0
- package/examples/team-profile.example.yaml +69 -0
- package/install.sh +27 -0
- package/package.json +65 -0
- package/scripts/build-release.cjs +141 -0
- package/scripts/release-source-state.cjs +38 -0
- package/templates/AGENTS.template.md +26 -0
- package/test/release-readiness.cjs +214 -0
- package/test/smoke.cjs +272 -0
- package/workflow/adapters/README.md +16 -0
- package/workflow/core/README.md +38 -0
- package/workflow/core/capabilities/README.md +61 -0
- package/workflow/core/capabilities/acceptance-oracle-tracker.md +45 -0
- package/workflow/core/capabilities/branch-gatekeeper.md +57 -0
- package/workflow/core/capabilities/channel-experiment-tracker.md +32 -0
- package/workflow/core/capabilities/ci-cd-automation-governor.md +123 -0
- package/workflow/core/capabilities/contract-tracer.md +53 -0
- package/workflow/core/capabilities/data-change-safety-checker.md +52 -0
- package/workflow/core/capabilities/definition-lint.md +81 -0
- package/workflow/core/capabilities/deployment-readiness-checker.md +57 -0
- package/workflow/core/capabilities/impact-scope-analyzer.md +50 -0
- package/workflow/core/capabilities/knowledge-capture-maintainer.md +32 -0
- package/workflow/core/capabilities/market-evidence-grader.md +33 -0
- package/workflow/core/capabilities/memory-curator.md +48 -0
- package/workflow/core/capabilities/personal-git-operator.md +41 -0
- package/workflow/core/capabilities/personal-release-checklist.md +49 -0
- package/workflow/core/capabilities/prd-code-diff-checker.md +53 -0
- package/workflow/core/capabilities/protocol-state-machine-checker.md +57 -0
- package/workflow/core/capabilities/release-safety-checker.md +61 -0
- package/workflow/core/capabilities/repo-baseline-scanner.md +48 -0
- package/workflow/core/capabilities/rule-extractor.md +48 -0
- package/workflow/core/capabilities/runtime-evidence-triage.md +53 -0
- package/workflow/core/capabilities/security-reviewer.md +48 -0
- package/workflow/core/capabilities/test-evidence-reviewer.md +50 -0
- package/workflow/core/capabilities/ui-baseline-reviewer.md +50 -0
- package/workflow/core/capabilities/verify-app.md +51 -0
- package/workflow/core/capabilities/worktree-isolator.md +53 -0
- package/workflow/core/commands/01-/351/234/200/346/261/202/350/256/250/350/256/272.md +36 -0
- package/workflow/core/commands/02-/344/272/247/345/223/201/346/226/207/346/241/243.md +35 -0
- package/workflow/core/commands/02B-UI/350/256/276/350/256/241.md +75 -0
- package/workflow/core/commands/03-06-/347/240/224/345/217/221/345/207/206/345/244/207.md +30 -0
- package/workflow/core/commands/03-/346/212/200/346/234/257/346/236/266/346/236/204.md +32 -0
- package/workflow/core/commands/04-/344/273/243/347/240/201/345/256/236/347/216/260.md +32 -0
- 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
- 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
- package/workflow/core/commands/05-/344/273/243/347/240/201/345/256/241/346/237/245.md +31 -0
- package/workflow/core/commands/06-/346/265/213/350/257/225/347/224/250/344/276/213.md +34 -0
- package/workflow/core/commands/07-/346/265/213/350/257/225/346/211/247/350/241/214.md +33 -0
- package/workflow/core/commands/08-/345/217/221/345/270/203/345/207/206/345/244/207.md +44 -0
- package/workflow/core/commands/09-/345/217/221/345/270/203/346/211/247/350/241/214.md +39 -0
- package/workflow/core/commands/10-/345/244/215/347/233/230/346/200/273/347/273/223.md +41 -0
- package/workflow/core/commands/B1-B8-/345/225/206/344/270/232/345/214/226/345/207/206/345/244/207.md +30 -0
- package/workflow/core/commands/B1-/344/270/232/345/212/241/345/256/232/344/275/215.md +38 -0
- package/workflow/core/commands/B2-/345/225/206/344/270/232/346/250/241/345/274/217.md +38 -0
- package/workflow/core/commands/B3-PMF/344/270/216/345/256/242/346/210/267/347/224/273/345/203/217.md +39 -0
- 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
- 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
- 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
- package/workflow/core/commands/B7-/350/220/245/351/224/200/351/242/204/347/256/227.md +36 -0
- 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
- package/workflow/core/commands/B9-/347/255/226/347/225/245/345/244/215/347/233/230.md +38 -0
- package/workflow/core/commands/README.md +56 -0
- package/workflow/core/commands/init-workspace.md +29 -0
- package/workflow/core/commands/new-feature.md +33 -0
- package/workflow/core/commands/new-product.md +28 -0
- package/workflow/core/commands/workflow-status.md +30 -0
- package/workflow/core/commands//344/270/200/350/207/264/346/200/247/346/243/200/346/237/245.md +35 -0
- package/workflow/core/commands//344/272/244/344/273/230/350/207/263/345/256/214/346/210/220.md +40 -0
- package/workflow/core/commands//345/256/232/344/271/211/345/256/214/346/210/220.md +41 -0
- package/workflow/core/commands//346/276/204/346/270/205.md +31 -0
- package/workflow/core/templates/00-business-status.md +43 -0
- package/workflow/core/templates/00-workflow-status.md +50 -0
- package/workflow/core/templates/README.md +12 -0
- package/workflow/core/templates/business-stage-document.md +49 -0
- package/workflow/core/templates/completion-contract.md +114 -0
- package/workflow/core/templates/constitution.template.md +50 -0
- package/workflow/core/templates/living-spec.md +35 -0
- package/workflow/core/templates/stage-document.md +42 -0
- package/workflow/core/templates/team-profile.template.yaml +104 -0
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# /B6-营销获客策略
|
|
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` 到 `B5-渠道漏斗映射.md`
|
|
12
|
+
- `business/{product}/B7-营销预算.md`(如已存在,双向校准)
|
|
13
|
+
|
|
14
|
+
## Execution Rules
|
|
15
|
+
|
|
16
|
+
- Read local facts before writing conclusions.
|
|
17
|
+
- 策略必须先声明当前阶段(验证期 / 首发期 / 增长期),且与 `/B3-PMF与客户画像` 的 PMF 判定一致;未达 PMF 时不制定放大型投放策略。
|
|
18
|
+
- 主攻渠道选择必须引用 `/B5-渠道漏斗映射` 的评估结论,默认 1-2 个主攻 + 1 个实验渠道。
|
|
19
|
+
- 每个策略目标必须有可测指标和期限。
|
|
20
|
+
- 各渠道信息口径必须能追溯到 `/B1-业务定位` 的定位陈述,保持一句话价值主张一致。
|
|
21
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
|
|
22
|
+
- 本阶段只产出策略文档,不授权修改业务代码;发布计划中的对外动作留待 `/B8-渠道执行策略` 生成清单并由用户授权或自行执行。
|
|
23
|
+
|
|
24
|
+
## Required Outputs
|
|
25
|
+
|
|
26
|
+
- Create or update workspace-level `business/{product}/B6-营销获客策略.md`.
|
|
27
|
+
- Update workspace-level `business/{product}/00-商业化状态.md`.
|
|
28
|
+
- Record unvalidated assumptions and evidence gaps explicitly.
|
|
29
|
+
|
|
30
|
+
## Suggested Structure
|
|
31
|
+
|
|
32
|
+
1. **阶段判断**:验证期(找 PMF)/ 首发期(launch)/ 增长期(放大已验证渠道),依据 B3 判定和当前数据。
|
|
33
|
+
2. **目标体系**:北极星指标 + 本周期漏斗目标(例如"90 天内自然注册达到每周 X"),含基线值。
|
|
34
|
+
3. **主攻渠道组合**:主攻渠道、实验渠道、放弃渠道;选择理由引用 B5 评估。
|
|
35
|
+
4. **信息架构**:核心定位语 → 各渠道 message 变体对照表;确保价值主张一句话在所有渠道一致。
|
|
36
|
+
5. **内容支柱与复用链**:3-4 个内容主题;一鱼多吃路径(长文 → 社媒帖 → 短视频/短帖 → 邮件)。
|
|
37
|
+
6. **发布节奏与里程碑**:launch 计划(如 Product Hunt、开发者社区首发、邮件列表)、每周营销例行动作、关键时间点。
|
|
38
|
+
7. **与研发轨联动**:策略需要的产品侧支持(埋点、分享钩子、推荐机制、试用引导),通过 `/new-feature` 进入研发轨。
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# /B7-营销预算
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
营销预算: 确定金钱与时间双预算、各渠道分配与上限、CAC 目标和止损线,让个人开发者的营销投入可控可复盘。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- Workspace-level `business/{product}/B2-商业模式.md`(CAC 上限、毛利)、`B5-渠道漏斗映射.md`(渠道成本)、`B6-营销获客策略.md`
|
|
12
|
+
- 用户提供的可支配现金与时间约束
|
|
13
|
+
|
|
14
|
+
## Execution Rules
|
|
15
|
+
|
|
16
|
+
- Read local facts before writing conclusions.
|
|
17
|
+
- 个人开发者必须同时编制金钱预算和时间预算(每周营销小时数);时间是最稀缺资源,必须显式计入。
|
|
18
|
+
- 每个渠道设月度上限和止损条件;预算超支或单渠道 CAC 连续超标必须触发 `/B9-策略复盘`,不得静默追加预算。
|
|
19
|
+
- 实验渠道预算与已验证渠道预算分开管理,写明比例和调整规则。
|
|
20
|
+
- CAC 目标必须由 `/B2-商业模式` 的单位经济推导,不得凭空设定。
|
|
21
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
|
|
22
|
+
- 本阶段只产出预算文档,不授权任何实际支出、充值或投放动作;实际付费由用户执行。
|
|
23
|
+
|
|
24
|
+
## Required Outputs
|
|
25
|
+
|
|
26
|
+
- Create or update workspace-level `business/{product}/B7-营销预算.md`.
|
|
27
|
+
- Update workspace-level `business/{product}/00-商业化状态.md`.
|
|
28
|
+
- Record unvalidated assumptions and evidence gaps explicitly.
|
|
29
|
+
|
|
30
|
+
## Suggested Structure
|
|
31
|
+
|
|
32
|
+
1. **约束盘点**:每月可投入现金、每周可投入时间、机会成本说明(营销时间挤占的开发时间)。
|
|
33
|
+
2. **双预算表**:渠道 ×(金钱/月、时间/周、预期产出、止损线)。
|
|
34
|
+
3. **CAC 目标**:由 B2 推导的 CAC 上限、各渠道目标 CAC、混合 CAC 目标。
|
|
35
|
+
4. **实验与已验证分配**:实验预算 vs 已验证渠道预算比例(例如 30/70)及调整规则。
|
|
36
|
+
5. **追踪口径**:支出与时间的记录方式和存放位置,作为 `/B9-策略复盘` 的数据输入。
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# /B8-渠道执行策略
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
渠道执行策略: 为 B6 选中的渠道制定可执行 playbook——SEO 关键词与内容日历、各渠道动作节奏与判定标准——并把营销工程需求回流研发轨。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- Workspace-level `business/{product}/B4-场景与购买旅程.md`(材料缺口)、`B5-渠道漏斗映射.md`、`B6-营销获客策略.md`、`B7-营销预算.md`
|
|
12
|
+
- 关键词与流量数据、平台规则文档(如可获取)
|
|
13
|
+
|
|
14
|
+
## Execution Rules
|
|
15
|
+
|
|
16
|
+
- Read local facts before writing conclusions.
|
|
17
|
+
- 只为 `/B6-营销获客策略` 选中的主攻和实验渠道写 playbook,未选中渠道不展开。
|
|
18
|
+
- SEO 结论(关键词选择、页面结构)必须有搜索数据或竞品页面证据支撑;拿不到数据时标注为假设并给出验证方式。
|
|
19
|
+
- cold outreach 和 email marketing 必须遵守目标市场的反垃圾邮件与隐私法规(如 CAN-SPAM、GDPR)及平台规则;联系人名单、受众导出数据保存在本地未跟踪文件,文档中只记录路径,不粘贴名单内容。
|
|
20
|
+
- 广告投放遵守各平台广告政策;每个 playbook 必须包含指标、判定标准和退出条件。
|
|
21
|
+
- 渠道实验按 `workflow/core/capabilities/channel-experiment-tracker.md` 口径登记。
|
|
22
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
|
|
23
|
+
- 本阶段只产出 playbook 和清单,不授权修改业务代码;landing page、博客、埋点等营销工程需求必须通过 `/new-feature` 进入研发轨并遵守其闸门。
|
|
24
|
+
- 所有对外动作——发帖、投放、发送 outreach 邮件、联系 influencer 或合作伙伴、提交目录站——需要用户明确授权或由用户自行执行;本阶段默认只生成待执行清单。
|
|
25
|
+
|
|
26
|
+
## Required Outputs
|
|
27
|
+
|
|
28
|
+
- Create or update workspace-level `business/{product}/B8-渠道执行策略.md`.
|
|
29
|
+
- Update workspace-level `business/{product}/00-商业化状态.md`.
|
|
30
|
+
- 输出营销工程需求清单(回流 `/new-feature`)和待授权对外动作清单。
|
|
31
|
+
- Record unvalidated assumptions and evidence gaps explicitly.
|
|
32
|
+
|
|
33
|
+
## Suggested Structure
|
|
34
|
+
|
|
35
|
+
1. **SEO playbook**:种子词 → 长尾关键词研究(含搜索意图分类)、内容日历、页面级 on-page 清单、技术 SEO 清单(sitemap、结构化数据、性能、移动适配)、外链策略、衡量口径(排名 / 自然流量 / 转化)。
|
|
36
|
+
2. **其他渠道 playbook**(每个 B6 选中渠道一节):目标与漏斗位置、动作节奏(每周做什么)、素材需求、指标与判定标准、退出条件。
|
|
37
|
+
3. **实验设计**:本周期渠道实验清单——假设、预算上限、周期、判定指标、负责记录的位置。
|
|
38
|
+
4. **营销工程需求回流**:landing page、博客/文档站、埋点与分析、A/B 测试、分享机制等,逐项列出并标注对应 `/new-feature` 需求名。
|
|
39
|
+
5. **待授权对外动作清单**:发帖、投放、outreach 批次、目录站提交等,逐项列出等待用户授权或自行执行。
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# /B9-策略复盘
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
策略复盘: 按周期基于真实数据复盘漏斗表现、渠道 ROI 和假设判定,对每个渠道输出加码/保持/降配/砍掉的调整决策,并在重大失配时上溯修订定位与商业模式。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- Workspace-level `business/{product}/B5-渠道漏斗映射.md` 到 `B8-渠道执行策略.md`、渠道实验记录
|
|
12
|
+
- 漏斗与渠道真实数据(流量、转化、支出、时间投入)
|
|
13
|
+
- 上一轮 `B9-策略复盘.md`、相关 `features/{feature}/10-复盘总结.md` 的增长信号(如有)
|
|
14
|
+
|
|
15
|
+
## Execution Rules
|
|
16
|
+
|
|
17
|
+
- Read local facts before writing conclusions.
|
|
18
|
+
- 复盘必须基于真实数据快照;数据缺失时记录采集缺口和补齐方式,不得编造或用印象代替数据。
|
|
19
|
+
- 每个在投渠道必须给出明确处置决策(加码 / 保持 / 降配 / 砍掉)及理由;不允许全部"继续观察"。
|
|
20
|
+
- 常规偏差修订 `/B5` 到 `/B8`;重大失配(ICP 不对、付费假设证伪、定位不成立)必须上溯修订 `/B1`、`/B2` 或 `/B3`,并在状态文件标记。
|
|
21
|
+
- 建议节奏:每周检视指标、每月策略复盘、每季度校准定位;实际节奏写入状态文件。
|
|
22
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
|
|
23
|
+
- 本阶段只产出复盘与调整文档,不授权修改业务代码;调整后的对外动作仍需用户授权或自行执行。
|
|
24
|
+
|
|
25
|
+
## Required Outputs
|
|
26
|
+
|
|
27
|
+
- Create or update workspace-level `business/{product}/B9-策略复盘.md`(按周期追加,保留历史结论)。
|
|
28
|
+
- Update workspace-level `business/{product}/00-商业化状态.md`(含本轮处置决策和下轮复盘时间)。
|
|
29
|
+
- Record data gaps, invalidated assumptions, and upstream revision needs explicitly.
|
|
30
|
+
|
|
31
|
+
## Suggested Structure
|
|
32
|
+
|
|
33
|
+
1. **数据快照**:周期区间、漏斗各层数据、各渠道流量/转化/支出、CAC 与 LTV 实际 vs 目标、时间投入实际 vs 预算。
|
|
34
|
+
2. **假设判定**:本周期验证 / 证伪 / 证据不足的假设清单,引用实验记录。
|
|
35
|
+
3. **渠道处置**:每渠道 加码 / 保持 / 降配 / 砍掉 + 理由 + 生效动作。
|
|
36
|
+
4. **上溯修订**:需要回改的上游文档(B1/B2/B3 或 B5-B8)与具体修订点。
|
|
37
|
+
5. **下一周期计划**:目标、预算调整、实验清单、待授权对外动作。
|
|
38
|
+
6. **经验沉淀**:可复用的渠道经验与教训,喂给 `/10-复盘总结` 和知识库。
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# Core Commands
|
|
2
|
+
|
|
3
|
+
Each command file is a stage contract. Tools may expose slash commands, prompts, rules, or checklists, but every adapter should point back to these core files.
|
|
4
|
+
|
|
5
|
+
默认使用简体中文展示阶段沟通和产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
|
|
6
|
+
|
|
7
|
+
工作流分两条轨道,共享同一套闸门口径:
|
|
8
|
+
|
|
9
|
+
- 研发轨(features):把一个需求从澄清、完成合同冻结推进到实现、发布和复盘,产物在工作区级 `features/{feature}/`。
|
|
10
|
+
- 商业化轨(business):把一个产品从业务定位推进到渠道执行和策略复盘,产物在工作区级 `business/{product}/`。B 阶段只产出文档和清单;对外发布、投放、outreach 需要用户明确授权,营销工程需求通过 `/new-feature` 回流研发轨。
|
|
11
|
+
|
|
12
|
+
研发轨核心机制:`/new-feature` 时按 S/M/L 分级复杂度;`/定义完成` 把 01-06 结论编译成《完成合同》(数据流、失败路径、质量预算、验收 Oracle、术语表、影响边界),通过 Definition Lint 并经用户确认后冻结;**宣布完成 = blocking Oracle 全 PASS 的机器判定**。实现可走手动分阶段(04→05→07),也可用 `/交付至完成` 在合同范围内自主循环到全绿或精确阻塞。`workflow/constitution.md`(原则)、`workflow/standards/`(规范)与工作区级 `specs/`(行为真相)是所有阶段的共享事实源。
|
|
13
|
+
|
|
14
|
+
研发轨 stages:
|
|
15
|
+
|
|
16
|
+
- `/init-workspace`
|
|
17
|
+
- `/new-feature`(含 S/M/L 复杂度分级)
|
|
18
|
+
- `/01-需求讨论`
|
|
19
|
+
- `/澄清`(按需:≤5 问消融歧义,答案写回文档)
|
|
20
|
+
- `/02-产品文档`
|
|
21
|
+
- `/02B-UI设计`(含体验预算)
|
|
22
|
+
- `/03-技术架构`(含数据流/状态机草案与规范提取)
|
|
23
|
+
- `/03-06-研发准备`
|
|
24
|
+
- `/06-测试用例`(风险驱动,Oracle-ready)
|
|
25
|
+
- `/定义完成`(编译并冻结完成合同)
|
|
26
|
+
- `/一致性检查`(实现前只读交叉检查)
|
|
27
|
+
- `/04-代码实现`
|
|
28
|
+
- `/04A-前端代码实现`
|
|
29
|
+
- `/04B-后端代码实现`
|
|
30
|
+
- `/05-代码审查`
|
|
31
|
+
- `/07-测试执行`(翻转 Oracle 状态)
|
|
32
|
+
- `/交付至完成`(可替代手动 04→07:循环至 blocking 全绿)
|
|
33
|
+
- `/08-发布准备`(准入=blocking Oracle 全绿)
|
|
34
|
+
- `/09-发布执行`
|
|
35
|
+
- `/10-复盘总结`(回写 specs 行为基线)
|
|
36
|
+
- `/workflow-status`
|
|
37
|
+
|
|
38
|
+
推荐执行顺序(M/L 档):`/new-feature` → `/01` →(`/澄清`)→ `/02` → `/02B` → `/03` → `/06` → `/定义完成`(冻结)→ `/一致性检查` → `/交付至完成` 或 `/04`→`/05`→`/07` → `/08` → `/09` → `/10`。S 档:`/new-feature` → `/定义完成`(迷你合同)→ 实现 → 验证。
|
|
39
|
+
|
|
40
|
+
商业化轨 stages:
|
|
41
|
+
|
|
42
|
+
- `/new-product`
|
|
43
|
+
- `/B1-业务定位`
|
|
44
|
+
- `/B1-B8-商业化准备`
|
|
45
|
+
- `/B2-商业模式`
|
|
46
|
+
- `/B3-PMF与客户画像`
|
|
47
|
+
- `/B4-场景与购买旅程`
|
|
48
|
+
- `/B5-渠道漏斗映射`
|
|
49
|
+
- `/B6-营销获客策略`
|
|
50
|
+
- `/B7-营销预算`
|
|
51
|
+
- `/B8-渠道执行策略`
|
|
52
|
+
- `/B9-策略复盘`(周期执行)
|
|
53
|
+
|
|
54
|
+
两轨衔接点:`/01`、`/02` 读取 B1/B2/B3/B4 的定位、商业模式、ICP 与场景基线;`/08`、`/09` 对照 B5/B8 准备发布营销材料和分发清单;`/10` 的增长信号回流 `/B9`;B8 的营销工程需求通过 `/new-feature` 进入研发轨。
|
|
55
|
+
|
|
56
|
+
The initializer writes concrete command files into the target workspace.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# /init-workspace
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
初始化工作区: 扫描本地资料、生成 team-profile、缺资料提问,并生成当前工具 adapter。
|
|
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.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# /new-feature
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
初始化功能工作流: 创建工作区级 `features/{feature}/` 容器、状态文件和截图目录,并完成复杂度分级(S/M/L),决定该需求走全流程还是压缩路径。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- `workflow/constitution.md`
|
|
12
|
+
- Workspace-level `specs/` 现有行为基线(判断是否触碰既有行为)
|
|
13
|
+
- 用户对需求的初始描述
|
|
14
|
+
|
|
15
|
+
## Execution Rules
|
|
16
|
+
|
|
17
|
+
- Read local facts before writing conclusions.
|
|
18
|
+
- 创建容器后立即做**复杂度分级**,给出建议档位和理由,经用户确认后写入状态文件:
|
|
19
|
+
- **S 档**(bugfix、文案、单文件小改,不改对外契约、不触碰高风险文件):压缩为三步——`/定义完成`(只填合同 ★ 必填节的迷你合同)→ 实现 → 验证;跳过 02/02B/03/05/06 的独立文档。
|
|
20
|
+
- **M 档**(单仓功能,影响面清晰):标准路径,可按需豁免 02B(无 UI)等单项并记录。
|
|
21
|
+
- **L 档**(跨仓、动数据/契约、触碰高风险文件、新产品首发):全流程,不得豁免闸门阶段。
|
|
22
|
+
- 分级依据:影响仓库数、是否修改对外契约或 `specs/` 已有行为、是否触碰 team-profile `high_risk_files`、预估改动规模、回滚难度。拿不准时就近上调一档。
|
|
23
|
+
- 分级只压缩文档路径,不豁免授权边界:任何档位的远程 push、release、部署、对外动作仍需用户明确授权。
|
|
24
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
|
|
25
|
+
- 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.
|
|
26
|
+
- This stage does not authorize business code changes.
|
|
27
|
+
|
|
28
|
+
## Required Outputs
|
|
29
|
+
|
|
30
|
+
- 创建工作区级 `features/{feature}/` 目录和截图目录。
|
|
31
|
+
- 按 `workflow/core/templates/00-workflow-status.md` 创建 `features/{feature}/00-工作流状态.md`,写入复杂度档位、分级理由和对应路径。
|
|
32
|
+
- 商业化基线存在时登记关联的 `business/{product}/`。
|
|
33
|
+
- Record unresolved questions and evidence gaps explicitly.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# /new-product
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
初始化商业化工作流: 创建工作区级 `business/{product}/` 容器、商业化状态文件和素材目录,作为 B1-B9 商业化阶段的统一落点。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- 产品名称和一句话描述
|
|
12
|
+
- 关联仓库和关联 `features/{feature}/`(如已存在)
|
|
13
|
+
|
|
14
|
+
## Execution Rules
|
|
15
|
+
|
|
16
|
+
- Read local facts before writing conclusions.
|
|
17
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、渠道名、代码标识符、命令、文件路径、API、SDK、框架、协议、标准和官方英文术语保留原文。
|
|
18
|
+
- 容器已存在时不重复创建,只补齐缺失文件并说明现状。
|
|
19
|
+
- 本阶段不授权修改业务代码,也不授权任何对外发布、投放或触达动作。
|
|
20
|
+
- 若 team-profile 中 `business_intro` 或 `market_research` 资料缺失,记录到 `workflow/INITIALIZATION_QUESTIONS.md` 或向用户索要,不虚构填充。
|
|
21
|
+
|
|
22
|
+
## Required Outputs
|
|
23
|
+
|
|
24
|
+
- 创建工作区级 `business/{product}/` 目录。
|
|
25
|
+
- 按 `workflow/core/templates/00-business-status.md` 创建 `business/{product}/00-商业化状态.md`。
|
|
26
|
+
- 创建 `business/{product}/素材/` 目录,存放后续渠道素材和截图。
|
|
27
|
+
- 在状态文件中登记产品一句话描述、关联仓库、关联 features 和北极星指标(未定义则标注待定)。
|
|
28
|
+
- 明确记录缺失资料和待确认项。
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# /workflow-status
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
工作流状态: 汇总 features 下所有需求的阶段状态、阻塞和下一步;工作区存在商业化容器时,一并汇总 business 下各产品的商业化阶段、PMF 判定和下轮复盘时间。
|
|
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 `business/{product}/00-商业化状态.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
|
+
- This stage does not authorize business code changes unless the current command is an implementation command and all gates pass.
|
|
23
|
+
- 汇总必须分别呈现研发轨(features)和商业化轨(business)两张状态表;只统计真实存在的容器,不虚构进度。
|
|
24
|
+
|
|
25
|
+
## Required Outputs
|
|
26
|
+
|
|
27
|
+
- 输出研发轨汇总:每个 feature 的当前阶段、状态、复杂度档位、完成合同状态(草稿/已冻结)、blocking Oracle 进度(x/y PASS)、待澄清项数、阻塞和下一步。
|
|
28
|
+
- 工作区存在 `business/` 时输出商业化轨汇总:每个产品的当前阶段、PMF 判定、待授权对外动作数量和下轮 B9 复盘时间。
|
|
29
|
+
- 标出两轨间待办衔接:待回流研发轨的营销工程需求、待进入 B9 的增长信号。
|
|
30
|
+
- Record unresolved questions and evidence gaps explicitly.
|
package/workflow/core/commands//344/270/200/350/207/264/346/200/247/346/243/200/346/237/245.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# /一致性检查
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
一致性检查: 在进入实现(`/04-代码实现` 或 `/交付至完成`)之前,对同一需求的全部工件做只读交叉检查,逮住"PRD 说 A、架构写 B、测试测 C、合同定 D"式漂移,以及目标与 Oracle 的覆盖缺口。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- `workflow/constitution.md` 与 `workflow/standards/`
|
|
12
|
+
- Workspace-level `features/{feature}/`:`00-完成合同.md`、`01`-`06` 各阶段文档
|
|
13
|
+
- Workspace-level `specs/` 现有行为基线
|
|
14
|
+
- 商业化基线(如存在):`business/{product}/` 相关条目
|
|
15
|
+
|
|
16
|
+
## Execution Rules
|
|
17
|
+
|
|
18
|
+
- **严格只读**:本命令不修改任何被检查的工件,只输出检查报告;修复由用户确认后回到对应阶段命令执行。
|
|
19
|
+
- 检查维度:
|
|
20
|
+
1. 冲突:同一事实在不同文档中的表述互相矛盾(口径、数值、范围、平台)。
|
|
21
|
+
2. 覆盖:合同每条目标 ↔ 至少一条 Oracle;每条 blocking Oracle ↔ 可追溯的需求来源;`02B` 关键页面 ↔ 测试用例。
|
|
22
|
+
3. 漂移:合同影响边界 vs `03-技术架构` 影响仓库清单;PRD 功能清单 vs 合同目标/非目标。
|
|
23
|
+
4. 宪法冲突:任何工件与 `workflow/constitution.md` 原则、`workflow/standards/` 规范的直接冲突(constitution 在本检查范围内不可协商)。
|
|
24
|
+
5. specs 冲突:合同将改变的行为是否与 `specs/` 现状对齐(brownfield 改动必须显式声明改变哪条现有行为)。
|
|
25
|
+
6. 残留歧义:未清零的 `[待澄清]`、未绑定数字的模糊词、占位符「待填写」。
|
|
26
|
+
- 发现项按严重级别排序:BLOCKER(进入实现前必须解决)/ MAJOR(建议解决)/ MINOR(记录即可),每项引用具体文件与原文。
|
|
27
|
+
- 无发现时明确输出"未发现阻塞级不一致",不得为了产出而编造问题。
|
|
28
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、代码标识符、命令、文件路径、API、SDK、框架和官方英文术语保留原文。
|
|
29
|
+
- This stage does not authorize business code changes.
|
|
30
|
+
|
|
31
|
+
## Required Outputs
|
|
32
|
+
|
|
33
|
+
- Create or update workspace-level `features/{feature}/一致性检查.md`:检查范围、发现清单(级别/位置/原文/建议修复动作)、结论。
|
|
34
|
+
- Update workspace-level `features/{feature}/00-工作流状态.md`(一致性结论与阻塞数)。
|
|
35
|
+
- 存在 BLOCKER 时明确建议先修复再实现;修复动作指向对应阶段命令。
|
package/workflow/core/commands//344/272/244/344/273/230/350/207/263/345/256/214/346/210/220.md
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# /交付至完成
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
交付至完成: 在合同冻结且全部闸门通过后,授权 agent 在合同范围内自主循环「实现 → 验证 → 修复 → 复验」,直到全部 blocking Oracle 为 PASS(可宣布完成),或停在一个精确阻塞点。这是"写清完成定义,agent 自己跑到全绿"的执行命令。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- `workflow/constitution.md` 与 `workflow/standards/`
|
|
12
|
+
- Workspace-level `features/{feature}/00-完成合同.md`(状态必须为「已冻结」,Definition Lint 通过)
|
|
13
|
+
- 前序阶段文档与 `specs/` 现有行为基线
|
|
14
|
+
|
|
15
|
+
## 准入闸门(全部通过才可开始)
|
|
16
|
+
|
|
17
|
+
1. 完成合同已冻结且 Lint 通过(S 档:★ 节完整且无待澄清项)。
|
|
18
|
+
2. 功能分支闸门:在从 `prod` 创建的开发分支上,工作树干净或已刻意暂存。
|
|
19
|
+
3. 同仓并行闸门:多需求并行时已使用独立 worktree。
|
|
20
|
+
4. 建议先运行 `/一致性检查`,存在未解决的高危漂移时先修文档再开始。
|
|
21
|
+
|
|
22
|
+
## Execution Rules
|
|
23
|
+
|
|
24
|
+
- 循环语义:每轮 = 实现一个增量 → 运行受影响的 auto Oracle → 修复失败 → 复验;全部 blocking Oracle PASS 后做一次全量复验收尾。
|
|
25
|
+
- **范围铁律**:只修改合同影响边界内允许的部分;发现必须越界才能完成时,停下并作为阻塞上报,不得静默扩权。
|
|
26
|
+
- **标准铁律**:不得修改任何 Oracle 的标准、阈值或 blocking 标记,不得删除测试来换取通过;发现标准本身有问题时,停下并提出合同修订请求(走修订记录+用户确认)。
|
|
27
|
+
- Oracle 状态翻转必须附可复现证据(命令、输出、退出码、截图路径、日志片段);PASS 后相关代码再次变更的 Oracle 置 STALE 并复验。manual Oracle 无法由 agent 独立判定时保持 NOT_RUN 并列入待人工验收清单,不算阻塞失败但计入未全绿。
|
|
28
|
+
- **内建对抗审查**:宣布全绿前,切换审查者视角对完整 diff 做一轮问题优先审查(对照合同影响边界、PRD 一致性、`05-代码审查` 的口径);发现问题回到循环,审查结论写入交付日志。
|
|
29
|
+
- 迭代与止损:同一 Oracle 连续 3 轮修复仍 FAIL,停下并上报精确阻塞(差距、已尝试路径、建议选项),不做无限循环。
|
|
30
|
+
- 授权边界:本命令授权本地代码修改、本地测试构建、本地 commit(范围明确时);**不授权** push、release、部署、数据库写入、生产配置写入或任何对外动作。
|
|
31
|
+
- 精确阻塞的标准格式:缺什么(凭据/决策/环境/信息)、为什么需要、建议的解除路径;不得用"遇到困难"之类模糊表述。
|
|
32
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、代码标识符、命令、文件路径、分支名、API、SDK、框架和官方英文术语保留原文。
|
|
33
|
+
- Do not claim tests, builds, screenshots, deployments, or reviews passed unless they were actually executed.
|
|
34
|
+
|
|
35
|
+
## Required Outputs
|
|
36
|
+
|
|
37
|
+
- Create or update workspace-level `features/{feature}/交付至完成.md`:逐轮记录(改动摘要、运行的 Oracle、状态翻转、证据、审查发现、修复),终态结论(全绿 / 待人工验收清单 / 精确阻塞)。
|
|
38
|
+
- 同步更新 `features/{feature}/00-完成合同.md` 的 Oracle 状态表(含证据与时间)。
|
|
39
|
+
- Update workspace-level `features/{feature}/00-工作流状态.md`:交付模式记为「交付至完成」,`04/05/07` 阶段标注「由交付至完成覆盖」并链接交付日志。
|
|
40
|
+
- 终态为全绿时,输出给用户的验收摘要:合同目标逐条对照、Oracle 全表、待人工验收项、遗留假设。
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# /定义完成
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
定义完成: 把 01-06 阶段的分散结论"编译"成一份可冻结、可机器判定的《完成合同》,通过 Definition Lint 后经用户确认冻结。合同是"什么叫完成"的唯一判定依据,也是 `/交付至完成` 与 `/04-代码实现` 的准入闸门。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- `workflow/constitution.md`(不可协商原则)与 `workflow/standards/`(个人规范)
|
|
12
|
+
- Workspace-level `features/{feature}/` 下已有的 `01`-`06` 阶段文档(S 档至少需要 `01-需求讨论.md` 或等价的用户输入)
|
|
13
|
+
- Workspace-level `specs/` 现有行为基线(brownfield 时必读)
|
|
14
|
+
- 商业化基线(如存在):`business/{product}/B2-商业模式.md`、`B5-渠道漏斗映射.md`
|
|
15
|
+
|
|
16
|
+
## Execution Rules
|
|
17
|
+
|
|
18
|
+
- Read local facts before writing conclusions.
|
|
19
|
+
- 本阶段是**编译**不是**发明**:合同内容必须能追溯到前序文档、specs、constitution 或用户的明确输入;发现前序文档缺失或互相矛盾时先补齐或对齐,不得临场编造填充。
|
|
20
|
+
- 按 `workflow/core/templates/completion-contract.md` 生成 `features/{feature}/00-完成合同.md`;复杂度 S 档只填 ★ 必填节,M/L 档全部填写。
|
|
21
|
+
- 每条目标必须被至少一条 Oracle 覆盖;每条 Oracle 必须绑定可复现验证方法(auto 优先,manual 必须带步骤和判定标准);blocking Oracle 至少一条。
|
|
22
|
+
- 验收标准使用 EARS(WHEN/WHILE/IF…THEN/WHERE + SHALL)或 Given/When/Then 句式;出现模糊词(快、流畅、稳定、好用、优雅、高性能、健壮、无缝、及时、大量)必须绑定数字或可观察行为,否则写入待澄清项。
|
|
23
|
+
- 冻结前必须执行 Definition Lint(按 `workflow/core/capabilities/definition-lint.md` 逐维检查并把结果写入合同 Lint 表);未通过项要么补齐,要么经用户确认后记为豁免并说明风险。
|
|
24
|
+
- 冻结前待澄清项必须清零:逐条解决,或经用户确认降级为「已记录假设」。可先运行 `/澄清` 收敛。
|
|
25
|
+
- 如果 kit 提供了 `bin/check-contract.cjs`,冻结前运行 `node <kit>/bin/check-contract.cjs features/{feature}/00-完成合同.md` 做结构校验并记录结果。
|
|
26
|
+
- **冻结需要用户明确确认**;agent 不得自行冻结合同,也不得在冻结后静默修改标准——修改走「修订记录」并再次经用户确认。
|
|
27
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、产品名、品牌名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
|
|
28
|
+
- This stage does not authorize business code changes.
|
|
29
|
+
|
|
30
|
+
## Required Outputs
|
|
31
|
+
|
|
32
|
+
- Create or update workspace-level `features/{feature}/00-完成合同.md`(含 Lint 结果表和结构校验结果)。
|
|
33
|
+
- Update workspace-level `features/{feature}/00-工作流状态.md`(复杂度档位、合同状态、Lint 状态、Oracle 汇总)。
|
|
34
|
+
- 向用户呈现:合同摘要、blocking Oracle 清单、Lint 未过项与豁免请求、待确认的冻结请求。
|
|
35
|
+
- Record unresolved questions and evidence gaps explicitly.
|
|
36
|
+
|
|
37
|
+
## 冻结后的效力
|
|
38
|
+
|
|
39
|
+
- `/04-代码实现`、`/04A`、`/04B`、`/交付至完成` 的准入条件之一是本合同「已冻结」且 Lint 通过(S 档要求 ★ 节完整)。
|
|
40
|
+
- `/05-代码审查` 以合同影响边界为范围漂移基准;`/07-测试执行` 只能翻转 Oracle 状态并附证据。
|
|
41
|
+
- `/08-发布准备` 的发布准入 = blocking Oracle 全 PASS(或 WAIVED 且有用户确认记录)。
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# /澄清
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
澄清: 用不超过 5 个高针对性问题消融需求中的语义歧义,把答案直接写回阶段文档,并清理 `[待澄清: …]` 标记。可在 `/01-需求讨论`、`/02-产品文档` 期间或 `/定义完成` 冻结前随时调用。
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
- `AGENTS.md`
|
|
10
|
+
- `workflow/team-profile.yaml`
|
|
11
|
+
- `workflow/constitution.md`(已有原则不再重复提问)
|
|
12
|
+
- Workspace-level `features/{feature}/` 下的现有阶段文档
|
|
13
|
+
- Workspace-level `specs/` 现有行为基线(已实现行为不再当新问题问)
|
|
14
|
+
|
|
15
|
+
## Execution Rules
|
|
16
|
+
|
|
17
|
+
- 每轮最多 5 个问题,按「对完成定义的影响 × 当前不确定度」排序,只问真正改变结论的问题;能从本地文档、代码、specs 或 constitution 推出的答案不要问用户。
|
|
18
|
+
- 每个问题给出建议默认值和 2-3 个候选选项,让用户可以快速选择而不是写作文。
|
|
19
|
+
- 答案必须写回对应文档的对应章节,并同步更新术语表;不允许答案只留在聊天记录里。
|
|
20
|
+
- 发现模糊词(快、流畅、稳定、好用、优雅、高性能、健壮、无缝、及时、大量、尽快)时,必须请用户绑定数字或可观察行为,或由 agent 提议绑定值请用户确认。
|
|
21
|
+
- 无法当场解决的问题,用 `[待澄清: 问题描述]` 标记写入文档相应位置;`/定义完成` 冻结前必须清零。
|
|
22
|
+
- 验收相关的澄清结果建议改写为 EARS 句式(WHEN/WHILE/IF…THEN/WHERE + SHALL)或 Given/When/Then,直接可作 Oracle 候选。
|
|
23
|
+
- 用户明确表示跳过澄清(如探索性 spike)时可以继续后续阶段,但必须警告下游返工风险并在状态文件记录。
|
|
24
|
+
- 默认使用简体中文展示工作流沟通和阶段产物;专有名词、代码标识符、命令、文件路径、API、SDK、框架和官方英文术语保留原文。
|
|
25
|
+
- This stage does not authorize business code changes.
|
|
26
|
+
|
|
27
|
+
## Required Outputs
|
|
28
|
+
|
|
29
|
+
- 更新对应的 `features/{feature}/` 阶段文档:答案入正文、术语入术语表、未决项入 `[待澄清]` 标记。
|
|
30
|
+
- Update workspace-level `features/{feature}/00-工作流状态.md`(剩余待澄清项数量)。
|
|
31
|
+
- 向用户输出本轮问题清单、已消融项和剩余风险。
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# 商业化状态
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| 产品名称 | 待填写 |
|
|
6
|
+
| 一句话描述 | 待填写 |
|
|
7
|
+
| 当前阶段 | 待填写 |
|
|
8
|
+
| 当前状态 | 待开始 / 进行中 / 阻塞 / 已完成 |
|
|
9
|
+
| 展示语言 | 简体中文优先;专有名词、品牌名、渠道名、命令、路径和官方英文术语保留原文 |
|
|
10
|
+
| 关联仓库 | 待填写 |
|
|
11
|
+
| 关联 features | 待填写;营销工程需求对应的工作区级 `features/{feature}/` |
|
|
12
|
+
| 商业化阶段判断 | 验证期 / 首发期 / 增长期 |
|
|
13
|
+
| PMF 判定 | 未验证 / 弱信号 / 达标 |
|
|
14
|
+
| 北极星指标 | 待填写 |
|
|
15
|
+
| 复盘节奏 | 建议周检视指标、月度策略复盘、季度定位校准;待填写实际节奏 |
|
|
16
|
+
| 对外动作授权 | 默认逐项授权;发布内容、投放、cold outreach、联系合作方均需用户授权或自行执行 |
|
|
17
|
+
| 下轮 B9 复盘时间 | 待填写 |
|
|
18
|
+
|
|
19
|
+
## 阶段记录
|
|
20
|
+
|
|
21
|
+
| 阶段 | 状态 | 证据 | 备注 |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| B1-业务定位 | 待开始 | - | 定位陈述需用户确认 |
|
|
24
|
+
| B2-商业模式 | 待开始 | - | 定价假设需用户确认 |
|
|
25
|
+
| B3-PMF与客户画像 | 待开始 | - | ICP 和负面画像需用户确认;未达 PMF 时投放保持最小实验档 |
|
|
26
|
+
| B4-场景与购买旅程 | 待开始 | - | - |
|
|
27
|
+
| B5-渠道漏斗映射 | 待开始 | - | 同时主攻渠道默认不超过 2-3 个 |
|
|
28
|
+
| B6-营销获客策略 | 待开始 | - | 主攻渠道选择需用户确认 |
|
|
29
|
+
| B7-营销预算 | 待开始 | - | 金钱与时间双预算需用户确认 |
|
|
30
|
+
| B8-渠道执行策略 | 待开始 | - | 对外动作逐项授权;营销工程需求回流 `/new-feature` |
|
|
31
|
+
| B9-策略复盘 | 周期执行 | - | 非一次性阶段;每周期追加记录 |
|
|
32
|
+
|
|
33
|
+
## 待验证假设
|
|
34
|
+
|
|
35
|
+
- 待填写
|
|
36
|
+
|
|
37
|
+
## 待授权对外动作
|
|
38
|
+
|
|
39
|
+
- 待填写
|
|
40
|
+
|
|
41
|
+
## 缺失资料
|
|
42
|
+
|
|
43
|
+
- 待填写
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# 工作流状态
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| 功能名称 | 待填写 |
|
|
6
|
+
| 复杂度档位 | S / M / L(含分级理由;S=迷你合同→实现→验证,M=标准路径,L=全流程) |
|
|
7
|
+
| 当前阶段 | 待填写 |
|
|
8
|
+
| 当前状态 | 待开始 / 进行中 / 阻塞 / 已完成 |
|
|
9
|
+
| 展示语言 | 简体中文优先;专有名词、命令、路径、分支名、API、SDK、框架和官方英文术语保留原文 |
|
|
10
|
+
| 影响仓库 | 待填写 |
|
|
11
|
+
| 线上分支 | `prod` |
|
|
12
|
+
| 测试/集成分支 | `main` |
|
|
13
|
+
| 开发分支 | 待填写;个人项目可由 agent 从 `prod` 创建本地开发分支 |
|
|
14
|
+
| 分支基线 | 待填写;记录 `prod` 基线提交 |
|
|
15
|
+
| test 分支 | 不使用 |
|
|
16
|
+
| 完成合同 | 未创建 / 草稿 / 已冻结 / 修订中 |
|
|
17
|
+
| Definition Lint | 未运行 / 通过 / 未通过 |
|
|
18
|
+
| Oracle 汇总 | blocking x/y PASS;全量 m/n PASS(含 STALE/WAIVED 说明) |
|
|
19
|
+
| 待澄清项 | 数量;冻结前必须清零 |
|
|
20
|
+
| 交付模式 | 手动分阶段 / 交付至完成 |
|
|
21
|
+
| CI 状态 | 未配置 / 已配置 / 通过 / 阻塞 |
|
|
22
|
+
| 发布状态 | 未准备 / 本地集成完成 / 等待远程授权 / 已发布 / 阻塞 |
|
|
23
|
+
| 部署回滚 | 未定义 / 已定义 / 已演练 |
|
|
24
|
+
| 实现准入 | 未进入实现 / 已通过 / 阻塞(M/L 档需合同已冻结且 Lint 通过) |
|
|
25
|
+
| 同仓并行 | 无 / 已隔离 / 冲突阻塞 |
|
|
26
|
+
| 商业化关联 | 无 / `business/{product}/`;营销工程需求注明来源 B8 条目 |
|
|
27
|
+
|
|
28
|
+
## 阶段记录
|
|
29
|
+
|
|
30
|
+
| 阶段 | 状态 | 证据 | 备注 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| 01-需求讨论 | 待开始 | - | 存量行为先读 `specs/`;未决项用 `[待澄清]` 标记 |
|
|
33
|
+
| 澄清 | 按需 | - | 每轮 ≤5 问,答案写回文档 |
|
|
34
|
+
| 02-产品文档 | 待开始 | - | S 档可跳过 |
|
|
35
|
+
| 02B-UI设计 | 待开始 | - | 有 UI/前端工作时必须在 04A 前完成或记录明确豁免 |
|
|
36
|
+
| 03-技术架构 | 待开始 | - | S 档可跳过;产出数据流/状态机草案与规范提取 |
|
|
37
|
+
| 06-测试用例 | 待开始 | - | S 档可并入合同 Oracle;风险驱动分配深度 |
|
|
38
|
+
| 定义完成 | 待开始 | - | 编译完成合同;Lint 通过+用户确认后冻结 |
|
|
39
|
+
| 一致性检查 | 建议执行 | - | 实现前只读交叉检查;BLOCKER 必须先解决 |
|
|
40
|
+
| 04-代码实现 | 未授权 | - | 需分支闸门+阶段闸门+已冻结合同(S 档为迷你合同) |
|
|
41
|
+
| 05-代码审查 | 待开始 | - | 以合同影响边界为漂移基准;交付至完成模式下由其覆盖 |
|
|
42
|
+
| 07-测试执行 | 待开始 | - | 只翻转 Oracle 状态并附证据;PASS 后代码再变更置 STALE |
|
|
43
|
+
| 交付至完成 | 可选 | - | 替代手动 04→07:循环至 blocking 全绿或精确阻塞 |
|
|
44
|
+
| 08-发布准备 | 待开始 | - | 发布准入=blocking Oracle 全 PASS/WAIVED(用户确认) |
|
|
45
|
+
| 09-发布执行 | 待开始 | - | 远程 push、release、部署或商店提交需要用户明确授权 |
|
|
46
|
+
| 10-复盘总结 | 待开始 | - | 更新 `specs/` 行为基线、知识沉淀与下一步 |
|
|
47
|
+
|
|
48
|
+
## 缺失资料
|
|
49
|
+
|
|
50
|
+
- 待填写
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Templates
|
|
2
|
+
|
|
3
|
+
These templates are intentionally generic. Target teams should specialize them through `workflow/team-profile.yaml` and feature documents, not by hard-coding private company data into core files.
|
|
4
|
+
|
|
5
|
+
- `00-workflow-status.md`: 研发轨需求状态文件模板,落在 `features/{feature}/00-工作流状态.md`。
|
|
6
|
+
- `stage-document.md`: 研发轨阶段文档模板。
|
|
7
|
+
- `completion-contract.md`: 完成合同模板,落在 `features/{feature}/00-完成合同.md`;S 档只填 ★ 节,可用 `openone-workflow-check-contract` 校验。
|
|
8
|
+
- `constitution.template.md`: 工作区宪法模板,实例化为 `workflow/constitution.md`(跨需求不可协商原则)。
|
|
9
|
+
- `living-spec.md`: living spec 模板,落在工作区级 `specs/`(已实现行为的当前真相)。
|
|
10
|
+
- `00-business-status.md`: 商业化轨状态文件模板,落在 `business/{product}/00-商业化状态.md`。
|
|
11
|
+
- `business-stage-document.md`: 商业化轨阶段文档模板(证据分级 + 对外动作边界)。
|
|
12
|
+
- `team-profile.template.yaml`: 工作区配置模板。
|