Commit Graph

168 Commits

Author SHA1 Message Date
dafang 2645e7009e docs: record issue delivery completion 2026-07-14 13:26:59 +08:00
dafang db36f82225 fix: preserve packaged skills and runtime versions 2026-07-14 13:24:08 +08:00
Wyatt Fang c2572f4940 feat: add risk-tiered feature lanes (#48)
* feat: add risk-tiered feature lanes

* fix: align plugin docs with canonical repository
2026-07-14 12:03:09 +08:00
dafang 69d63ebe09 fix: align plugin docs with canonical repository 2026-07-14 11:41:22 +08:00
dafang 2248241634 feat: add risk-tiered feature lanes 2026-07-14 11:37:15 +08:00
liuzhengdong 51312c130d Create CNAME 2026-07-13 23:09:49 +08:00
Wyatt Fang 8538f750b7 docs: fix star history 404 2026-07-13 23:03:46 +08:00
Wyatt Fang e6236917a2 docs: refine repo group space 2026-07-13 23:02:29 +08:00
dafang 00c78b38a6 release: CodeStable 1.0.3 2026-07-11 10:39:45 +08:00
Wyatt Fang 30fecaae5e release(codestable): ship skill workflow v1.0.2 (#41)
收敛 CodeStable 主入口、runtime preflight、goal driver 与 skill 工程化评测闭环。

- 根 cs 对行动请求同轮直转,咨询与介绍保持非执行
- feature/issue/refactor/epic/docs 按仓库事实恢复,旧 stage skill 保留兼容薄壳
- repo-local runtime 支持版本检测、安全自动同步和显式 refresh-runtime
- 完成 Codex/Claude marketplace 1.0.2、升级文档和回归/评测证据

验证:215 tests passed;package/runtime/diff checks passed;独立 review 与 QA 无 unresolved blocking/important findings。
v1.0.2
2026-07-10 15:23:56 +08:00
Wyatt Fang cd7e1d33f0 refactor: package CodeStable plugin distribution (#34)
* refactor: package codestable plugin distribution

* docs: restore README workflow details

* refactor: remove browser bridge from distribution

---------

Co-authored-by: QA Bot <qa@example.invalid>
v0
2026-07-02 09:56:21 +08:00
Wyatt Fang f1862c7fe1 Enhance coding and review prompts (#31) 2026-07-01 10:45:44 +08:00
liuzhengdong 912e4fcd27 Merge pull request #30 from dafang/main
更新 CodeStable 工作流技能约束
2026-07-01 08:41:35 +08:00
dafang d453aa74b9 Merge remote-tracking branch 'upstream/main' 2026-06-30 17:29:12 +08:00
dafang b5952b1b74 fix: require feature impl skill in goal loop 2026-06-30 17:24:05 +08:00
dafang 4aa2b351d0 feat: add architecture deepening scan to refactor 2026-06-30 17:00:27 +08:00
dafang 98d7c7e14e feat: add codebase design checks to design skills 2026-06-30 16:46:45 +08:00
dafang e927109a3e feat: add embedded TDD guidance for feature implementation 2026-06-30 16:30:21 +08:00
dafang 7170e2d79f fix: enforce independent design review gates 2026-06-30 15:24:07 +08:00
liuzhengdong baa2eb2e4d Merge pull request #27 from dafang/main
Improve CodeStable workflow gates and skill guidance
2026-06-30 07:18:08 +08:00
dafang 875f77ae19 docs: refine CodeStable skill instructions 2026-06-29 19:14:20 +08:00
dafang a705c640e5 fix: stop installing protected main push hooks 2026-06-29 17:38:56 +08:00
dafang d3192bf577 docs: clarify task agent review rules 2026-06-29 17:17:34 +08:00
dafang 69d33ce4eb docs: localize task agent workflow rules 2026-06-29 16:46:23 +08:00
dafang d1a5d2269b docs: standardize task agent terminology 2026-06-29 16:23:57 +08:00
dafang 060c8c5326 docs: clarify QA and acceptance agent boundaries 2026-06-29 16:01:15 +08:00
dafang ac31305d99 docs: tighten agent-facing OCR scope rules 2026-06-29 15:28:09 +08:00
dafang 20b35d7e25 docs: bound OCR review scope per roadmap feature 2026-06-29 15:02:17 +08:00
dafang 9bb946e9ba docs: clarify OCR untracked review scope 2026-06-29 14:48:46 +08:00
dafang 7b58fb2f11 fix: dod-runner 顶层优先去重 + cs-code-review OCR 限定范围排除产物
两个从 goal 执行中暴露的问题:

1) DoD 命令重复执行(上个 commit 的回归):collect_commands 把顶层 +
   step-level 都读并合并,checklist 两处都有同组命令时会执行两遍。
   改为「顶层优先」——顶层 dod.commands 存在即唯一源,不再叠加 step;
   仅当无顶层时 fallback step-level。既不重复又向后兼容。
   测试改 test_top_level_takes_precedence_no_duplicate(顶层+step 同 id
   只执行一次)。

2) OCR 横向扫描 .codestable 等非 feature 文件:ocr review 默认 workspace
   模式审 untracked,业务项目 .codestable/(goal 执行包,未 gitignore)被
   横扫污染结果。ocr 第三方无 --exclude,故在 cs-code-review 环节B 加两道
   控制——调用时优先 ref 范围(--from/--to 排除 untracked 产物);结果过滤
   兜底:丢弃 .codestable/、. 开头目录、gitignore 命中路径的 finding。

测试:62 passed。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 14:15:10 +08:00
dafang efe818f95f Merge branch 'worktree-fix+dod-runner-schema' 2026-06-29 14:01:09 +08:00
dafang 4645a4316c fix: dod-runner 识别顶层 dod.commands(权威 schema),兼容 step-level
权威 checklist schema(cs-feat-design/reference.md「DoD Contract」)定义
dod 为顶层字段(与 steps/checks 同级),dod.commands 是机读权威源。但
codestable-dod-runner.py 的 collect_commands 只遍历 steps[*].dod.commands
(step-level),读不到顶层 → 返回 skipped。goal/gate 执行时表现为 DoD 命令
被跳过,迫使使用者把命令挪到 step 下绕过,违背 schema。

修复:collect_commands 先读顶层 dod.commands(权威),再兼容 step-level
(向后兼容已挪到 step 下的 checklist),两者合并。

测试:新增 tests/test_codestable_dod_runner.py 5 例——顶层命令被执行
(回归)、step-level 仍支持、顶层+step 合并、non-core 失败仅 warning、
无命令 skipped。全套通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 14:00:24 +08:00
dafang 06c77fc3fb Merge branch 'worktree-fix+branch-guard-worktree' 2026-06-29 13:28:43 +08:00
dafang 1635acd41b fix: branch-guard 跟随真实 worktree + owner-publish 默认取 upstream remote
两个影响 fork+worktree 工作流的缺陷:

Bug1(真 bug):PreToolUse hook 传 --root=CLAUDE_PROJECT_DIR(主仓库),
guard_payload 据此判 branch=main,且 worktree 位于主仓库子目录、被编辑文件
被当主仓库实现文件 → 在 worktree typed 分支改实现文件也被误拦,worktree
执行正道走不通。修复:guard 按"被操作对象的真实 worktree"判定——
新增 worktree_of()/collect_raw_paths()/edit_impl_paths_on_protected();
Edit/Write 逐文件按其 worktree 分支判定(typed 放行);Bash 用 payload.cwd
的 worktree;拿不到时兜底回退原 root,不削弱既有保护。

Bug2(易用性):owner-publish begin 默认对比 origin/main,fork 用户 origin
常是上游镜像,合规发布通道不可用。修复:--remote 默认取当前分支 upstream
的 remote(回退 origin);不匹配/fetch 失败的报错加 fork 引导。

测试:tests +5(worktree root=main 放行回归、main 仍拦、Bash cwd worktree、
detect_default_remote、begin 自定义 remote);全套 57 passed。
文档:branch-guard-hooks.md 说明按文件实际 worktree 判定 + fork 用 --remote。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 13:28:14 +08:00
dafang bf95687e3b Merge branch 'worktree-feat+ocr-onboard-doctor' 2026-06-29 12:55:30 +08:00
dafang eb2a02fe32 feat: 固化 ocr 配置坑——onboard 用 provider 体系 + doctor OCR 体检
反复踩的根因:onboard 文档教的是旧 llm.* 块写法,在 ocr v1.x 不生效
(配了被忽略,ocr llm test 卡超时 context deadline exceeded)。

- cs-onboard OCR 段重写:先 which ocr 已装跳过安装;配置改用正确的
  provider/providers 体系(url 字段非 base_url,anthropic 自动拼 /v1/messages),
  明确警告旧 llm.* 块的坑;收尾跑 doctor 体检
- codestable-doctor.py:容错位置参数(doctor . 等价 --root .);新增 OCR
  环境静态体检 ocr_health()——查 which ocr + 解析 config.json,识别
  not-installed/unconfigured/misconfigured(含旧 llm.* 残留)/configured
  并给精确修复指引;只读不发网络、不改全局配置
- cs-code-review 环节B:not-available 提示指向 onboard,点明超时多半是旧块

测试:52 passed

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 12:50:56 +08:00
dafang 3ab2c4ac85 fix: avoid duplicate brainstorm onboard dirs 2026-06-29 08:00:12 +08:00
liuzhengdong 2001285a64 Merge pull request #25 from dafang/main
feat: onboard CodeStable gate runtime and review checks
2026-06-29 07:02:22 +08:00
Wyatt Fang bb54dbc9a8 Merge pull request #2 from dafang/cs-roadmap-hook-gates-goal
feat: add roadmap goal hook gates protocol
2026-06-29 06:54:44 +08:00
dafang 5240ecaae7 docs: clarify onboard gate validation limits 2026-06-28 22:44:31 +08:00
dafang 13c278cb85 fix: add roadmap goal final consistency gate 2026-06-28 22:01:01 +08:00
dafang 9c2ec15f4b fix: harden roadmap gate dogfood findings 2026-06-28 21:34:44 +08:00
dafang b614a17351 fix: install roadmap gates via onboard 2026-06-28 21:02:25 +08:00
dafang 9660922363 feat: add codestable gate scripts 2026-06-28 20:52:55 +08:00
dafang 3a4ecba3c5 feat: add roadmap goal hook gates protocol 2026-06-28 20:31:10 +08:00
dafang 9f447a6fce docs: onboard 澄清 ocr 需独立配 LLM,不复用 agent 模型
ocr 是独立 CLI 进程,agent 只是替它执行 ocr review 命令,ocr
自己去连配置好的 LLM backend——"已经在 codex/claude 里"无法
省掉这步配置。官方 open-code-review skill 也明确 ocr review
前 ocr llm test 必须通过。补一句澄清避免误读。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-27 09:56:03 +08:00
dafang 3d1c882ef9 feat: review 检测改为主 agent 运行时自检 + onboard 可选装 OCR
检测哲学转变:工具可用性由主 agent 在运行时自检(看自己手上
有没有 mcp__paseo__create_agent / Agent / ocr),不再靠 Python
脚本猜环境变量和 CLI 路径——主 agent 最清楚自己的工具。

- 删除三份 detect-review-agent.py(cs-code-review /
  cs-roadmap-review / cs-feat-design-review),脚本的 env 猜测
  本就不可靠,且 ocr 检测一条 which 即可
- cs-code-review:独立 reviewer 重构为「双环节」
  · 环节 A 独立隔离 agent(Paseo create_agent 优先→原生 Agent
    subagent),gate 必需,独立上下文避免确认偏误
  · 环节 B OCR 行级扫描(which ocr 自检,装了就跑,缺了降级)
  · reviewer 字段 subagent+ocr / subagent / ocr / self
- cs-roadmap-review / cs-feat-design-review:审文档不审代码,
  只保留环节 A 自检(Paseo→原生 subagent),不引入 OCR
- cs-onboard:新增可选步骤,询问 owner 后全局
  npm install -g @alibaba-group/open-code-review,并提示配 LLM;
  绝不替 owner 硬编码 API key

测试:52 passed

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-27 09:09:22 +08:00
dafang 1e2d24dd1d feat: cs-code-review 支持三路并行独立 reviewer
- 独立 reviewer 从单一 Paseo 扩展为三路并行:
  Paseo subagent / 原生 Agent tool / OCR CLI,互不排斥
- detect-review-agent.py:新增 native_agent_tool 检测
  (CLAUDE_CODE_ENTRYPOINT / CODEX_AGENT / claude / codex CLI)
  和 ocr_cli 检测,recommendation 改为输出 parallel_reviewers 列表
- SKILL.md:重写「独立 reviewer 增强项」——明确三路定位
  (Paseo/native-agent 做 spec-aware 独立上下文审查,
  OCR 做行级代码扫描),OCR High/Medium/Low→严重度映射,
  合并原则、reviewer 字段、退出条件、坑点同步更新
- report-template.md:reviewer 字段扩展为四值
  (subagent+ocr / subagent / ocr / self),
  Independent Review 小节按三路分行记录状态

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-06-27 08:49:22 +08:00
liuzhengdong 56b44384f0 Merge pull request #24 from dafang/main
feat: 流程 Gate 体系、多技能新增与工具链完善
2026-06-27 07:27:04 +08:00
dafang babac7d5b3 docs: 更新 README——实体/流程/技能总览/工作流示意同步新改动
- badge 数量 27 → 29
- 实体表格:补充 roadmap-review/impl-goal 说明、feature Gate 描述、cs-note 说明
- 流程表格:新增"大需求端到端"行,所有 Gate 用 ✦Gate 标注
- 技能总览:补入 cs-feat-design-review、cs-feat-qa、cs-roadmap-review、
  cs-roadmap-impl-goal、cs-audit、cs-note、cs-docs-neat 共 7 个技能
- 工作流示意:feature 流展开三道 Gate 阻断逻辑,补入 roadmap-review/
  impl-goal、goal 流,横切层加入 cs-note 和 cs-docs-neat

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-06-26 23:55:16 +08:00