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
Files
7f4e4ba4f3ec21c040824e0c0bdb4df0b9258c2a
codestable__codestable/WORKFLOW.md
T

53 lines
2.6 KiB
Markdown
Raw Normal View History

feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
# CodeStable v2 工作流与项目结构
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。
2026-07-10 15:23:56 +08:00
refactor(skills): v2 thin-harness — 32 skills -> 8 thin responsibility contracts - Rewrite 8 kept skills as thin harness (31-49 lines each, ~24k -> 316 lines total): cs / cs-onboard / cs-feat / cs-issue / cs-refactor / cs-code-review / cs-epic / cs-keep - Delete 24 skills: 14 compat stubs, cs-note+cs-feedback (merged into cs-keep), cs-audit (mode of cs-code-review), cs-req+roadmap family (merged into cs-epic), cs-goal / cs-brainstorm / cs-domain / cs-docs family (folded into entries) - Delete all stage protocols, 13 onboard references, 19 runtime tools/gates - Project data reduced to .codestable/{attention.md, lessons/, work/}; ordinary tasks produce zero artifacts; v1 legacy kept read-only + grep-discoverable - Tests: drop v1 state-machine/wording suites, update contracts/CLI-distribution suites to v2 baseline, add thin-harness regression; xfail pre-existing build-cs-skill red (broken on main 7bed4ed) - Sync SKILL_CATALOG / WORKFLOW / README (zh+en) / CLAUDE.md / AGENTS.md to v2 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 09:11:04 +08:00
## 工作流
docs: split codestable overview docs
2026-06-18 16:28:16 +08:00
feat(cs): dispatch clear action requests in the same turn Dogfood feedback (session 001c553b): calling cs with a concrete request recommended an entry and then waited for the user to re-invoke it — one confirmation too many. cs now classifies intent: clear action requests announce the chosen entry in one line and continue executing under that skill's discipline in the same turn; advice requests still get a recommendation only; ambiguous requests that would materially change what happens next get exactly one focused question. Handoff does not widen authority — the target skill's gates and checkpoints apply unchanged. Safety anchors and docs (SKILL_CATALOG / WORKFLOW / README zh+en) synced. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 20:44:37 +08:00
CodeStable v2 是 8 个独立安装的 thin-harness skill，加一个项目记忆闭环。`cs` 判别用户
此刻要什么：明确行动诉求**同轮直转**对应 skill 并继续执行；咨询只给推荐；无诉求时介绍体系。
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
docs: split codestable overview docs
2026-06-18 16:28:16 +08:00
```text
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
不确定入口 -> cs
仓库接入 / v1 升级 -> cs-onboard
新功能 -> cs-feat ---------\
refactor(skills): rename cs-code-review to cs-review with a single compat alias The skill has outgrown its name — it reviews designs and runs repo audits, not only code. cs-review is the canonical entry; cs-code-review ships as the one thin forwarding alias (the explicit exception to the no-shim rule, kept for the carried-over v1 habit). References in cs / cs-feat / cs-epic / cs-issue / cs-refactor, the Codex agent config, both contract-test skill sets (V2_SKILLS + SHIM_SKILLS), and all public docs / CHANGELOG / ADR-004 updated. Also refreshed the leftover v1 openai.yaml wording. 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-31 09:08:35 +08:00
bug / 行为异常 -> cs-issue ----------> cs-review（高风险或按需）
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
行为等价重构 -> cs-refactor ------/
大需求拆解 -> cs-epic -> cs-feat / cs-issue / cs-refactor
经验与项目记忆 -> cs-keep
docs: split codestable overview docs
2026-06-18 16:28:16 +08:00
```
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
执行强度与风险相称：
feat: add risk-tiered feature lanes
2026-07-14 11:37:06 +08:00
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
- `cs-feat` 默认直接理解、实现、验证；公开契约、数据、权限、并发或真实方案取舍先经用户确认。
- `cs-issue` 先建立能明确变红的验证，再修复并证明它变绿。
- `cs-refactor` 先建立等价性证据，分步改动并持续保持验证为绿。
- `cs-epic` 用一个 work 文档维护子项、依赖和验收；拆解与边界变更由用户确认。
refactor(skills): rename cs-code-review to cs-review with a single compat alias The skill has outgrown its name — it reviews designs and runs repo audits, not only code. cs-review is the canonical entry; cs-code-review ships as the one thin forwarding alias (the explicit exception to the no-shim rule, kept for the carried-over v1 habit). References in cs / cs-feat / cs-epic / cs-issue / cs-refactor, the Codex agent config, both contract-test skill sets (V2_SKILLS + SHIM_SKILLS), and all public docs / CHANGELOG / ADR-004 updated. Also refreshed the leftover v1 openai.yaml wording. 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-31 09:08:35 +08:00
- `cs-review` 是只读独立审查，也承接模块或全仓 audit。
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
- `cs-keep` 把高频事实压进 attention，把可复用经验写成 lesson。
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。
2026-07-10 15:23:56 +08:00
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
普通任务不生成阶段文档。diff、测试输出和交付说明就是证据；只有跨会话、多人交接或用户
要求留痕时，才维护一个 work 文档，完成后删除或按用户要求保留。
## 项目记忆
`/cs-onboard` 为新项目创建最小骨架：
docs: split codestable overview docs
2026-06-18 16:28:16 +08:00
```text
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>
2026-07-02 09:56:21 +08:00
.codestable/
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
├── attention.md # 每次会话需要的少量项目事实，最多 25 条
├── lessons/ # 一条经验一个 Markdown 文件，按关键词检索
feat(skills): type-prefixed work documents and epic sub-design linking Dogfood feedback: work/ entries like paseo-native-session-bridge.md give no clue whether they are a feature, issue, or epic when it is time to compress them. Two rules, zero new mechanism: - work docs are named with a type prefix (feat-/issue-/refactor-/epic-), so ls classifies and wrap-up knows the destination per type - epic sub-designs are inline-first: a few lines under the item entry; only risk-escalated items get their own work/feat-{slug}.md, carrying 'epic: {slug}' frontmatter with a backlink from the epic item row — flat files with two-way pointers, no subdirectories. Epic wrap-up now also sweeps its sub-item work docs. Docs (WORKFLOW/README zh+en) synced. 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-31 09:51:06 +08:00
└── work/ # 活动中的跨会话任务，文件名带类型前缀 feat-/issue-/refactor-/epic-，完成即清
docs: split codestable overview docs
2026-06-18 16:28:16 +08:00
```
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
skill 专属 context 与 helper 分别由 owning skill 的 `references/` 和 `scripts/` 提供。项目
事实放在上述目录或项目既有文档与 ADR 中。skill 不读取 sibling skill 文件，也不依赖集中式
onboard runtime；worktree、branch 和 agent backend 策略由宿主或 owner 决定。
## v1 升级边界
refactor(skills): v2 thin-harness — 32 skills -> 8 thin responsibility contracts - Rewrite 8 kept skills as thin harness (31-49 lines each, ~24k -> 316 lines total): cs / cs-onboard / cs-feat / cs-issue / cs-refactor / cs-code-review / cs-epic / cs-keep - Delete 24 skills: 14 compat stubs, cs-note+cs-feedback (merged into cs-keep), cs-audit (mode of cs-code-review), cs-req+roadmap family (merged into cs-epic), cs-goal / cs-brainstorm / cs-domain / cs-docs family (folded into entries) - Delete all stage protocols, 13 onboard references, 19 runtime tools/gates - Project data reduced to .codestable/{attention.md, lessons/, work/}; ordinary tasks produce zero artifacts; v1 legacy kept read-only + grep-discoverable - Tests: drop v1 state-machine/wording suites, update contracts/CLI-distribution suites to v2 baseline, add thin-harness regression; xfail pre-existing build-cs-skill red (broken on main 7bed4ed) - Sync SKILL_CATALOG / WORKFLOW / README (zh+en) / CLAUDE.md / AGENTS.md to v2 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 09:11:04 +08:00
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
v2 不迁移或清理 v1 项目的历史目录。已有 `requirements/`、`roadmap/`、`features/`、
`issues/`、`compound/`、tool、gate、hook 和 manifest 原样保留；新 skill 可以按任务关键词
检索其中的项目知识，但不会执行旧 runtime，也不会继续生成 v1 阶段产物。
docs: split codestable overview docs
2026-06-18 16:28:16 +08:00
feat: land owner's v2 release line — 2.0.0, ADR-004, v2 contract tests Absorbed from the owner's working tree (his versions take precedence): - VERSION 2.0.0, CHANGELOG, plugin manifests, marketplace metadata - ADR-004 (project knowledge, not runtime distribution; supersedes 001) plus ADR-001/002/003 updates - Three new v2 contract test suites (architecture / documentation / experiment-archive integrity) and rewritten skill-contracts, cli-distribution (exact retired-set + E2E fixture), selfref suites - Rewritten root docs (README/WORKFLOW/SKILL_CATALOG zh+en, CLAUDE/AGENTS) with v1.0.4 retirement mapping and precise skills-CLI upgrade procedure - eval-cs-skill v2 adaptation (6 files), build-cs-skill refinements Full suite: 96 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 13:38:57 +08:00
v1.0.4 的 32 个 skill 在 v2 收敛为 8 个；其余 24 个入口已退役且不随 v2 安装。完整映射见
[SKILL_CATALOG.md](./SKILL_CATALOG.md)。
Reference in New Issue Copy Permalink