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
7 changes: 6 additions & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
},
{
"name": "skill-authoring",
"version": "0.1.1",
"version": "0.1.2",
"source": "./plugins/skill-authoring"
},
{
Expand All @@ -65,6 +65,11 @@
"name": "flow-steps",
"version": "0.1.0",
"source": "./plugins/flow-steps"
},
{
"name": "practices",
"version": "0.1.0",
"source": "./plugins/practices"
}
]
}
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ decision-makers: 负责人

- `plugins/practices/LICENSE-mattpocock` 与 `SOURCE` 在,`SOURCE` 记的 revision 与 `vendor/mattpocock/SOURCE.json` 一致。
- 四条 SKILL.md 头部各有来源与 revision,正文通过 `skills.test.ts` 的词汇守卫。
- 落地后回来补实际结果。
- 实际结果(2026-09-19,agent-system#118):`plugins/practices` 建成,`LICENSE-mattpocock` 为 vendor 的 MIT 原文,`SOURCE` 记 revision `6acc160e…`,与 `vendor/mattpocock/SOURCE.json` 一致;四条 SKILL.md 头部都写了来源仓、revision、许可与改写范围,`node plugins/tests/skills.test.ts` 通过。十个评测用例,有 skill 组九条 1.0、一条 0.78(裁判读法,见 `plugins/practices/evals/README.md`),平均差值 +0.38。`profiles/daily` 与 `profiles/all` 的四条已从 vendor 改指 `plugins/practices/skills/<名>`;`flow` 的点名(`tdd`、`code-review`)用的就是这四个名字,不需要改字。

## 更多信息(More Information)

Expand Down
2 changes: 1 addition & 1 deletion plugins/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
以下发布记录保留迁移前编号以便仓库维护者溯源;其中私有链接对公共协作者不可用,只是可选历史来源。当前行为、贡献要求和验收必须在本仓公开内容中自足表达。
`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.0`、`flow` `0.1.1`、`flow-steps` `0.1.0`(含 4 个步 Skill)。Matt 的 25 个 promoted Skill 与 Superpowers 的 14 个 Skill 由 daily profile 从 `vendor/` 固定来源装配,不属于本仓 Plugin 目录。以 `docs/skills-overview.md`(自动生成)为准。
仓库目前包含十三个可安装 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.1`、`flow-steps` `0.1.0`(含 4 条活动 Skill)、`practices` `0.1.0`(含 4 条实践 Skill:`grilling`、`domain-modeling`、`tdd`、`code-review`,按 MIT 从 Matt Pocock 的 skills 仓复制入库改写,来源与 revision 见 `plugins/practices/SOURCE`,ADR-0007)。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` 移除。

Expand Down
8 changes: 6 additions & 2 deletions plugins/docs/skills-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

一个 skill 一个目录:`plugins/<plugin>/skills/<skill>/SKILL.md`,旁边可放 `evals/evals.json`;插件级 `evals/` 下的 `claude plugin eval` 用例也算有 evals。装配用 `sk`(源码 `packages/sk`;profile 的 manifest.json 是声明,junction 是投影)。

共 23 个 Skill,12 个 Plugin。
共 27 个 Skill,13 个 Plugin。

| Skill | Plugin | 版本 | L2 字节 | evals | description |
|---|---|---|---|---|---|
Expand All @@ -18,9 +18,13 @@
| `knowledge-maintenance` | knowledge-maintenance | 0.1.3 | 6488 | 无 | 用于多来源调研、可重复实验、会影响权威/Agent 配置/重要决定的研究,或用户要求复用、复核、更新当前知识时:先找已认可知识和失效条件,只补变化、冲突与缺口,再经价值门和可信门更新。不用于低成本一次性事实、原始材料/研发过程留存、私域结构… |
| `note` | note | 0.1.0 | 2696 | 无 | 把成熟结论沉淀进本地 Markdown 知识库,或找回以前记过的结论。当用户说「沉淀到知识库」「记到 KB」「/note」「以前记过」「找回笔记」时使用。 |
| `orchestrated-collaboration` | orchestrated-collaboration | 0.2.7 | 21795 | 无 | 当用户明确要求多 Agent/多 Session/跨 Provider 协作、任务已授权委派,或活动 Session 发生共享写入碰撞时,建立目标来源、排他所有权、可追踪交付、独立验收与综合;按共享资源和 Issue 子树确定唯一协调者,只… |
| `code-review` | practices | 0.1.0 | 5058 | 有 | 审一条分支、PR 或在制的改动时用:以主人给的固定点取 diff,分标准与 spec 两轴各派一个子代理审,违例与判断题分开标,两份报告并排给出、各轴各自小结。Two-axis code review of the diff since a… |
| `domain-modeling` | practices | 0.1.0 | 3825 | 有 | 设计途中要敲定领域术语、建或改统一语言、记一条架构决定时用:对着词汇表挑战用词,用具体场景逼清边界,和代码对照,词一定下就写进 CONTEXT.md,只在难回头的取舍上提 ADR。Build and sharpen a project do… |
| `grilling` | practices | 0.1.0 | 3167 | 有 | 主人拿一个计划、决定或想法来要压力测试时用:把决定画成一棵树,按前提顺序一轮一题地问到没有一处被默默假设;事实自己查,决定归主人。Grill the user about a plan, decision or idea: walk the… |
| `tdd` | practices | 0.1.0 | 4308 | 有 | 测试先行地做功能或修 bug 时用:先和主人定好要测的接缝,再红到绿一次一个切片;测试只穿公共接口,期望值用独立字面值,只在系统边界 mock。Test-driven development: agree the seams first, … |
| `self-improvement` | self-improvement | 0.1.7 | 8987 | 无 | 当用户指出 Agent 漂移、误解、重复犯错,要求把任务经验固化为系统改进,或讨论只增概念却不减关键未知、形成决定或可检验资产时,只暂停依赖被推翻假设的路径,重锚原问题、持久记录纠正、诊断原因,并在授权内改进入口提示词或 Skill。最小实… |
| `skill-appraisal` | skill-appraisal | 0.2.0 | 10450 | 无 | 判定一个 Skill 组该不该进当前装配、归哪些事项、与谁重叠,或对已判定过的组按节拍复核。三种进入:首次判定新候选、补判早已在用但从未判定过的组、按失效条件复核。判定单位是组不是单个 Skill;产出必须留下失效条件与下次最少复核步骤。用… |
| `skill-authoring` | skill-authoring | 0.1.1 | 7296 | 有 | 写一条自建 skill 或改一条既有自建 skill 时用:从机会 issue 或反馈 issue 走到「PR 开了、上线待办建了」,先跑基线再动笔。Author or modify a self-built skill, from an … |
| `skill-authoring` | skill-authoring | 0.1.2 | 7296 | 有 | 写一条自建 skill 或改一条既有自建 skill 时用:从机会 issue 或反馈 issue 走到「PR 开了、上线待办建了」,先跑基线再动笔。Author or modify a self-built skill, from an … |
| `skill-maintenance` | skill-maintenance | 0.1.1 | 4363 | 有 | 创建、审计、修正、拆分、升级、迁移或退役 Skill,或其合同/入口已漂移时,先恢复行为、授权与预算,再同步正文、调用者、版本、生成物和验证。普通业务维护、纯格式修正、承载位置未定的纠正不触发。Use for explicit Skill … |
| `architecture-design` | workcoding | 0.1.0 | 6743 | 有 | 在既有系统上设计一项新能力、要定领域模型和承载方式时用:摆现状与未知,比较至少两个候选,做支持/反对攻防,形成待主人确认的架构决定。Design a new capability on an existing system: compare… |
| `evidence-regression` | workcoding | 0.1.0 | 7278 | 有 | 要证明老流程没变、新流程是对的时用:改代码前把真实出入参录成仓内母版,改后回放逐字节比对(Golden Master/Approval Testing)。触发语「怎么证明没改坏」「回归」「出入参采集」。Golden-master regre… |
Expand Down
11 changes: 11 additions & 0 deletions plugins/practices/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"name": "practices",
"version": "0.1.0",
"description": "四条实践 skill 的入库版:grilling、domain-modeling、tdd、code-review。正文按 MIT 从 Matt Pocock 的 skills 仓复制并改成中文与本仓写法;规程 skill 按活动点名它们。",
"author": {
"name": "Eridanus117"
},
"repository": "https://github.com/Eridanus117/agent-system",
"license": "MIT",
"skills": "./skills/"
}
21 changes: 21 additions & 0 deletions plugins/practices/LICENSE-mattpocock
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Matt Pocock

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
12 changes: 12 additions & 0 deletions plugins/practices/SOURCE
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# 来源

本插件四条 skill(grilling、domain-modeling、tdd、code-review)的正文按 MIT 许可从下面的仓复制并改写(ADR-0007):

- 仓:https://github.com/mattpocock/skills
- 版本:1.2.3
- revision:6acc160e4e0cd062dbbbd7a1b26ae92855edf07e(与 `vendor/mattpocock/SOURCE.json` 一致)
- 许可证:MIT,全文见同目录 `LICENSE-mattpocock`;版权归 Matt Pocock。

改写的范围:英文改中文;骨架改成本仓的两节(什么时候用、步骤,见 `plugins/skill-authoring` 的 writing-rules);术语按 `plugins/CONTEXT.md`;与本工作区常驻规则或评测发现冲突处按本仓改(各条 SKILL.md 头部「与原版的差别」一句逐条列出)。

要跟上游时:以上面的 revision 为基点对 `vendor/mattpocock/skills/<名>/` 做 diff,手动合进对应 SKILL.md,然后更新这里的 revision。
Loading
Loading