skills/codestable__codestable
1
0
Fork 0
mirror of https://github.com/codestable/CodeStable.git synced 2026-09-19 09:03:09 +08:00
Code Issues Packages Projects Releases Wiki Activity
158 Commits 12 Branches 4 Tags
v0
Commit Graph

158 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
dafang 9517615f86 feat: 产出物默认中文表达 
明确指令让 plan / plan-review / code-review 等所有落盘产出正文默认用中文：
- shared-conventions 第8节报告语言策略：默认从"对话语言"改为"中文"，仍可被 attention 覆盖
- attention.md 最小模板（cs-onboard/reference.md）：新增「报告语言」节默认中文
- cs-feat-design / cs-feat-design-review / cs-code-review 三个产出技能加明确中文指令
- 机器状态（YAML / JSON / frontmatter）保持机读格式不翻译

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-26 16:39:02 +08:00
dafang e4d41f3f67 Merge branch 'feat/merge-task-codereview-gates' 2026-06-26 06:59:08 +08:00
dafang b45ed95adb refactor: 适配上游 refactor 残留 
- 旧技能名全仓清零：cs-learn/trick/decide/explore→cs-keep、cs-libdoc→cs-doc-api、
  cs-guide→cs-doc-tutorial、cs-arch→cs-domain
- codestable_common.py 的 KNOWN_SKILL_DIRS 按实际技能目录重建（含 cs-code-review/cs-keep/
  cs-domain/cs-doc-*，去掉已删的 cs-learn/decide/explore/trick 与未装的 using-codestable）
- SKILL_CATALOG / WORKFLOW（中英）刷新到 28 个 cs-* 技能，feature 链路体现 cs-code-review
- cs-docs-neat 的 .codestable/architecture/ 引用改为 requirements/CONTEXT.md（cs-domain 领域模型）
- asset/ 历史文档保持原样

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 22:48:48 +08:00
dafang 55605d91f9 Merge origin/main (上游 refactor) into feat/merge-task-codereview-gates 
吸收上游 74f1aa3 重构：compound 四件套合一 cs-keep、cs-libdoc→cs-doc-api、
cs-guide→cs-doc-tutorial、删 cs-arch 立 cs-domain、compound 改纯 markdown。
保留我们的 PR 工作：cs-code-review review↔gate、cs-goal、gate 工具链、
worktree feat/fix/refactor 命名、brainstorm/report-language；cs-task 保持删除。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 22:40:15 +08:00
Wyatt Fang 9d13c42fc3 Merge pull request #1 from dafang/feat/merge-task-codereview-gates 
feat: 合并 cs-task/cs-goal/cs-code-review 与 gate 工具链
 2026-06-25 22:13:29 +08:00
dafang 4d9c3e02ea refactor: worktree 执行分支前缀语义化 
分支前缀按 CodeStable 执行流类型表达改动语义，而非笼统的 worktree/：
- feature → feat/{slug}，issue → fix/{slug}，refactor → refactor/{slug}
- quarantine 隔离分支 worktree/quarantine-{slug} → chore/quarantine-{slug}
- worktree 存放路径 .worktree/ 保留不变
- 同步 branch-guard 文案、execution-conventions、branch-guard-hooks、cs-onboard、tests 示例

注：gate 只校验不自动建常规分支；前缀是文档约定 + quarantine 默认命名

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 22:07:43 +08:00
dafang d10f2ac335 refactor: worktree 命名去 Codex 绑定 
- 执行 worktree 分支 codex/* → worktree/*，路径 .codex/worktrees → .worktree
- worktree-gate quarantine、ai-branch-guard 文案、execution-conventions、
  branch-guard-hooks、cs-onboard/SKILL 的约定同步
- tests 示例分支名/路径/函数名同步
- 保留外部平台标识：Codex CLI 真实路径(~/.codex)、hooks.codex.json、CODEX_PROJECT_DIR

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 21:44:21 +08:00
liuzhengdong 74f1aa3dee refactor: 精简 cs-* 体系——compound 四件套合一、外部文档改名、删 architecture 立 cs-domain 
三刀连贯重构，让体系更符合"grill-me 风格、产物聚合在 .codestable/、人在环"的初衷：

第一刀（compound 四件套合一）：
- 删 cs-learn / cs-trick / cs-decide / cs-explore，合并成 cs-keep
- compound 文件改纯 markdown 无 frontmatter，靠 grep 检索（淘汰 search-yaml 在 compound 上的角色）

第二刀（外部文档改名）：
- cs-libdoc → cs-doc-api（不再绑死"库"语义，凡是 API 参考都适用）
- cs-guide → cs-doc-tutorial（明确是任务导向的 how-to / tutorial）

第三刀（删 architecture，立 cs-domain）：
- 删 cs-arch 技能和 architecture/ 目录（长期实践证明是累赘而非资产）
- 新建 cs-domain 技能管 CONTEXT.md 术语 + adrs/ 架构决策（守门 3 判据 + Nygard 四节）+ 单/多 context 拓扑
- cs-feat-accept 的 Phase 5 从"代写架构 doc"改为"盘点领域影响 + 提示 cs-domain"，越权问题自动消失
- cs-brainstorm 加横切：讨论拍板符合 ADR 3 判据就路由到 cs-domain

净变化：cs-* 技能 25 → 22；行数 +400 / −2000+
 2026-06-25 21:30:03 +08:00
dafang ba0b4188ce feat: 对接 review↔gate 锚点并吸收 stella 增量 
- review↔gate：gate 改认 {slug}-review.md（common + validate 两份 review_file_for），
  cs-code-review 产物补 frontmatter reviewer: subagent|self 作放行锚点；文档产物名同步
- cs-feat-accept：吸收 stella 的 Global Route Governance(L3) + 7 条 delta 回写判据，
  禁止 accept 阶段自由重写 requirement；详情/final audit/坑拆入 reference.md（SKILL 338→292）
- cs-brainstorm：4 处加 approval-report 检查点
- cs-onboard：骨架加 brainstorms/brainstorm 目录、报告语言偏好；
  shared-conventions 加报告语言策略 + 执行约定/worktree 反模式两节
- 吸收 stella gate 测试 4 个（排除依赖 maintainer 的 phase23），review 文件名断言改 review.md
- 保留我们的 cs-code-review/feat-qa/audits/hooks，不照搬 stella 的删除

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 19:52:25 +08:00
dafang 71a7111307 refactor: 移除 cs-task skill 及其全部接入（保留 gate 工具链） 
- 删除 cs-task/ 目录（SKILL.md + reference.md）
- 移除 30 个 cs-*/SKILL.md 的「## Task 接入」段，相邻「## 执行 gate」段全部保留
- 移除 cs-goal 的 Task Integration 段
- 清理 README/cs/system-overview/shared-conventions 里的 cs-task 引用，
  以及 .codestable/tasks 目录约定与 onboard gitkeep/检查
- gate 工具链（worktree/commit gate、tools、hooks、branch-guard）原样保留
- 技能数 badge 36 → 35

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 16:50:41 +08:00