@xulthekl/team-flow 0.22.4

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 (405) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.agents/skills +1 -0
  3. package/.claude/always/phase-guard.md +3 -0
  4. package/.claude-plugin/marketplace.json +20 -0
  5. package/.claude-plugin/plugin.json +31 -0
  6. package/.codex-plugin/plugin.json +45 -0
  7. package/.codexignore +6 -0
  8. package/.cursor-plugin/marketplace.json +17 -0
  9. package/.cursor-plugin/plugin.json +31 -0
  10. package/.github/copilot-instructions.md +15 -0
  11. package/.github/dependabot.yml +10 -0
  12. package/.github/plugin/marketplace.json +42 -0
  13. package/.github/workflows/ci.yml +98 -0
  14. package/.github/workflows/hol-plugin-scanner.yml +17 -0
  15. package/.opencode/INSTALL.md +61 -0
  16. package/.opencode/plugins/team-flow.js +70 -0
  17. package/AGENTS.md +280 -0
  18. package/CHANGELOG.md +635 -0
  19. package/CONTRIBUTING.md +115 -0
  20. package/GEMINI.md +14 -0
  21. package/HANDOFF.md +219 -0
  22. package/INSTALL.md +810 -0
  23. package/LICENSE +21 -0
  24. package/README.md +185 -0
  25. package/SECURITY.md +37 -0
  26. package/agents/bug-investigator.md +180 -0
  27. package/agents/change-split-auditor.md +257 -0
  28. package/agents/code-reviewer.md +171 -0
  29. package/agents/cross-change-consistency-checker.md +215 -0
  30. package/agents/prd-completeness-reviewer.md +197 -0
  31. package/agents/prototype-builder.md +230 -0
  32. package/agents/prototype-env-scout.md +156 -0
  33. package/agents/prototype-reviewer.md +226 -0
  34. package/assets/icon.svg +6 -0
  35. package/dist/index.d.ts +13 -0
  36. package/dist/index.js +5 -0
  37. package/dist/parsing/change-parser.d.ts +12 -0
  38. package/dist/parsing/change-parser.js +54 -0
  39. package/dist/parsing/requirement-blocks.d.ts +31 -0
  40. package/dist/parsing/requirement-blocks.js +192 -0
  41. package/dist/schema/base.d.ts +7 -0
  42. package/dist/schema/base.js +1 -0
  43. package/dist/schema/change.d.ts +25 -0
  44. package/dist/schema/change.js +1 -0
  45. package/dist/schema/index.d.ts +3 -0
  46. package/dist/schema/index.js +1 -0
  47. package/dist/schema/spec.d.ts +11 -0
  48. package/dist/schema/spec.js +1 -0
  49. package/dist/validation/constants.d.ts +42 -0
  50. package/dist/validation/constants.js +42 -0
  51. package/dist/validation/tokenizer.d.ts +17 -0
  52. package/dist/validation/tokenizer.js +173 -0
  53. package/dist/validation/types.d.ts +40 -0
  54. package/dist/validation/types.js +1 -0
  55. package/dist/validation/validator.d.ts +21 -0
  56. package/dist/validation/validator.js +489 -0
  57. package/docs/README_en.md +358 -0
  58. package/docs/artifact-contract.md +96 -0
  59. package/docs/decision-points.md +88 -0
  60. package/docs/e2e-integration-design.md +207 -0
  61. package/docs/examples/README.md +25 -0
  62. package/docs/examples/add-dark-mode/README.md +13 -0
  63. package/docs/examples/add-dark-mode/design.md +49 -0
  64. package/docs/examples/add-dark-mode/execution-contract.md +56 -0
  65. package/docs/examples/add-dark-mode/proposal.md +46 -0
  66. package/docs/examples/add-dark-mode/specs/ui-theme/spec.md +35 -0
  67. package/docs/examples/add-dark-mode/tasks.md +26 -0
  68. package/docs/examples/refactor-auth-boundary/README.md +15 -0
  69. package/docs/examples/refactor-auth-boundary/design.md +41 -0
  70. package/docs/examples/refactor-auth-boundary/execution-contract.md +61 -0
  71. package/docs/examples/refactor-auth-boundary/proposal.md +47 -0
  72. package/docs/examples/refactor-auth-boundary/specs/auth-boundary/spec.md +45 -0
  73. package/docs/examples/refactor-auth-boundary/tasks.md +25 -0
  74. package/docs/plans/2026-07-07-fix-batch-design.md +68 -0
  75. package/docs/plans/2026-07-20-001-refactor-skill-collaboration-protocol-plan.md +128 -0
  76. package/docs/platform-matrix.md +45 -0
  77. package/docs/prototype-design-research.md +206 -0
  78. package/docs/release-checklist.md +96 -0
  79. package/docs/showcase.html +699 -0
  80. package/docs/skill-rename-v0.8.0.md +49 -0
  81. package/docs/state-machine.md +162 -0
  82. package/gemini-extension.json +6 -0
  83. package/hooks/hooks-cursor.json +8 -0
  84. package/hooks/hooks.json +26 -0
  85. package/hooks/pre-tool-use-guard +116 -0
  86. package/hooks/session-start +14 -0
  87. package/llms.txt +51 -0
  88. package/package.json +48 -0
  89. package/plugin.json +27 -0
  90. package/prd/v1/plan.md +443 -0
  91. package/prd/v1/prd.md +580 -0
  92. package/scripts/check-update.mjs +91 -0
  93. package/scripts/check-version-consistency.mjs +345 -0
  94. package/scripts/ensure-branch.mjs +71 -0
  95. package/scripts/get-config +31 -0
  96. package/scripts/guard/checks/artifacts-exist.mjs +36 -0
  97. package/scripts/guard/checks/contract-current.mjs +33 -0
  98. package/scripts/guard/checks/contract-fresh.mjs +17 -0
  99. package/scripts/guard/checks/dp-gate-passed.mjs +35 -0
  100. package/scripts/guard/checks/dp3-approved.mjs +22 -0
  101. package/scripts/guard/checks/execution-plan-ready.mjs +40 -0
  102. package/scripts/guard/checks/execution-reviews-passed.mjs +36 -0
  103. package/scripts/guard/checks/schema-valid.mjs +63 -0
  104. package/scripts/guard/checks/specs-merged.mjs +51 -0
  105. package/scripts/guard/checks/tasks-complete.mjs +31 -0
  106. package/scripts/guard/checks/tests-passing.mjs +31 -0
  107. package/scripts/guard/design-token-guard.mjs +237 -0
  108. package/scripts/guard/guard.mjs +205 -0
  109. package/scripts/infer-workflow.mjs +136 -0
  110. package/scripts/install-amazon-q.mjs +9 -0
  111. package/scripts/install-cline.mjs +9 -0
  112. package/scripts/install-continue.mjs +9 -0
  113. package/scripts/install-cursor.mjs +265 -0
  114. package/scripts/install-git-hooks.mjs +82 -0
  115. package/scripts/install-kiro.mjs +9 -0
  116. package/scripts/install-pi.mjs +9 -0
  117. package/scripts/install-qoder.mjs +9 -0
  118. package/scripts/install-qwen.mjs +9 -0
  119. package/scripts/install-roocode.mjs +9 -0
  120. package/scripts/install-windsurf.mjs +9 -0
  121. package/scripts/install-zcode.mjs +265 -0
  122. package/scripts/lib/cmd-audit.mjs +127 -0
  123. package/scripts/lib/cmd-checkpoint.mjs +118 -0
  124. package/scripts/lib/cmd-config.mjs +88 -0
  125. package/scripts/lib/cmd-doctor.mjs +267 -0
  126. package/scripts/lib/cmd-execution.mjs +206 -0
  127. package/scripts/lib/cmd-handoff.mjs +94 -0
  128. package/scripts/lib/cmd-inject.mjs +310 -0
  129. package/scripts/lib/cmd-install-amazon-q.mjs +11 -0
  130. package/scripts/lib/cmd-install-cline.mjs +11 -0
  131. package/scripts/lib/cmd-install-continue.mjs +11 -0
  132. package/scripts/lib/cmd-install-cursor.mjs +14 -0
  133. package/scripts/lib/cmd-install-kiro.mjs +11 -0
  134. package/scripts/lib/cmd-install-pi.mjs +11 -0
  135. package/scripts/lib/cmd-install-qoder.mjs +11 -0
  136. package/scripts/lib/cmd-install-qwen.mjs +11 -0
  137. package/scripts/lib/cmd-install-roocode.mjs +11 -0
  138. package/scripts/lib/cmd-install-windsurf.mjs +11 -0
  139. package/scripts/lib/cmd-install-workbuddy.mjs +359 -0
  140. package/scripts/lib/cmd-install-zcode.mjs +14 -0
  141. package/scripts/lib/cmd-isolate.mjs +37 -0
  142. package/scripts/lib/cmd-list.mjs +71 -0
  143. package/scripts/lib/cmd-runtime.mjs +85 -0
  144. package/scripts/lib/cmd-solutions.mjs +71 -0
  145. package/scripts/lib/cmd-state.mjs +231 -0
  146. package/scripts/lib/cmd-sync.mjs +102 -0
  147. package/scripts/lib/cmd-validate.mjs +105 -0
  148. package/scripts/lib/cmd-version.mjs +148 -0
  149. package/scripts/lib/config-loader.mjs +107 -0
  150. package/scripts/lib/execution-plan.mjs +492 -0
  151. package/scripts/lib/execution-recommendation.mjs +221 -0
  152. package/scripts/lib/hash.mjs +74 -0
  153. package/scripts/lib/install.mjs +267 -0
  154. package/scripts/lib/platform-runtime-inventory.mjs +27 -0
  155. package/scripts/lib/platforms.mjs +165 -0
  156. package/scripts/lib/prototype-sync.mjs +192 -0
  157. package/scripts/lib/sdd-overlay.mjs +262 -0
  158. package/scripts/lib/shell-quote.mjs +4 -0
  159. package/scripts/lib/solutions-capture.mjs +102 -0
  160. package/scripts/lib/solutions-index-gen.mjs +112 -0
  161. package/scripts/lib/solutions-inject.mjs +77 -0
  162. package/scripts/lib/solutions-promote.mjs +145 -0
  163. package/scripts/lib/spec-paths.mjs +85 -0
  164. package/scripts/lib/state-loader.mjs +154 -0
  165. package/scripts/lint/lint-skills.mjs +149 -0
  166. package/scripts/lint/rules/behavior-consistency.mjs +56 -0
  167. package/scripts/lint/rules/dp-trigger-points.mjs +60 -0
  168. package/scripts/lint/rules/exception-handling.mjs +59 -0
  169. package/scripts/lint/rules/no-contradictory-instructions.mjs +67 -0
  170. package/scripts/lint/rules/no-redundant-checks.mjs +50 -0
  171. package/scripts/lint/rules/token-rules.mjs +122 -0
  172. package/scripts/review-package +44 -0
  173. package/scripts/task-brief +40 -0
  174. package/scripts/team-flow.mjs +164 -0
  175. package/scripts/token-baseline.mjs +158 -0
  176. package/scripts/validate-artifacts +96 -0
  177. package/scripts/verify-marketplace-release.mjs +59 -0
  178. package/skills/architecture-design/SKILL.md +140 -0
  179. package/skills/architecture-design/chapters/ch01-4a-domains.md +27 -0
  180. package/skills/architecture-design/chapters/ch02-change-cascade.md +27 -0
  181. package/skills/architecture-design/chapters/ch03-architecture-outputs.md +25 -0
  182. package/skills/architecture-design/chapters/ch04-entity-to-aggregate.md +27 -0
  183. package/skills/architecture-design/chapters/ch05-cqrs.md +32 -0
  184. package/skills/architecture-design/chapters/ch06-integration.md +54 -0
  185. package/skills/architecture-design/cheatsheet.md +51 -0
  186. package/skills/architecture-design/glossary.md +23 -0
  187. package/skills/architecture-design/patterns.md +32 -0
  188. package/skills/bug-investigator/SKILL.md +77 -0
  189. package/skills/build-executor/SKILL.md +163 -0
  190. package/skills/build-executor/implementer-prompt.md +162 -0
  191. package/skills/build-executor/references/execution-modes.md +86 -0
  192. package/skills/build-executor/task-reviewer-prompt.md +195 -0
  193. package/skills/ce-brainstorm/SKILL.md +415 -0
  194. package/skills/ce-brainstorm/references/agents/slack-researcher.md +127 -0
  195. package/skills/ce-brainstorm/references/blindspot-pass.md +70 -0
  196. package/skills/ce-brainstorm/references/brainstorm-sections.md +285 -0
  197. package/skills/ce-brainstorm/references/handoff.md +168 -0
  198. package/skills/ce-brainstorm/references/html-rendering.md +634 -0
  199. package/skills/ce-brainstorm/references/markdown-rendering.md +241 -0
  200. package/skills/ce-brainstorm/references/model-tiers.md +9 -0
  201. package/skills/ce-brainstorm/references/prd-mapping.md +71 -0
  202. package/skills/ce-brainstorm/references/product-pressure-test.md +42 -0
  203. package/skills/ce-brainstorm/references/reasoning-elevation.md +63 -0
  204. package/skills/ce-brainstorm/references/settled-decisions.md +45 -0
  205. package/skills/ce-brainstorm/references/synthesis-summary.md +282 -0
  206. package/skills/ce-brainstorm/references/universal-brainstorming.md +73 -0
  207. package/skills/ce-brainstorm/references/verdict-routing.md +26 -0
  208. package/skills/ce-brainstorm/references/visual-probes.md +158 -0
  209. package/skills/ce-brainstorm/scripts/visual-probe-server.js +418 -0
  210. package/skills/ce-compound/SKILL.md +114 -0
  211. package/skills/ce-compound/assets/resolution-template.md +94 -0
  212. package/skills/ce-compound/references/agents/best-practices-researcher.md +115 -0
  213. package/skills/ce-compound/references/agents/data-integrity-guardian.md +68 -0
  214. package/skills/ce-compound/references/agents/framework-docs-researcher.md +93 -0
  215. package/skills/ce-compound/references/agents/pattern-recognition-specialist.md +55 -0
  216. package/skills/ce-compound/references/agents/performance-oracle.md +108 -0
  217. package/skills/ce-compound/references/agents/security-sentinel.md +91 -0
  218. package/skills/ce-compound/references/agents/session-historian.md +83 -0
  219. package/skills/ce-compound/references/concepts-vocabulary.md +78 -0
  220. package/skills/ce-compound/references/full-mode-workflow.md +413 -0
  221. package/skills/ce-compound/references/grounding-validation.md +84 -0
  222. package/skills/ce-compound/references/lightweight-mode.md +53 -0
  223. package/skills/ce-compound/references/output-standards.md +182 -0
  224. package/skills/ce-compound/references/promotion-rules.md +38 -0
  225. package/skills/ce-compound/references/schema.yaml +231 -0
  226. package/skills/ce-compound/references/three-tier-index.md +55 -0
  227. package/skills/ce-compound/references/v0.5-upgrade.md +32 -0
  228. package/skills/ce-compound/references/write-flow.md +36 -0
  229. package/skills/ce-compound/references/yaml-schema.md +118 -0
  230. package/skills/ce-compound/scripts/session-history/discover-sessions.sh +130 -0
  231. package/skills/ce-compound/scripts/session-history/extract-errors.py +254 -0
  232. package/skills/ce-compound/scripts/session-history/extract-metadata.py +456 -0
  233. package/skills/ce-compound/scripts/session-history/extract-skeleton.py +575 -0
  234. package/skills/ce-compound/scripts/validate-doc-claims.py +346 -0
  235. package/skills/ce-compound/scripts/validate-frontmatter.py +137 -0
  236. package/skills/ce-ideate/SKILL.md +402 -0
  237. package/skills/ce-ideate/references/agents/issue-intelligence-analyst.md +200 -0
  238. package/skills/ce-ideate/references/agents/learnings-researcher.md +247 -0
  239. package/skills/ce-ideate/references/agents/slack-researcher.md +127 -0
  240. package/skills/ce-ideate/references/agents/web-researcher.md +121 -0
  241. package/skills/ce-ideate/references/divergent-ideation.md +89 -0
  242. package/skills/ce-ideate/references/html-rendering.md +634 -0
  243. package/skills/ce-ideate/references/ideation-sections.md +191 -0
  244. package/skills/ce-ideate/references/markdown-rendering.md +238 -0
  245. package/skills/ce-ideate/references/post-ideation-workflow.md +167 -0
  246. package/skills/ce-ideate/references/universal-ideation.md +107 -0
  247. package/skills/ce-ideate/references/web-research-cache.md +56 -0
  248. package/skills/ce-plan/SKILL.md +137 -0
  249. package/skills/ce-plan/references/agents/agent-native-planning-strategist.md +62 -0
  250. package/skills/ce-plan/references/agents/architecture-strategist.md +46 -0
  251. package/skills/ce-plan/references/agents/best-practices-researcher.md +114 -0
  252. package/skills/ce-plan/references/agents/data-integrity-guardian.md +68 -0
  253. package/skills/ce-plan/references/agents/data-migration-reviewer.md +103 -0
  254. package/skills/ce-plan/references/agents/deployment-verification-agent.md +157 -0
  255. package/skills/ce-plan/references/agents/framework-docs-researcher.md +93 -0
  256. package/skills/ce-plan/references/agents/git-history-analyzer.md +40 -0
  257. package/skills/ce-plan/references/agents/learnings-researcher.md +247 -0
  258. package/skills/ce-plan/references/agents/pattern-recognition-specialist.md +55 -0
  259. package/skills/ce-plan/references/agents/performance-oracle.md +108 -0
  260. package/skills/ce-plan/references/agents/repo-research-analyst.md +258 -0
  261. package/skills/ce-plan/references/agents/security-sentinel.md +91 -0
  262. package/skills/ce-plan/references/agents/slack-researcher.md +127 -0
  263. package/skills/ce-plan/references/agents/spec-flow-analyzer.md +80 -0
  264. package/skills/ce-plan/references/agents/web-researcher.md +121 -0
  265. package/skills/ce-plan/references/approach-altitude.md +55 -0
  266. package/skills/ce-plan/references/change-splitting.md +65 -0
  267. package/skills/ce-plan/references/completion-contract.md +33 -0
  268. package/skills/ce-plan/references/core-principles.md +40 -0
  269. package/skills/ce-plan/references/deepening-workflow.md +263 -0
  270. package/skills/ce-plan/references/dependency-graph.md +36 -0
  271. package/skills/ce-plan/references/html-rendering.md +634 -0
  272. package/skills/ce-plan/references/intake-routing.md +189 -0
  273. package/skills/ce-plan/references/markdown-rendering.md +238 -0
  274. package/skills/ce-plan/references/plan-handoff.md +150 -0
  275. package/skills/ce-plan/references/plan-sections.md +427 -0
  276. package/skills/ce-plan/references/plan-structure.md +120 -0
  277. package/skills/ce-plan/references/planning-modes.md +69 -0
  278. package/skills/ce-plan/references/reasoning-elevation.md +63 -0
  279. package/skills/ce-plan/references/research-workflow.md +165 -0
  280. package/skills/ce-plan/references/review-and-write.md +127 -0
  281. package/skills/ce-plan/references/settled-decisions.md +45 -0
  282. package/skills/ce-plan/references/synthesis-summary.md +418 -0
  283. package/skills/ce-plan/references/universal-planning.md +168 -0
  284. package/skills/ce-proof/SKILL.md +346 -0
  285. package/skills/ce-strategy/SKILL.md +97 -0
  286. package/skills/ce-strategy/references/interview.md +143 -0
  287. package/skills/ce-strategy/references/strategy-template.md +89 -0
  288. package/skills/code-reviewer/SKILL.md +84 -0
  289. package/skills/code-reviewer/code-reviewer-prompt.md +195 -0
  290. package/skills/contract-builder/SKILL.md +72 -0
  291. package/skills/design-system/SKILL.md +75 -0
  292. package/skills/design-system/references/agents/design-system-architect.md +138 -0
  293. package/skills/design-system/references/creation-flow.md +170 -0
  294. package/skills/design-system/references/preview-template.html +319 -0
  295. package/skills/design-system/references/token-derivation.md +115 -0
  296. package/skills/design-system/references/variant-schema.md +60 -0
  297. package/skills/e2e/SKILL.md +56 -0
  298. package/skills/e2e/references/test-verifier.md +40 -0
  299. package/skills/need-explorer/SKILL.md +79 -0
  300. package/skills/prototype/SKILL.md +98 -0
  301. package/skills/prototype/references/agents/design-system-architect.md +122 -0
  302. package/skills/prototype/references/checklist.md +82 -0
  303. package/skills/prototype/references/craft/accessibility-baseline.md +71 -0
  304. package/skills/prototype/references/craft/anti-ai-slop.md +87 -0
  305. package/skills/prototype/references/craft/laws-of-ux.md +60 -0
  306. package/skills/prototype/references/craft/state-coverage.md +81 -0
  307. package/skills/prototype/references/craft/typography-hierarchy.md +50 -0
  308. package/skills/prototype/references/layouts.md +223 -0
  309. package/skills/prototype/references/orchestration-flow.md +101 -0
  310. package/skills/prototype/references/prototype-scaffold/assets/design-tokens.css +19 -0
  311. package/skills/prototype/references/prototype-scaffold/components/button.html +3 -0
  312. package/skills/prototype/references/prototype-scaffold/design-system.md +7 -0
  313. package/skills/prototype/references/prototype-scaffold/flow.md +11 -0
  314. package/skills/prototype/references/prototype-scaffold/index.html +20 -0
  315. package/skills/prototype/references/prototype-scaffold/pages/index.html +11 -0
  316. package/skills/prototype/references/template.html +396 -0
  317. package/skills/release-archivist/SKILL.md +166 -0
  318. package/skills/release-archivist/references/closing-procedures.md +81 -0
  319. package/skills/session-handoff/SKILL.md +110 -0
  320. package/skills/session-handoff/references/context-extraction.md +70 -0
  321. package/skills/session-handoff/references/handoff-template.md +90 -0
  322. package/skills/session-handoff/references/skill-recommendation.md +43 -0
  323. package/skills/spec-merger/SKILL.md +66 -0
  324. package/skills/spec-writer/SKILL.md +149 -0
  325. package/skills/workflow-bootstrap/SKILL.md +148 -0
  326. package/skills/workflow-bootstrap/references/agents/codebase-recon-analyst.md +121 -0
  327. package/skills/workflow-bootstrap/references/b1-reconnaissance.md +80 -0
  328. package/skills/workflow-bootstrap/scripts/recon-probe.sh +328 -0
  329. package/skills/workflow-feedback/SKILL.md +120 -0
  330. package/skills/workflow-feedback/references/category-guide.md +121 -0
  331. package/skills/workflow-feedback/references/feedback-template.md +73 -0
  332. package/skills/workflow-feedback/references/review-mode.md +92 -0
  333. package/skills/workflow-orchestrator/SKILL.md +94 -0
  334. package/skills/workflow-orchestrator/references/feedback-loops.md +56 -0
  335. package/skills/workflow-orchestrator/references/s1-path-router.md +81 -0
  336. package/skills/workflow-orchestrator/references/s2-prd-prototype-loop.md +96 -0
  337. package/skills/workflow-orchestrator/references/s3-plan-pipeline.md +50 -0
  338. package/skills/workflow-orchestrator/references/s4-split-validate.md +108 -0
  339. package/skills/workflow-orchestrator/references/s5-monitoring.md +61 -0
  340. package/skills/workflow-orchestrator/references/state-model.md +185 -0
  341. package/skills/workflow-start/SKILL.md +147 -0
  342. package/skills/workflow-start/references/routing-rules.md +155 -0
  343. package/src/index.ts +16 -0
  344. package/src/parsing/change-parser.ts +79 -0
  345. package/src/parsing/requirement-blocks.ts +244 -0
  346. package/src/schema/base.ts +8 -0
  347. package/src/schema/change.ts +29 -0
  348. package/src/schema/index.ts +3 -0
  349. package/src/schema/spec.ts +12 -0
  350. package/src/validation/constants.ts +53 -0
  351. package/src/validation/tokenizer.ts +180 -0
  352. package/src/validation/types.ts +47 -0
  353. package/src/validation/validator.ts +552 -0
  354. package/templates/abandonment-summary.md +29 -0
  355. package/templates/design.md +37 -0
  356. package/templates/execution-contract.md +99 -0
  357. package/templates/plan.md +86 -0
  358. package/templates/prd.md +468 -0
  359. package/templates/proposal.md +37 -0
  360. package/templates/spec.md +31 -0
  361. package/templates/tasks.md +47 -0
  362. package/tests/e2e.test.mjs +266 -0
  363. package/tests/lib/cmd-audit.test.mjs +202 -0
  364. package/tests/lib/cmd-checkpoint.test.mjs +98 -0
  365. package/tests/lib/cmd-config.test.mjs +101 -0
  366. package/tests/lib/cmd-doctor.test.mjs +450 -0
  367. package/tests/lib/cmd-execution.test.mjs +647 -0
  368. package/tests/lib/cmd-handoff.test.mjs +137 -0
  369. package/tests/lib/cmd-inject.test.mjs +218 -0
  370. package/tests/lib/cmd-install-workbuddy.test.mjs +113 -0
  371. package/tests/lib/cmd-install-zcode.test.mjs +42 -0
  372. package/tests/lib/cmd-isolate.test.mjs +68 -0
  373. package/tests/lib/cmd-list.test.mjs +127 -0
  374. package/tests/lib/cmd-runtime.test.mjs +83 -0
  375. package/tests/lib/cmd-state-missing.test.mjs +65 -0
  376. package/tests/lib/cmd-state.test.mjs +365 -0
  377. package/tests/lib/cmd-sync-paths.test.mjs +84 -0
  378. package/tests/lib/cmd-validate-paths.test.mjs +90 -0
  379. package/tests/lib/config-loader.test.mjs +175 -0
  380. package/tests/lib/ensure-branch.test.mjs +59 -0
  381. package/tests/lib/execution-control-plane.test.mjs +168 -0
  382. package/tests/lib/execution-plan.test.mjs +474 -0
  383. package/tests/lib/guard-specs-merged.test.mjs +108 -0
  384. package/tests/lib/guard-tests-passing.test.mjs +112 -0
  385. package/tests/lib/guard-transitions.test.mjs +262 -0
  386. package/tests/lib/guard.test.mjs +611 -0
  387. package/tests/lib/hash.test.mjs +138 -0
  388. package/tests/lib/infer-workflow.test.mjs +161 -0
  389. package/tests/lib/install-git-hooks.test.mjs +20 -0
  390. package/tests/lib/marketplace-release-docs.test.mjs +31 -0
  391. package/tests/lib/minimality-discipline.test.mjs +37 -0
  392. package/tests/lib/model-profiles-docs.test.mjs +33 -0
  393. package/tests/lib/node20-compatibility.test.mjs +73 -0
  394. package/tests/lib/node20-test-entry.test.mjs +17 -0
  395. package/tests/lib/platform-runtime-distribution.test.mjs +150 -0
  396. package/tests/lib/raw-mode-smoke.test.mjs +42 -0
  397. package/tests/lib/sdd-overlay.test.mjs +118 -0
  398. package/tests/lib/spec-paths.test.mjs +80 -0
  399. package/tests/lib/state-loader.test.mjs +251 -0
  400. package/tests/lib/token-baseline.test.mjs +72 -0
  401. package/tests/lib/token-rules.test.mjs +94 -0
  402. package/tests/lib/verify-marketplace-release.test.mjs +128 -0
  403. package/tests/tsconfig.json +12 -0
  404. package/token-baseline.json +95 -0
  405. package/tsconfig.json +14 -0
@@ -0,0 +1,99 @@
1
+ # 执行合同
2
+
3
+ ## Intent Lock
4
+
5
+ - **变更名称**:
6
+ - **要解决的问题**:
7
+ - **范围内**:
8
+ - **范围外**:
9
+
10
+ ## Approved Behavior
11
+
12
+ - **已批准需求摘要**:
13
+ - **关键场景**:
14
+ - **验收检查**:
15
+
16
+ ## Design Constraints
17
+
18
+ - **架构约束**:
19
+ - **接口约束**:
20
+ - **依赖约束**:
21
+ - **数据约束**:
22
+
23
+ ## Execution Plan
24
+
25
+ full/hotfix 先运行 `tf execution recommend`,按任务量和 wave 策略列出可用方式并
26
+ 推荐一种,同时保存匹配当前 wave 的 recommendation receipt。Agent 展示候选项和理由,
27
+ `plan` 和 `revise` 均只接受仍匹配 artifact、contract 和 wave 的凭据;用户通过 `--confirm` 明确确认;选择非推荐方式时
28
+ 还必须记录 `--acknowledge-recommendation`。Batch Inline 是串行模式,不得描述为并行。批准后,
29
+ `tf execution plan` 会把当前执行计划保存到
30
+ `<change>/.superpowers/sdd/execution-plan.json`;该 JSON 是计划的持久化控制面,
31
+ 不是本 execution contract 的一部分。
32
+
33
+ ## Execution Waves
34
+
35
+ 每个 wave 必须有唯一 ID;只有依赖 wave 的 review receipt 为 `pass` 后,后续
36
+ wave 才可以开始。`parallel` 只表示允许在宿主支持并发派发时同时执行;不支持并发时
37
+ 必须明确报告该能力不可用,而不能把 `parallel` 计划悄然改写成串行执行。
38
+
39
+ ### Wave 1
40
+
41
+ - **Wave ID**:
42
+ - **任务**:
43
+ - **依赖 wave**:无
44
+ - **策略**:`parallel` | `serial`
45
+ - **目标**:
46
+ - **输入**:
47
+ - **输出**:
48
+ - **完成标准**:
49
+ - **Review gate**:review report 路径、base/head SHA、review receipt(`pass` | `fail`)
50
+
51
+ ### Wave 2
52
+
53
+ - **Wave ID**:
54
+ - **任务**:
55
+ - **依赖 wave**:
56
+ - **策略**:`parallel` | `serial`
57
+ - **目标**:
58
+ - **输入**:
59
+ - **输出**:
60
+ - **完成标准**:
61
+ - **Review gate**:review report 路径、base/head SHA、review receipt(`pass` | `fail`)
62
+
63
+ ## Test Obligations
64
+
65
+ - **必须先从失败测试开始的行为**:
66
+ - **必需的边界情况**:
67
+ - **回归敏感区域**:
68
+
69
+ ## Execution Mode
70
+
71
+ - **可用方式与推荐**:`tf execution recommend <change-dir> [--wave <id>:<parallel|serial>:<task,...>[:<depends-on,...>]]`
72
+ - **用户确认的模式**:`sdd` | `inline` | `batch-inline`
73
+ - **推荐理由 / 项目事实**:
74
+ - **非推荐选择的风险确认**:`--acknowledge-recommendation`(若适用)
75
+ - **执行计划命令**:`tf execution plan <change-dir> --mode <mode> --confirm --reason <text> --wave <id>:<parallel|serial>:<task,...>[:<depends-on,...>] [--acknowledge-recommendation]`
76
+ - **允许的修订**:将已有计划保留/升级为 `sdd`;先重新 recommend,并以 `--confirm` 生成新 revision 和清除旧 receipt;不允许降级:`tf execution revise <change-dir> --mode sdd --confirm --reason <text> --wave <id>:<parallel|serial>:<task,...>[:<depends-on,...>] [--acknowledge-recommendation]`
77
+ - **计划 revision / artifact hash**:
78
+
79
+ ## Verification Dimensions
80
+
81
+ | 维度 | 状态 | 发现 |
82
+ |------|------|------|
83
+ | Completeness | Pending | — |
84
+ | Correctness | Pending | — |
85
+ | Coherence | Pending | — |
86
+
87
+ **总体结论**:Pending
88
+
89
+ ## Review Gates
90
+
91
+ - **强制审查点**:每个 Execution Wave 完成后记录 `tf execution review` 的 review receipt
92
+ - **阻塞类别**:依赖未通过、review receipt 为 `fail`、缺失或过期
93
+ - **收口条件**:所有当前 wave 都有 `pass` review receipt
94
+
95
+ ## Escalation Rules
96
+
97
+ - **何时回退到 `specifying`**:
98
+ - **何时回退到 `bridging`**:
99
+ - **何时不得继续实现**:
@@ -0,0 +1,86 @@
1
+ # {项目名称} - 实施方案
2
+
3
+ > 关联 PRD:[prd/vN/prd.md](prd/vN/prd.md)
4
+ > 模式:{业务模式 | 一人公司模式}
5
+ > 版本:{版本号}
6
+ > 创建日期:{YYYY-MM-DD}
7
+
8
+ ---
9
+
10
+ ## 一、需求摘要
11
+
12
+ {从 PRD 中提取的核心需求摘要,1-3 句话,概括本次迭代要实现什么}
13
+
14
+ ## 二、任务拆分
15
+
16
+ ### 2.1 功能任务清单
17
+
18
+ | 任务编号 | 关联 PRD 章节 | 任务名称 | 任务描述 | 优先级 | 预估工时 | 依赖任务 | 验收标准 |
19
+ |---|---|---|---|---|---|---|---|
20
+ | T001 | {PRD 章节编号} | {任务名} | {描述} | {P0/P1/P2} | {工时} | {依赖编号或/} | {验收条件} |
21
+
22
+ ### 2.2 任务依赖关系
23
+
24
+ {描述任务之间的依赖关系,可以用文字或简单的依赖图}
25
+
26
+ ## 三、验收标准
27
+
28
+ ### 3.1 功能验收
29
+
30
+ | 验收项 | 关联任务 | 验收条件 | 验证方式 |
31
+ |---|---|---|---|
32
+ | {验收项名} | {任务编号} | {具体条件} | {手动/自动化/测试} |
33
+
34
+ ### 3.2 非功能验收
35
+
36
+ | 维度 | 指标 | 目标值 | 验证方式 |
37
+ |---|---|---|---|
38
+ | 性能 | {响应时间} | {目标} | {工具/方法} |
39
+ | 兼容性 | {兼容范围} | {目标} | {测试方法} |
40
+
41
+ ## 四、风险与约束
42
+
43
+ | 风险项 | 影响 | 应对策略 |
44
+ |---|---|---|
45
+ | {风险描述} | {影响范围} | {应对方案} |
46
+
47
+ ---
48
+
49
+ ## 五、技术方案(一人公司模式专用)
50
+
51
+ > **仅一人公司模式填充。** 业务模式下此章节保留为空,由后续 team-flow 变更链在具体 change 中设计。
52
+ > **边界(v0.8)**:本章只到**高阶技术设计**(模块边界 + 技术选型 + 数据流方向 + 关键聚合/上下文划分)。**禁止输出接口清单 / 字段定义 / 方法签名 / 请求响应 schema**——属各 change 的 spec-writer / architecture-design。
53
+
54
+ ### 5.1 技术选型
55
+
56
+ | 技术领域 | 选型 | 选型理由 | 备选方案 |
57
+ |---|---|---|---|
58
+ | {前端/后端/数据库/...} | {技术} | {理由} | {备选} |
59
+
60
+ ### 5.2 高阶架构设计
61
+
62
+ {整体架构方向概述:模块边界划分、数据流方向、关键聚合/限界上下文。**不含接口设计/字段定义**}
63
+
64
+ ### 5.3 数据模型变更
65
+
66
+ {涉及的数据模型/表结构变更概述}
67
+
68
+ ### 5.4 关键技术决策
69
+
70
+ | 决策项 | 决策内容 | 理由 | 备选方案 |
71
+ |---|---|---|---|
72
+ | {决策} | {内容} | {理由} | {备选} |
73
+
74
+ ---
75
+
76
+ ## 六、里程碑计划
77
+
78
+ | 里程碑 | 包含任务 | 目标日期 | 交付物 |
79
+ |---|---|---|---|
80
+ | M1 - {名称} | {任务编号列表} | {日期} | {交付物描述} |
81
+ | M2 - {名称} | {任务编号列表} | {日期} | {交付物描述} |
82
+
83
+ ## 七、待定事项
84
+
85
+ - [ ] {待定事项 1}
86
+ - [ ] {待定事项 2}
@@ -0,0 +1,468 @@
1
+ # {项目名称}_D7_业务要件
2
+
3
+ ## 一、版本修订记录
4
+
5
+ ### 1.1 版本信息
6
+
7
+ > 版本格式规范(v0.8):产品版本用 `vN.M`(迭代版本.文档修订次版本);文档状态必须与 frontmatter `frozen` 一致(`frozen: true` 时不得为「编辑中」)。详见 ce-brainstorm `references/prd-mapping.md`「版本格式规范」。
8
+
9
+ | 文档状态 | {编辑中/已冻结-下游/已冻结-绝对} | | |
10
+ |---|---|---|---|
11
+ | 产品版本 | {vN.M,如 v1.0} | | |
12
+ | 文档编号 | {编号} | | |
13
+ | 撰写人 | {姓名} | | |
14
+ | 撰写日期 | {YYYY/MM/DD} | | |
15
+
16
+ ### 1.2 修订记录
17
+
18
+ | 版本号 | 修订日期 | 修订内容 | 修订人 |
19
+ |---|---|---|---|
20
+ | {版本} | {日期} | {变更描述} | {姓名} |
21
+
22
+ ## 二、业务流程一览
23
+
24
+ 本次迭代新增/更新业务流程(含子流程)如下:
25
+
26
+ | L1流程分类 | L2流程分组 | L3业务流程 | L4子流程 | 利益相关 | 价值描述 | 流程名称 | 流程描述 | 变更类型 | 关联系统 | 关联需求编号 | 备注 |
27
+ |---|---|---|---|---|---|---|---|---|---|---|---|
28
+ | {分类} | {分组} | {编号} | {子流程编号或/} | {相关方} | {价值} | {名称} | {描述} | {新增/变更} | {系统名} | {编号} | |
29
+
30
+ ## 三、D7.1_业务流程
31
+
32
+ ### 3.1 业务流程图
33
+
34
+ #### 3.1.1 {业务流程名称}
35
+
36
+ ##### 3.1.1.1 业务流程图:
37
+
38
+ | {X.X.X.X_流程名称} |
39
+ |---|
40
+ | {插入流程图} |
41
+
42
+ ##### 3.1.1.2 流程概要说明:
43
+
44
+ {流程概要描述}
45
+
46
+ ##### 3.1.1.3 流程步骤说明:
47
+
48
+ {逐步骤说明}
49
+
50
+ ### 附录:业务流程台账(台账建议新建文档保存)
51
+
52
+ | L1流程分类 | L2流程分组 | L3业务流程 | L4子流程 | 利益相关 | 价值描述 | 流程名称 | 流程描述 | 变更类型 | 关联系统 | 关联需求编号 | 备注 |
53
+ |---|---|---|---|---|---|---|---|---|---|---|---|
54
+ | {分类} | {分组} | {编号} | {子流程编号或/} | {相关方} | {价值} | {名称} | {描述} | {新增/变更} | {系统名} | {编号} | |
55
+
56
+ ## 四、D7.2_画面原型及设计
57
+
58
+ ### 4.1 交互原型
59
+
60
+ #### 4.1.1 {模块名称}
61
+
62
+ ##### 4.1.1.1 【{页面名称}】入口:
63
+
64
+ | 编号 | 画面 | 原型 | 概要说明 |
65
+ |---|---|---|---|
66
+ | {X.X.X_P0_Page1} | {画面名称} | {原型截图} | 1. 概述:{概述}<br>2. 原型版本:{V1.0}<br>3. 责任人:{姓名}<br>4. 使用对象:{角色列表}<br>5. 流程编号:{X.X.X_P0}<br>6. 活动编号:{X.X.X_P0_S1}<br>7. 修订理由:{理由}<br>8. 原型设计链接(如有):{链接}<br>9. UI 设计稿链接:{链接} |
67
+
68
+ ### 4.2 画面迁移
69
+
70
+ #### 4.2.1 {模块名称}画面迁移
71
+
72
+ | 画面迁移图 | 概要说明 |
73
+ |---|---|
74
+ | {迁移图截图} | 1. 概述:{概述}<br>2. 版本:{V1.0}<br>3. 责任人:{姓名}<br>4. 使用对象:{角色列表}<br>5. 流程编号:{编号}<br>6. 活动编号:{编号列表}<br>7. 修订理由:{理由} |
75
+
76
+ ### 4.3 信息结构图
77
+
78
+ | 信息结构图 | 概要说明 |
79
+ |---|---|
80
+ | {结构图截图} | 1. 概述:{概述}<br>2. 版本:{V1.0}<br>3. 责任人:{姓名}<br>4. 使用对象:{角色列表}<br>5. 流程编号:{编号}<br>6. 活动编号:{编号列表}<br>7. 修订理由:{理由} |
81
+
82
+ ## 五、D7.3_报表清单
83
+
84
+ ### 5.1 报表清单
85
+
86
+ 本次迭代新增/更新报表如下:
87
+
88
+ | 编号 | 关联流程 | 关联活动 | 关联任务 | 关联需求 | 类型 | 报表名称 | 报表描述 | 更新时间 | 备注 |
89
+ |---|---|---|---|---|---|---|---|---|---|
90
+ | {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {新增/变更} | {名称} | {描述} | {日期} | |
91
+
92
+ ### 5.2 报表台账
93
+
94
+ | 编号 | 关联流程 | 关联活动 | 关联任务 | 关联需求 | 类型 | 报表名称 | 报表描述 | 更新时间 | 备注 |
95
+ |---|---|---|---|---|---|---|---|---|---|
96
+ | {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {新增/变更} | {名称} | {描述} | {日期} | |
97
+
98
+ ## 六、D7.4_业务术语字典
99
+
100
+ ### 6.1 业务术语字典
101
+
102
+ 本次迭代新增/更新术语字典如下:
103
+
104
+ | 序号 | 术语名称 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
105
+ |---|---|---|---|---|---|---|---|
106
+ | 1 | {术语} | {定义} | {名词/动词/动词短语} | {近义词} | {来源} | {日期} | |
107
+
108
+ ### 6.2 业务术语字典台账(台账建议新建文档保存)
109
+
110
+ | 序号 | 术语名称 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
111
+ |---|---|---|---|---|---|---|---|
112
+ | 1 | {术语} | {定义} | {词性} | {近义词} | {来源} | {日期} | |
113
+
114
+ ## 七、D7.5_系统功能清单
115
+
116
+ ### 7.1 系统功能清单
117
+
118
+ 本次迭代新增/更新系统功能如下:
119
+
120
+ | 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
121
+ |---|---|---|---|---|---|---|---|---|---|---|
122
+ | {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {新增/变更} | {变更内容} | {日期} | |
123
+
124
+ ### 7.2 系统功能台账
125
+
126
+ | 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
127
+ |---|---|---|---|---|---|---|---|---|---|---|
128
+ | {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {新增/变更} | {变更内容} | {日期} | |
129
+
130
+ ## 八、D7.6_系统功能处理说明书
131
+
132
+ ### 8.1 系统功能清单
133
+
134
+ 本次迭代新增/更新系统功能如下:
135
+
136
+ | 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
137
+ |---|---|---|---|---|---|---|---|---|---|---|
138
+ | {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {新增/变更} | {变更内容} | {日期} | |
139
+
140
+ ### 8.2 全局说明
141
+
142
+ #### 8.2.1 权限说明
143
+
144
+ **※ 说明本次系统功能需要的权限,若不涉及可以忽略;**
145
+
146
+ ##### 8.2.1.1 登录前
147
+
148
+ {登录前场景说明}
149
+
150
+ | 关联画面 | 用户类型 | 用户状态 | 权限说明 |
151
+ |---|---|---|---|
152
+ | {画面截图} | {用户类型} | {状态} | {权限说明} |
153
+
154
+ ##### 8.2.1.2 登录后
155
+
156
+ {登录后场景说明}
157
+
158
+ | 关联画面 | 用户类型 | 用户状态 | 权限说明 |
159
+ |---|---|---|---|
160
+ | {画面截图} | {用户类型} | {状态} | {权限说明} |
161
+
162
+ #### 8.2.2 交互说明
163
+
164
+ **※ 说明本次系统功能需要的交互说明,若不涉及/本次没有特殊的交互说明可以忽略;**
165
+
166
+ ##### 8.2.2.1 键盘交互
167
+
168
+ {键盘交互说明或"略"}
169
+
170
+ ##### 8.2.2.2 画面交互
171
+
172
+ | 画面 | 画面名称 | 交互触发 | 画面切换 | 备注 |
173
+ |---|---|---|---|---|
174
+ | {画面截图} | {名称} | {触发方式} | {切换结果} | |
175
+
176
+ ##### 8.2.2.3 弹层交互
177
+
178
+ | 画面 | 画面名称 | 交互触发 | 弹层交互 | 备注 |
179
+ |---|---|---|---|---|
180
+ | {画面截图} | {名称} | {触发方式} | {弹层效果} | |
181
+
182
+ #### 8.2.3 异常状态
183
+
184
+ | 画面 | 画面名称 | 异常状态 | 备注 |
185
+ |---|---|---|---|
186
+ | {画面截图} | {名称} | {异常描述} | |
187
+
188
+ #### 8.2.4 其他机制与规则
189
+
190
+ ##### 8.2.4.1 排序规则
191
+
192
+ | 画面 | 画面名称 | 排序说明 | 备注 |
193
+ |---|---|---|---|
194
+ | {画面截图} | {名称} | {排序规则} | |
195
+
196
+ ##### 8.2.4.2 搜索规则
197
+
198
+ {搜索规则说明或"略"}
199
+
200
+ ##### 8.2.4.3 加载机制
201
+
202
+ | 画面 | 画面名称 | 加载说明 | 备注 |
203
+ |---|---|---|---|
204
+ | {画面截图} | {名称} | {加载说明} | |
205
+
206
+ #### 8.2.5 动效说明
207
+
208
+ ##### 8.2.5.1 {动效名称}
209
+
210
+ | 画面 | 画面名称 | 动效名称 | 动效描述 | 动效细节 | 备注 |
211
+ |---|---|---|---|---|---|
212
+ | {画面截图} | {名称} | {动效名} | {动效描述} | {动效细节} | |
213
+
214
+ #### 8.2.6 画面加载顺序
215
+
216
+ ##### 全局通用画面加载顺序说明
217
+
218
+ | 适用范围 | 示例 | 动效描述 | 备注 |
219
+ |---|---|---|---|
220
+ | {适用范围} | {示例} | {加载顺序描述} | |
221
+
222
+ ### 8.3 硬件及网络说明
223
+
224
+ **※ 说明本次系统功能需要的硬件及网络说明,若不涉及/本次没有特殊的说明可以沿用整体的说明;**
225
+
226
+ #### 8.3.1 硬件设备(移动端/大屏端)
227
+
228
+ ##### 8.3.1.1 运行环境
229
+
230
+ {设备运行环境说明}
231
+
232
+ | {设备类型}品牌/型号 | {设备}系统 | {设备}系统版本 | 备注 |
233
+ |---|---|---|---|
234
+ | {品牌型号} | {系统名} | {版本要求} | |
235
+
236
+ ##### 8.3.1.2 分辨率及屏幕适配
237
+
238
+ {屏幕适配说明}
239
+
240
+ | {设备}品牌与型号 | 屏幕尺寸(对角线,mm) | 分辨率(宽x高,px) | 适配策略 | 备注 |
241
+ |---|---|---|---|---|
242
+ | {品牌型号} | {尺寸} | {分辨率} | {适配策略} | |
243
+
244
+ #### 8.3.2 硬件交互(移动端/大屏端)
245
+
246
+ {硬件交互说明}
247
+
248
+ | 权限类型 | 描述 | 必要性说明 | 示例应用场景 |
249
+ |---|---|---|---|
250
+ | {权限名} | {描述} | {必要性} | {场景} |
251
+
252
+ #### 8.3.3 硬件网络
253
+
254
+ {网络异常处理说明}
255
+
256
+ | 序号 | 场景 | 提示方式 | 提示文案 | 提示说明 | 备注 |
257
+ |---|---|---|---|---|---|
258
+ | 1 | {场景} | {页面/toast/弹窗} | {文案} | {说明} | |
259
+
260
+ #### 8.3.4 预加载内容
261
+
262
+ {预加载/缓存策略说明}
263
+
264
+ | 类型 | 预加载内容描述 | 预加载内容描述 | 清除规则 |
265
+ |---|---|---|---|
266
+ | {临时存储/固定存储} | {内容名} | {内容描述} | {清除规则} |
267
+
268
+ ### 8.4 功能模块详细说明
269
+
270
+ #### 8.4.1 {模块名称}
271
+
272
+ ##### 8.4.1.1 {功能名称}
273
+
274
+ | 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
275
+ |---|---|---|---|---|---|
276
+ | {编号} | {功能名} | {原型截图} | {活动编号} | {信息结构列表} | {画面说明} |
277
+
278
+ ### 8.5 非功能性需求说明
279
+
280
+ #### 8.5.1 性能需求
281
+
282
+ | 编号 | 模块 | 响应时间 | 吞吐量 | 并发用户数 |
283
+ |---|---|---|---|---|
284
+ | 1 | {模块名} | {响应时间要求} | {吞吐量} | {并发数} |
285
+
286
+ #### 8.5.2 可用性需求
287
+
288
+ | 维度 | 可用性 | 需求内容 |
289
+ |---|---|---|
290
+ | {维度名} | {子维度} | {需求描述} |
291
+
292
+ #### 8.5.3 安全性需求
293
+
294
+ | 大类 | 小类 | 需求内容 |
295
+ |---|---|---|
296
+ | {大类} | {小类} | {需求描述} |
297
+
298
+ ### 8.6 埋点说明
299
+
300
+ **※ 说明本次系统功能需要的埋点说明,若不涉及可以忽略;**
301
+
302
+ | 事件编号 | 统计事件埋点路径 |
303
+ |---|---|
304
+ | 1 | {埋点路径} |
305
+
306
+ ### 8.7 编码规则
307
+
308
+ **※ 说明本次系统功能需要的编码规则,若不涉及可以忽略;**
309
+
310
+ | 编码类型 | 编码类型 | 规则描述 | 示例 |
311
+ |---|---|---|---|
312
+ | {序号} | {编码类型名} | {规则描述} | {示例} |
313
+
314
+ ## 九、D7.7_要件定义自查报告
315
+
316
+ ### 9.1 产品设计方案自查清单
317
+
318
+ #### 9.1.1 账户/角色相关
319
+
320
+ 自查结果:**◎**:自查通过 **○**:不涉及 **✕**:自查不通过
321
+
322
+ | 编号 | 大类 | 小类 | 明细 | 内容 | 结果 | 备注 |
323
+ |---|---|---|---|---|---|---|
324
+ | 1 | {大类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
325
+
326
+ #### 9.1.2 数据相关
327
+
328
+ | 编号 | 大类 | 中类 | 小类 | 明细 | 内容 | 结果 | 备注 |
329
+ |---|---|---|---|---|---|---|---|
330
+ | 1 | {大类} | {中类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
331
+
332
+ #### 9.1.3 状态/交互
333
+
334
+ | 编号 | 大类 | 小类 | 明细 | 内容 | 结果 | 备注 |
335
+ |---|---|---|---|---|---|---|
336
+ | 1 | {大类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
337
+
338
+ #### 9.1.4 硬件与网络
339
+
340
+ | 编号 | 大类 | 中类 | 小类 | 明细 | 内容 | 结果 | 备注 |
341
+ |---|---|---|---|---|---|---|---|
342
+ | 1 | {大类} | {中类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
343
+
344
+ #### 9.1.5 其他
345
+
346
+ | 编号 | 大类 | 小类 | 明细 | 内容 | 结果 | 备注 |
347
+ |---|---|---|---|---|---|---|
348
+ | 1 | {大类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
349
+
350
+ #### 9.1.6 用户体验
351
+
352
+ | 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
353
+ |---|---|---|---|---|---|
354
+ | 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
355
+
356
+ #### 9.1.7 产品整体框架
357
+
358
+ | 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
359
+ |---|---|---|---|---|---|
360
+ | 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
361
+
362
+ #### 9.1.8 流程设计
363
+
364
+ | 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
365
+ |---|---|---|---|---|---|
366
+ | 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
367
+
368
+ #### 9.1.9 要件阅读体验
369
+
370
+ | 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
371
+ |---|---|---|---|---|---|
372
+ | 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
373
+
374
+ ## 十、D7.8_要件定义完成报告
375
+
376
+ ### 10.1 项目概述
377
+
378
+ #### 10.1.1 项目背景
379
+
380
+ - 项目背景:{项目的起源、目的和重要性}
381
+
382
+ - 项目目标:{主要目标和预期成果}
383
+
384
+ - 项目范围:{工作范围,包括哪些功能、模块或服务被包含在内}
385
+
386
+ #### 10.1.2 项目需求及目标达成
387
+
388
+ 检查结果:**◎**:达成 **✕**:未达成
389
+
390
+ | 编号 | 需求名称 | 需求描述 | 目标 | 功能实现 | 设计是否达成目标 | 完成时间 | 期望上线时间 |
391
+ |---|---|---|---|---|---|---|---|
392
+ | 1 | {需求名} | {描述} | {目标} | {实现内容} | {◎/✕} | {日期} | {日期} |
393
+
394
+ ### 10.2 成果物完整性自查
395
+
396
+ 检查结果:**◎**:通过 **○**:不涉及 **✕**:不通过
397
+
398
+ | 编号 | 分组 | 类型 | 成果物构成 | 成果物 | 数量(份) | 版本 | 是否完整 |
399
+ |---|---|---|---|---|---|---|---|
400
+ | 1 | {分组} | {类型} | {构成} | {成果物名称} | {数量} | {版本} | {◎/○/✕} |
401
+
402
+ ### 10.3 要件自查结果
403
+
404
+ 检查结果:**◎**:通过 **○**:不涉及 **✕**:不通过
405
+
406
+ | 编号 | 自查内容 | 自查项数量 | 结果 | 备注 |
407
+ |---|---|---|---|---|
408
+ | 1 | {自查内容} | {数量} | {◎/○/✕} | |
409
+
410
+ ### 10.4 对应体制
411
+
412
+ #### 10.4.1 项目体制
413
+
414
+ | 编号 | 分组 | 角色 | 主要职责 | 姓名 | 电话 | 备注 |
415
+ |---|---|---|---|---|---|---|
416
+ | 1 | {分组} | {角色} | {职责} | {姓名} | {电话} | |
417
+
418
+ #### 10.4.2 要件流转
419
+
420
+ 检查结果:**◎**:已完成 **○**:不涉及 **✕**:未流转
421
+
422
+ | 编号 | 分组 | 类型 | 成果物构成 | 成果物 | 数量(份) | 版本 | 是否流转 | 流转时间 |
423
+ |---|---|---|---|---|---|---|---|---|
424
+ | 1 | {分组} | {类型} | {构成} | {成果物名称} | {数量} | {版本} | {◎/○/✕} | {日期} |
425
+
426
+ #### 10.4.3 后续工作日程(草案)
427
+
428
+ | 编号 | 角色 | 事项 | 预计推进时间 | 负责人 | 备注 |
429
+ |---|---|---|---|---|---|
430
+ | 1 | {角色} | {事项} | {日期} | {姓名} | |
431
+
432
+ ### 10.5 总结
433
+
434
+ 1. **需求定义阶段**
435
+ - 需求收集:{需求收集阶段描述}
436
+ - 需求判定:{需求判定阶段描述}
437
+
438
+ 2. **需求分析阶段**
439
+ - 需求细化:{需求细化阶段描述}
440
+ - 需求验证:{需求验证阶段描述}
441
+
442
+ 3. **要件定义阶段**
443
+ - 文档构成:{文档结构描述}
444
+ - 编写内容:{编写内容描述}
445
+ - 评审与修改:{评审修改描述}
446
+ - 定稿发布:{定稿发布描述}
447
+
448
+ 4. **要件审查阶段**
449
+ - 成果物自查:{成果物自查描述}
450
+ - 要件自查:{要件自查描述}
451
+
452
+ ## 十一、D7.9_评审会议纪
453
+
454
+ | 评审记录表 | | | | |
455
+ |---|---|---|---|---|
456
+ | **项目** | {项目名} | | | |
457
+ | **领域** | {领域} | **评审时间** | {日期} | |
458
+ | **评审地点** | {地点} | | | |
459
+ | **评审资料** | 1、《{文档1}》<br>2、《{文档2}》<br>3、《{文档3}》 | | | |
460
+ | **评审内容概要** | 1、{概要1}<br>2、{概要2}<br>3、{概要3} | | | |
461
+ | **参与评审人员** | | | | |
462
+ | **姓名(应参会)** | **姓名(实际参会)** | **部门角色** | **评审意见** | **指摘** |
463
+ | {姓名} | {姓名} | {部门角色} | {同意/有条件同意} | {数量} |
464
+ | **评审指摘建议** | | | | |
465
+ | **序号** | **指摘/问题内容(纳入评审管理一览)** | | **对应时间** | **对应人** |
466
+ | {序号} | {内容} | | {时间} | {姓名} |
467
+ | **评审结论** | | | | |
468
+ | {评审结论描述} | | | | |
@@ -0,0 +1,37 @@
1
+ # 变更提案
2
+
3
+ ## 背景(Why)
4
+
5
+ - 这个变更要解决什么问题或抓住什么机会?
6
+ - 为什么现在需要解决?
7
+
8
+ ## 变更内容(What Changes)
9
+
10
+ - 列出本次工作引入的具体变更。
11
+ - 说明行为变更、移除项以及对用户可见的差异。
12
+
13
+ ## 能力(Capabilities)
14
+
15
+ ### 新增能力
16
+
17
+ - 用短横线连接的小写名称列出每个新能力。
18
+
19
+ ### 修改能力
20
+
21
+ - 列出每个 approved behavior 会发生变化的现有能力。
22
+
23
+ ## 范围(Scope)
24
+
25
+ ### 范围内(In Scope)
26
+
27
+ - 本次变更包含什么
28
+
29
+ ### 范围外(Out of Scope)
30
+
31
+ - 明确不包含什么
32
+
33
+ ## 影响(Impact)
34
+
35
+ - 影响的代码区域:
36
+ - 影响的 API 或接口:
37
+ - 依赖或涉及的外部系统: