Compare commits
2
Commits
20260521-4
...
20260526
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
eafd46a8ba | ||
|
|
4fa489691f |
No files matched your search
@@ -9,7 +9,7 @@
|
||||
{
|
||||
"name": "praxis",
|
||||
"description": "Simgreek team's AI coding agent rulebook: SOP for Node.js projects, git hygiene, debugging, verification.",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"source": "./",
|
||||
"author": {
|
||||
"name": "Simgreek",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "praxis",
|
||||
"description": "Simgreek team's AI coding agent rulebook: SOP for Node.js projects, git hygiene, debugging, verification — practice over theory.",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"author": {
|
||||
"name": "Simgreek",
|
||||
"url": "https://git.simgreek.com/simgreek"
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
{
|
||||
"name": "praxis",
|
||||
"version": "0.2.0",
|
||||
"description": "Simgreek team's AI coding agent rulebook: SOP for Node.js projects, git hygiene, debugging, verification.",
|
||||
"author": {
|
||||
"name": "Simgreek",
|
||||
"url": "https://git.simgreek.com/simgreek"
|
||||
},
|
||||
"homepage": "https://git.simgreek.com/simgreek/praxis",
|
||||
"repository": "https://git.simgreek.com/simgreek/praxis",
|
||||
"license": "Internal",
|
||||
"keywords": [
|
||||
"skills",
|
||||
"sop",
|
||||
"nodejs",
|
||||
"git",
|
||||
"debugging",
|
||||
"team-rules"
|
||||
],
|
||||
"skills": "./skills/",
|
||||
"interface": {
|
||||
"displayName": "Praxis",
|
||||
"shortDescription": "Simgreek team's AI coding agent SOP",
|
||||
"longDescription": "Use Praxis to make AI coding agents follow Simgreek team conventions: project entry, task framing, git workflow, encoding checks, root-cause debugging, and verification before completion.",
|
||||
"developerName": "Simgreek",
|
||||
"category": "Coding",
|
||||
"capabilities": [
|
||||
"Interactive",
|
||||
"Read",
|
||||
"Write"
|
||||
],
|
||||
"defaultPrompt": [
|
||||
"I'm starting a new task in this project — what should I check first?",
|
||||
"Help me bootstrap this project to follow Praxis conventions."
|
||||
],
|
||||
"websiteURL": "https://git.simgreek.com/simgreek/praxis"
|
||||
}
|
||||
}
|
||||
@@ -8,24 +8,66 @@ Simgreek 团队的 AI 协作开发约定。**给 AI 看的**——每个项目
|
||||
|
||||
源自希腊语 *praxis*(实践)。Simgreek 团队的"踩过坑就写下来"的总和,给 AI agent 用。
|
||||
|
||||
两种用法:
|
||||
支持三种用法(按完整度排序):
|
||||
|
||||
- **作为 Claude Code 插件**(推荐)—— `/plugin install praxis` 之后,session 一开 hook 就把 `using-praxis` 强制注入 context,AI 行为受铁律约束。
|
||||
- **作为外部规范**—— 不装插件也能用:AI 进项目前读 `AGENTS.md` + 扫 `skills/`,靠自觉调用。Codex / Cursor 走这条。
|
||||
- **作为 Claude Code 插件** —— `/plugin install praxis` 之后,session 一开 SessionStart hook 就把 `using-praxis` 强制注入 context,AI 行为受铁律约束。
|
||||
- **作为 Codex / Codex++ 插件** —— `/plugin add <praxis-url>` 装上,Codex 把 skills/ 里的 SKILL.md 注册成可调用的 skill。Codex 没有 SessionStart hook,但 skill 的 description 会让模型按需 invoke。
|
||||
- **作为外部规范**—— 不装插件也能用:AI 进项目前读 `AGENTS.md` + 扫 `skills/`,靠提示词显式调用。Cursor / 其他工具走这条。
|
||||
|
||||
## 安装(Claude Code 插件)
|
||||
## 安装(Claude Code)
|
||||
|
||||
simgreek 仓库要求登录访问,所以 plugin URL 里要带个人 access token。每个团队成员一次性配一下。
|
||||
|
||||
**第 1 步**:在 Gitea 生成 token
|
||||
|
||||
登录 [git.simgreek.com](https://git.simgreek.com) → 右上角头像 → Settings → Applications → 「Manage Access Tokens」 → 生成一个新 token:
|
||||
|
||||
- Token 名字:`claude-code-plugin`(或你喜欢的)
|
||||
- 权限只勾 `repository: read` 就够,越小越好
|
||||
- **生成后立刻复制保存**——离开页面就看不到了
|
||||
|
||||
**第 2 步**:在 Claude Code 装
|
||||
|
||||
把下面的 `<YOUR_USERNAME>` 和 `<YOUR_TOKEN>` 替换掉:
|
||||
|
||||
```
|
||||
/plugin marketplace add https://git.simgreek.com/simgreek/praxis
|
||||
/plugin marketplace add https://<YOUR_USERNAME>:<YOUR_TOKEN>@git.simgreek.com/simgreek/praxis
|
||||
/plugin install praxis
|
||||
```
|
||||
|
||||
装完之后每次开新 session,praxis 的 `SessionStart` hook 会把 `using-praxis` 内容直接灌进 system context——AI 在做任何事之前都会读到铁律和 red flags。
|
||||
|
||||
升级:`/plugin update praxis`
|
||||
升级:`/plugin update praxis`(自动用同一个 token 拉新版本)
|
||||
|
||||
卸载:`/plugin uninstall praxis`
|
||||
|
||||
## 安装(Codex / Codex++)
|
||||
|
||||
token 准备方式与 Claude Code 一致(上面第 1 步)。
|
||||
|
||||
**在 Codex CLI 或 Codex++ 里**:
|
||||
|
||||
```
|
||||
/plugin add https://<YOUR_USERNAME>:<YOUR_TOKEN>@git.simgreek.com/simgreek/praxis
|
||||
```
|
||||
|
||||
Codex 拉取仓库后会读 `.codex-plugin/plugin.json`,把 `skills/` 下所有带 frontmatter 的 SKILL.md 注册成可调用 skill。需要时 AI 自己 invoke。
|
||||
|
||||
**和 Claude 的差别**:Codex 没有 SessionStart hook,所以 `using-praxis` 不会被强制注入。AI 进项目时,建议你**第一句话**说:
|
||||
|
||||
```
|
||||
先读 using-praxis skill,了解我们团队的 SOP 再开始。
|
||||
```
|
||||
|
||||
让 Codex 主动 invoke 一次,铁律就在 context 里了。后续任务正常用。
|
||||
|
||||
**安全提醒(两边都适用)**:
|
||||
|
||||
- token 会被工具写进本地配置——别让别人翻你电脑、别把 config 分享出去
|
||||
- token 不要提交进任何仓库
|
||||
- 共用电脑 / 临时机器装完用完,去 Gitea token 页面 revoke 掉
|
||||
- token 失效或换了,重新跑 install 命令用新 URL
|
||||
|
||||
## 不装插件怎么用
|
||||
|
||||
把这段提示词丢给 AI 当首句话:
|
||||
|
||||
Reference in new issue
Block a user