Skip to content
This repository was archived by the owner on Sep 28, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 7 additions & 12 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
},
{
"name": "clarify",
"version": "0.1.0",
"version": "0.1.1",
"source": "./plugins/clarify"
},
{
Expand All @@ -38,37 +38,32 @@
},
{
"name": "skill-maintenance",
"version": "0.1.1",
"version": "0.1.2",
"source": "./plugins/skill-maintenance"
},
{
"name": "workcoding",
"version": "0.1.0",
"source": "./plugins/workcoding"
},
{
"name": "note",
"version": "0.1.0",
"version": "0.1.1",
"source": "./plugins/note"
},
{
"name": "skill-authoring",
"version": "0.1.2",
"version": "0.1.3",
"source": "./plugins/skill-authoring"
},
{
"name": "flow",
"version": "0.1.5",
"version": "0.1.6",
"source": "./plugins/flow"
},
{
"name": "flow-steps",
"version": "0.1.4",
"version": "0.1.5",
"source": "./plugins/flow-steps"
},
{
"name": "practices",
"version": "0.1.3",
"version": "0.1.4",
"source": "./plugins/practices"
}
]
Expand Down
2 changes: 1 addition & 1 deletion .github/public-tree-policy.json
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@
"tests/fixtures/public-surface/",
"packages/mounts/tests/public-tree.test.ts",
"packages/harness-engine/tests/quality/stage6b.test.ts",
"plugins/workcoding/skills/workcoding/evals/runs/2026-09-06/baseline.zip"
"_archive/plugins/workcoding/skills/workcoding/evals/runs/2026-09-06/baseline.zip"
],
"deniedTokenHashes": [],
"maxFileBytes": 1000000,
Expand Down
2 changes: 1 addition & 1 deletion entrypoints/agent-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
3. `openspec/changes/`:已归档的交付证据(纯 Markdown 记录,不再有 Change 生命周期);
4. ~~`_bmad-output/`:迁移输入和历史证据,完成覆盖核验后退役~~ —— **2026-09-02 已整体删除**,覆盖核验永不发生(理由见上方推翻说明)。权威结构现为上述三层。

> **OpenSpec 工具与工作流已于 2026-09-08 退役(负责人裁定「干掉」)。** `@fission-ai/openspec` 依赖、`openspec/config.yaml`、`openspec/schemas/` 已删除;此前承载 Change 生命周期、机器状态门与 opsx 命令的 `.delivery-spec-runtime` 子模块已于 PR #67 拆除。`openspec/specs/`、`openspec/intake/`、`openspec/changes/archive/` 作为负责人裁决与交付证据的记录原样保留,可读可引用,但新工作不再套入 OpenSpec,也不再产生新的 Change 目录(与 `plugins/workcoding/工作项资产与人机审阅.md` 一致)。
> **OpenSpec 工具与工作流已于 2026-09-08 退役(负责人裁定「干掉」)。** `@fission-ai/openspec` 依赖、`openspec/config.yaml`、`openspec/schemas/` 已删除;此前承载 Change 生命周期、机器状态门与 opsx 命令的 `.delivery-spec-runtime` 子模块已于 PR #67 拆除。`openspec/specs/`、`openspec/intake/`、`openspec/changes/archive/` 作为负责人裁决与交付证据的记录原样保留,可读可引用,但新工作不再套入 OpenSpec,也不再产生新的 Change 目录(与 `_archive/plugins/workcoding/工作项资产与人机审阅.md` 一致;原在 `plugins/workcoding`,agent-system#123 归档)。

当任务落在本仓时,先读取仓库根 `README.md` 与 `AGENTS.md` 的当前权威声明,再按模式继续(`_archive/authority/00-map.md` 只是历史索引,不再必读):

Expand Down
2 changes: 1 addition & 1 deletion packages/sk/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ sk list 库存清单(含同名冲突标记)
sk profiles profile 一览(按声明计数,显示缺链与未接入项)
sk show <profile> 只读查看声明、组、技能、描述与链接健康度;缺链提示 sync 修复
sk new <profile> 新建空 profile 声明
sk add <profile> <模式...> 加入声明并装配(技能名 glob 或 @组名,如 sk add 写作 grilling @workcoding)
sk add <profile> <模式...> 加入声明并装配(技能名 glob 或 @组名,如 sk add 写作 grilling @practices)
sk rm <profile> <模式...> 按声明移除技能(支持 glob 与 @组名;缺链或目标失效也可移除)
sk sync <profile> 校验声明、修复投影、重生成客户端配置;保留并报告未声明项
sk restore <profile> 同样按声明修复投影和配置(可用于新 clone)
Expand Down
2 changes: 1 addition & 1 deletion packages/sk/src/cli.ts
Original file line number Diff line number Diff line change
Expand Up @@ -427,7 +427,7 @@ switch (cmd) {
sk profiles 已有 profile 一览
sk show <profile> 查看声明、技能描述与投影健康度
sk new <profile> 新建空 profile
sk add <profile> <模式...> 加技能(glob 或 @组名,如 sk add 写作 grilling '@workcoding')
sk add <profile> <模式...> 加技能(glob 或 @组名,如 sk add 写作 grilling '@practices')
sk rm <profile> <模式...> 移除技能(同样支持 glob 与 @组名)
sk sync <profile> 按声明修复投影、重生成派生文件(不反写声明)
sk restore <profile> 按 manifest 重建链接(新 clone 后用)
Expand Down
19 changes: 1 addition & 18 deletions plugins/CONTEXT.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,13 @@

`plugins/` 下自建 skill 的词汇表。只收这个仓自己用到的概念,不写实现细节。

用词合同(ADR-0006):每个词都是有出处的业界词——能在标准、书、知名框架或项目文档里查到;中文用通行译名,标题带英文原词与出处。查不到出处的概念不起名,用平语句子说清楚。旧名以 `_旧名_` 一行保留到收口票(agent-system#123)关闭为止,之后删掉。
用词合同(ADR-0006):每个词都是有出处的业界词——能在标准、书、知名框架或项目文档里查到;中文用通行译名,标题带英文原词与出处。查不到出处的概念不起名,用平语句子说清楚。旧名不保留:收口票 agent-system#123 已把 `_旧名_` 别名全部删掉,`plugins/tests/skills.test.ts` 守着旧词不再出现。

词条形状(`plugins/tests/skills.test.ts` 守着):

```
**中文**(English;出处:哪个标准、书或文档):
定义。
_旧名_: 换下来的词
_Avoid_: 容易混进来的近义词,和为什么不用
```

Expand All @@ -18,38 +17,31 @@ _Avoid_: 容易混进来的近义词,和为什么不用
### 主人开口之后

主人开口到拿回东西的一次往返不设总称,要指它时说「请求」(request)就够。按「要拿回什么」分成下面三种;停下、交接、换机器不是第四种,是三种都能被打断。
_旧名_: 来往

**查询**(query;出处:CQRS,Greg Young):
问、查、看,不动文件。
_旧名_: 要答案

**标准变更**(standard change;出处:ITIL 4 变更使能):
预先批准、风险低、只有一种改法、改完一眼能验的变更。直接做,贴证据,不进任何阶段。
_旧名_: 小改动
_Avoid_: 小修、快速修复

**常规变更**(normal change;出处:ITIL 4 变更使能):
要在做法之间选,或改的是合同(规则、接口、路由、数据格式)的变更。按阶段走,每个阶段的门等主人说行,能从任一阶段进。九个阶段的定义在流程 skill `flow` 的正文;为什么分九个见 wiki《vibeCoding 改动流转》。
_旧名_: 改动落地
_Avoid_: 大改动(分的依据不是体量)、需求

### 进了阶段之后

**阶段**(stage;出处:Cooper 的 Stage-Gate):
常规变更被切成的九个阶段之一,每个阶段有门和产物;顺序、门、产物在 `flow` 正文的九个阶段那张表。
_旧名_: 段

**门**(gate;出处:Cooper 的 Stage-Gate):
一个阶段结束时停下等主人说行的那一下。哪个阶段有门、门上判什么,写在 `flow` 的正文。

**活动**(activity;出处:ISO/IEC/IEEE 12207、PMBOK):
一个阶段里被点名的一件事,由一条 skill 或一段手做承担。改旧代码时才开的活动不另起名,就这么说(最近的业界概念是 12207 的裁剪 tailoring);开哪几个在第 4 阶段的门口定。
_旧名_: 步;可选步(指改旧代码时才开的那几个)

**站会记录**(standup update;出处:Scrum Guide 每日站会的三问加阻塞项):
一件事停下时写在它 issue 下的固定四栏评论(做成了、停在、下一步、等你),最后一条就是现状。
_旧名_: 停靠记录
_Avoid_: 交接记录(那是第 9 阶段 `/handoff` 的产物,给换机器或换人用)

### 验证与审查
Expand All @@ -60,7 +52,6 @@ _Avoid_: 「应该没问题」「看着能过」

**违例**(violation;出处:SonarQube 的 rule violation):
审查意见里违反仓里文档化规则或 spec 明写要求的那种。
_旧名_: 硬问题

**判断题**(judgement call;出处:Google 代码审查指南):
审查意见里不是违例的其余那些。两个标签只帮主人分拣,修不修都由主人定。
Expand All @@ -80,18 +71,15 @@ _旧名_: 硬问题

**架构决定**(architecture decision;出处:Nygard 的 Architecture Decision Record):
在既有系统上加一项新能力时要定的「系统成为什么样」那件事:决定什么、不决定什么、基线与未知、候选与推荐;flow-steps 里的活动 `architecture-decision`。
_旧名_: 架构设计

**权衡分析**(trade-off analysis;出处:SEI 的 ATAM,Clements、Kazman、Klein《Evaluating Software Architectures》):
对至少两个能落地的候选各写支持、反对、最大风险、可逆性,说出什么证据会推翻推荐;实践 `tradeoff-analysis`。
_旧名_: 候选攻防、做攻防

**可逆性**(reversibility;出处:Amazon 的单向门/双向门,Bezos 2015 年股东信):
一个候选上线后改回去要付多大代价:双向门随时能回,单向门回不去。

**影响分析**(impact analysis;出处:IEEE 14764 软件维护的修改分析):
一个决定缺一个数或判断时查一次、出一行带置信度的结论;flow-steps 里的活动 `impact-analysis`。
_旧名_: 系统分析

**影响草图**(effect sketch;出处:Feathers《修改代码的艺术》第 11 章):
从改动点出发静态画两跳——谁调它、它调谁、谁绕过它——并标出拿不准的边;实践 `effect-sketch`。
Expand All @@ -109,12 +97,10 @@ _Avoid_: 入口 skill、流程 skill(那是某一条具体路由 skill 的名

**人敲的**(user-invoked;出处:Claude Code Skills 文档的 `disable-model-invocation`):
只有主人敲 `/名` 才用的 skill;agent 只能说「请敲 /名」然后停下。
_旧名_: 手动调用
_Avoid_: 门 skill

**模型可拿的**(model-invoked;出处:Claude Code Skills 文档的 `disable-model-invocation`):
规则点名后由 agent 自己用的 skill。
_旧名_: 自动调用

### 写完之后

Expand All @@ -124,18 +110,15 @@ _Avoid_: 摩擦、硌手、痛点、坑(「坑」在工作区里指工具链

**上线清单**(rollout checklist;出处:发布工程通用,Google SRE 的 launch checklist 为近例):
一条 skill 写好之后,要让它真正被点名或能敲,还需要在 skill 仓之外做的那几处改动:路由句、可见档、同步投影。
_旧名_: 上线待办
_Avoid_: 路由待办、部署待办

### 工作项容器

**在制品**(work in progress, WIP;出处:Kanban 的 WIP limit):
正在推进的事,挂在根 issue 正文最上面;上限 3 就是 WIP limit。
_旧名_: 焦点

**主题**(theme;出处:SAFe 与通用敏捷层级):
根 issue 下第一层、对应一个长期方向的 issue;工作项挂不到当前事项时挂到所属主题下。
_旧名_: 领域分支

### 评测

Expand Down
6 changes: 5 additions & 1 deletion plugins/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,14 +33,18 @@
以下发布记录保留迁移前编号以便仓库维护者溯源;其中私有链接对公共协作者不可用,只是可选历史来源。当前行为、贡献要求和验收必须在本仓公开内容中自足表达。
`adaptive-problem-solving` `0.2.14` 随 2026-09-01 负责人裁定的 bmad 整组退库清理引用:description 与方法登记面 INDEX 的「与装配内其他 Skill 的分界」表不再列 bmad-* 执行流程承载者(仅保留 `grilling`),失效条款同步;行为合同与方法卡内容不变。

仓库目前包含十三个可安装 Plugin:`self-improvement` `0.1.7`、`skill-maintenance` `0.1.1`、`knowledge-maintenance` `0.1.3`、`orchestrated-collaboration` `0.2.7`、`adaptive-problem-solving` `0.2.14`、`skill-appraisal` `0.2.0`、`clarify` `0.1.0`、`note` `0.1.0`、`workcoding` `0.1.0`(含 8 个规程 Skill)、`skill-authoring` `0.1.2`、`flow` `0.1.5`、`flow-steps` `0.1.4`(含 12 条活动 Skill)、`practices` `0.1.3`(含 18 条实践 Skill:`grilling`、`domain-modeling`、`tdd`、`code-review` 按 MIT 从 Matt Pocock 的 skills 仓复制入库改写,来源与 revision 见 `plugins/practices/SOURCE`,ADR-0007;其余 14 条从 workcoding 八条规程拆出的自建实践)。Matt 的其余 21 个 promoted Skill 与 Superpowers 的 14 个 Skill 由 daily profile 从 `vendor/` 固定来源装配,不属于本仓 Plugin 目录。以 `docs/skills-overview.md`(自动生成)为准。
仓库目前包含十二个可安装 Plugin:`self-improvement` `0.1.7`、`skill-maintenance` `0.1.2`、`knowledge-maintenance` `0.1.3`、`orchestrated-collaboration` `0.2.7`、`adaptive-problem-solving` `0.2.14`、`skill-appraisal` `0.2.0`、`clarify` `0.1.1`、`note` `0.1.1`、`skill-authoring` `0.1.3`、`flow` `0.1.6`、`flow-steps` `0.1.5`(含 12 条活动 Skill)、`practices` `0.1.4`(含 18 条实践 Skill:`grilling`、`domain-modeling`、`tdd`、`code-review` 按 MIT 从 Matt Pocock 的 skills 仓复制入库改写,来源与 revision 见 `plugins/practices/SOURCE`,ADR-0007;其余 14 条从已归档的 workcoding 八条规程拆出的自建实践),合计 40 个 Skill。Matt 的其余 21 个 promoted Skill 与 Superpowers 的 14 个 Skill 由 daily profile 从 `vendor/` 固定来源装配,不属于本仓 Plugin 目录。以 `docs/skills-overview.md`(自动生成)为准。

**2026-09-02 负责人裁定退库两组**:`github-collaboration`(六个 Skill)与 `resource-observability`。理由见下方「已退库」。此前写进符合性门禁的「GitHub 协作 Plugin 必须作为可发布资产保留」一条同时作废,已从 `plugins/tests/workflow-routing.test.ts` 移除。

`skill-maintenance` `0.1.1` 在明确创建、审计、修正、拆分、升级、迁移或退役 Skill 时进入:先绑定当前行为合同与授权,预注册行为判据,再同步主合同、按需 reference、全部调用者、双端发现入口、版本、生成物和复杂度预算;安全门零回退,调用者 clean cutover,方案/实施同源时必须独立审查。它不维护普通业务代码,也不替 `self-improvement` 决定一次纠正应该落到哪里。

仓库资产、Marketplace 可安装目录和当前装配是三个不同状态:`plugins/` 保存可发布资产,Marketplace 只声明可安装来源,实际装配由 `sk` 的 profile(`profiles/<name>/manifest.json`,源码 `packages/sk`)决定。仓内可安装资产不会因为出现在 Marketplace 或插件目录中就自动进入某个 profile。

## 已归档(2026-09-19)

`workcoding`(挑规程的壳 `workcoding` 加八条工程规程 `requirement-insight`、`requirement-translation`、`architecture-design`、`system-analysis`、`legacy-change`、`integration`、`evidence-regression`、`release-observe`)于 2026-09-19 按 agent-system#123 归档到 `_archive/plugins/workcoding/`。壳退役是负责人 2026-09-14 的裁定(desk#142,agent-system#111):`flow` 在第 4 阶段的门上按缺口开改旧代码时才开的活动,壳失去角色;八条规程已在 agent-system#119 到 #122 拆成 `practices` 的 14 条实践与 `flow-steps` 的 8 条活动。marketplace 与两份 profile manifest 已清掉它的条目;正文原样保留,git 历史可查(`git log --follow -- _archive/plugins/workcoding`)。

## 已退库(2026-09-02)

`github-collaboration`(`issue-workflow` / `issue-delivery` / `issue-contract-compaction` / `objective-to-issues` / `operating-ledger-maintenance` / `pr-integration` 六个 Skill,合计约 156 KB)与 `resource-observability` 于 2026-09-02 经负责人裁定整组退库。git 历史保留,`git log --diff-filter=D -- plugins/github-collaboration plugins/resource-observability` 可复原。
Expand Down
2 changes: 1 addition & 1 deletion plugins/clarify/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "clarify",
"version": "0.1.0",
"version": "0.1.1",
"description": "Turn an itch stated as a solution back into a problem, then judge whether it is worth solving.",
"author": {
"name": "Eridanus117"
Expand Down
Loading
Loading