agent-stash
自用的 Agent Skills、pi 扩展与 DSH（DeepSeek Harness）插件合集。
目录
| 路径 | 内容 |
|---|
src/ | pi 与 DSH 共用的实现 |
pi/extensions/ | pi 扩展，由 package.json 的 pi.extensions 声明 |
dsh/ | DSH 插件源码、cordis.patch.yml、本地化文案与图标 |
dist/ | DSH 插件的构建产物，由 pnpm build 生成，随仓库提交 |
vendor/init-prompts/ | 从上游仓库同步的 /init prompt、许可证与 manifest.json，由脚本生成，不手动修改 |
scripts/ | 同步脚本 |
安装
pi
pi install git:github.com/Alice39s/agent-stash
只在当前会话试用：
pi -e git:github.com/Alice39s/agent-stash
DSH
DeepSeek Harness 桌面版：在「插件」页点「添加插件」，填入 github:Alice39s/agent-stash 后安装。
命令行：把仓库作为 bundle 装进某个 profile，例如 Web 界面使用的 web：
dsh plugin --profile web add github:Alice39s/agent-stash
dist/ 已随仓库提交，安装时不需要构建。DSH 的斜杠命令目前只在 Web 界面与桌面版里可用。
/init
让 agent 分析当前项目并写出 AGENTS.md，prompt 取自其他 coding agent 的开源实现。pi 与 DSH 的用法相同。
/init 使用默认预设
/init kimi-code 使用 kimi-code 预设
/init opencode 重点写测试流程 使用 opencode 预设并附加额外指令
/init 用中文写 第一个词不是预设名时，整段文字作为默认预设的额外指令
pi：
- 输入
/init 后，补全菜单列出每个预设及其上游来源，默认预设标出 (default)。
- 选中预设后，菜单提示可以继续输入
[extra prompt]。
DSH：
- 命令菜单列出全部预设，默认预设标出
(default)。
- 输入框提示可用的预设名，例如
[codex|kimi-code|opencode] [extra prompt]。
- 预设列表在 DSH 加载插件时生成，修改配置后要重启 DSH 才会更新。
内置预设
| 预设 | 上游 | 文件 | 许可证 |
|---|
codex（默认） | openai/codex | codex-rs/tui/assets/prompt_for_init_command.md | Apache-2.0 |
kimi-code | MoonshotAI/kimi-code | packages/agent-core-v2/src/features/sessionInit/profile/init.md | MIT |
opencode | anomalyco/opencode | packages/core/src/plugin/command/initialize.txt | MIT |
每个预设对应的上游 commit 记录在 vendor/init-prompts/manifest.json。
额外指令与占位符
模板里的占位符在发送前替换：
${path}：当前项目目录。DSH 里取会话的当前工作目录。$ARGUMENTS：额外指令。
模板没有 $ARGUMENTS 时，额外指令追加到 prompt 末尾的 ## Additional instructions from the user 小节。
配置
配置文件按以下顺序读取，后读的覆盖先读的。
pi：
~/.pi/agent/agent-stash/init.json（设置了 PI_CODING_AGENT_DIR 时为 $PI_CODING_AGENT_DIR/agent-stash/init.json）<项目>/.pi/agent-stash/init.json，仅在项目受信任时读取
DSH：
$DSH_HOME/agent-stash/init.json（未设置 DSH_HOME 时为 ~/.dsh/agent-stash/init.json）
{
"defaultPreset": "team",
"presets": {
"team": {
"file": "./team-init.md",
"description": "团队的 AGENTS.md 模板"
}
}
}
defaultPreset：不写预设名时使用的预设，默认为 codex。presets：自定义预设。file 是相对配置文件所在目录的路径，同名预设覆盖内置预设。description 显示在补全菜单里，不写时显示文件路径。
配置格式错误或默认预设不存在时，/init 直接报错。
上游同步
.github/workflows/sync-init-prompts.yml 每天运行一次，也可以手动触发。它拉取各上游默认分支最新 commit 中的 prompt 与根目录的 LICENSE、NOTICE 文件，运行检查后向 chore/sync-init-prompts 分支开 PR。
仓库需要在 Settings → Actions → General 中开启「Allow GitHub Actions to create and approve pull requests」，workflow 才能创建 PR。
本地同步：
GITHUB_TOKEN=<token> pnpm sync:init-prompts
上游列表在 scripts/sync-init-prompts.ts 的 SOURCES 中维护。
开发
pnpm install
pnpm check # oxfmt --check、oxlint 类型检查与 vitest
pnpm build # 用 tsdown 生成 dist/dsh/init.js
pnpm format
改动 src/ 或 dsh/ 后要运行 pnpm build 并提交 dist/。CI 会重新构建，dist/ 与源码不一致时失败。
许可证
本仓库使用 Apache License 2.0。vendor/init-prompts/ 下的文件沿用各自上游的许可证，许可证原文与上游 prompt 放在同一目录。
