zhuyongxin b94ee31cb1 sm-flow v4.1: add pre-apply research checkpoint to reduce rework
Based on real execution review (shandong-intent-sync), apply phase
suffered from 4-5 rework cycles due to insufficient upfront research.

Changes:
- grill: add technical implementation dimension to question pool
- apply: add mandatory pre-apply checkpoint (15-20min research)
  - read reference implementations thoroughly
  - grep key tech stack patterns
  - form tech stack checklist in decisions.md
- apply: add incremental implementation guidance
- apply: add first-module alignment check
- apply: add fast-fail rule (≥2 rework → pause)

Expected impact:
- Rework: 4-5 cycles → 0-1 cycle (-80%)
- Core feature empty impl: 100% → 0%
- ROI: 200% (invest 20min, save 60min)

Complexity: +55 lines to phase-contracts.md (+20%)
Approach: simplified version (plan B) to balance value vs overhead

Docs:
- phase-contracts.md: updated grill + apply phases
- workflow.md: added v4.1 evolution chapter
- phase-contracts-v4.1-changelog.md: detailed change log
- sm-flow-execution-review-shandong-intent-sync.md: source review
2026-06-23 11:27:32 +08:00

github-learn

个人知识学习与 agent workflow 实验仓库。

当前核心内容

路径 作用
knowledge/entries/knowledge_YYYYMMDD_*/ 知识条目源文件与渲染 HTML
knowledge-index.html 知识索引页面,由 scripts/update-knowledge-index.sh 生成
scripts/ 本仓库维护脚本
openspec/ 当前 OpenSpec 变更工作区与归档
devflow/ 人类可读项目档案、glossary、复合知识
.agents/skills/ Codex/agent 使用的本地运行时 skills,当前重点是 sm-flow
.claude/skills/ Claude 版本 skills 与 OpenSpec skills
skill-workbench/ skill 创建、设计文档、历史文档与验证沙箱

上下文入口

  • 领域词汇表真理源:devflow/glossary/CONTEXT.md
  • 根目录 CONTEXT.md 仅保留兼容性重定向。

历史内容

  • skill-workbench/generated-skills/sm-flow/:本仓库新增的 sm-flow skill 源产物,只放可安装 skill 本体。
  • skill-workbench/generated-skills/skills/:早期 Explore Skill Family,只放 skill 本体。
  • skill-workbench/docs/sm-flow/workflow.md:sm-flow 的设计演进文档。
  • skill-workbench/docs/explore-essence-follow/latest-design.md:explore、essence、follow 三个学习型 skill 的最新设计总结。
  • .agents/skills/sm-flow/:sm-flow 的运行时安装副本,用于当前 Codex 会话加载。
  • skill-workbench/history/changelog/:早期 skill family 变更记录。
  • skill-workbench/history/docs/:早期设计、OpenSpec 与 agent 文档。
  • skill-workbench/validation/project/、skill-workbench/validation/tmp2/:验证 skill 时使用的第三方源码和临时报告。
  • skill-workbench/validation/skills-lock.json:验证安装 mattpocock skills 时生成的锁文件。
S
Description
No description provided
Readme
683 KiB
Languages
HTML 72.6%
Shell 13.9%
PowerShell 7%
Python 6.5%