@namewta/speculo 1.0.18 → 1.0.20

package/template/skills/optimize-codex-config/references/entry-procedure.md

@@ -1,78 +0,0 @@
-# Entry procedure
-
-# Optimize Codex Config
-
-以**体检**为主导词：先建立脱敏事实，再提出配置变更。默认只读；修改本机配置前必须向用户展示完整目标和脱敏 diff，并取得本次修改的明确确认。
-
-## 1. 锁定范围与权限
-
-1. 解析实际 `CODEX_HOME`；未显式设置时使用当前用户的 `~/.codex`。将它转成绝对路径并确认目标是目录且不是符号链接。
-2. 将请求归类为只读体检、故障诊断或配置修改。只读体检和诊断不取得写权限。
-3. 将本 skill 的写入边界限制为用户明确指定的本机 Codex 文件。CC Switch 数据库、远端 API、反向代理和 Nginx 只输出归因与交接建议。
-4. 在任何可能写入前记录 `config.toml` 的哈希、大小和修改时间，并检查目标文件是否存在已证明的可写句柄。普通 Codex CLI、ChatGPT/Codex 应用进程及其 helper 的存在不构成 writer 证据。
-
-**完成标准：** 实际 `CODEX_HOME`、任务类型、允许写入的文件和外部边界均已明确；符号链接、已证明的活跃 writer、不明确目标，或修改任务无法取得 writer 观测时已成为 blocker。只读任务可以把不可用探针记录为 unknown 后继续。
-
-## 2. 建立只读基线
-
-从本 `SKILL.md` 所在目录运行：
-
-```bash
-node scripts/audit-codex-config.mjs --codex-home <absolute-directory> --json
-```
-
-需要离线或可复现 fixture 时加入 `--no-command-probes`；需要缩小会话扫描范围时使用 `--since-days <N>`。先运行 `--help` 核对当前接口；CLI 不在导出的 `PATH` 中时，用 `command -v codex` 取得绝对路径并传给 `--codex-bin`。
-
-1. 保留审计脚本的结构化结果；不得把 `auth.json` 内容、提示词、工具输出、完整接口 URL 或 bearer token复制进报告。
-2. 直接查看配置时，先遮蔽 `experimental_bearer_token`、静态认证 header、环境变量值和 URL 主机。只检查 `auth.json` 的存在、文件类型、权限和 Codex 报告的认证模式，不读取或打印文件内容。
-3. 对配置、供应商、认证、权限、Agent、MCP、Hook 或历史设置提出判断前，读取 [configuration contract](configuration-contract.md)，并用已安装 CLI 与当前官方配置参考验证每个拟使用的键。
-4. 把用户提供的既有设置视为需要保留或评估的事实，不把个人模型、认证方式或权限策略提升为通用默认值。
-
-**完成标准：** 当前版本、配置指纹、认证存储模式、供应商契约、权限、Agent、MCP、Hook、会话故障和 writer 状态均有脱敏证据；无法取得的事实被标为 unknown。
-
-## 3. 归因故障
-
-当请求包含 HTTP 状态码、SSE、超时或 compaction 失败时，读取 [troubleshooting](troubleshooting.md)，按其中证据梯度完成归因。
-
-1. 关联错误发生前最近一次 `token_count`，但只保留 token 数和模型上下文窗口。
-2. 区分本机配置、认证、供应商 wire API、远端模型服务和前置代理。HTML 代理错误页属于代理证据，不归因给模型。
-3. 对外部问题给出可复现证据、影响、临时本机缓解和服务端交接项。本 skill 不探测或修改用户未授权的远端系统。
-
-**完成标准：** 每个错误只有一个主要归属域，证据与推断分开，所有本机缓解都标明质量、成本或频率代价。
-
-## 4. 设计目标状态
-
-只询问审计无法发现且会改变方案的偏好：模型与推理等级、认证存储、审批与沙箱、网络访问、Agent 并发、供应商认证方式、历史保留，以及 MCP/Hook 的保留意图。
-
-输出确认包：
-
-1. 当前状态和问题证据；
-2. 目标状态及每项理由；
-3. 逐文件脱敏 diff；
-4. 明确保留的未知项、MCP、Hook、profile 和兼容设置；
-5. 备份名、原子写入方法、验证命令和回滚条件；
-6. 不在本机范围内的外部 blocker。
-
-只采用当前官方参考与已安装 CLI 均能验证的键。项目级 `.codex/config.toml` 不承载 provider、auth 或其他被 Codex 忽略的机器级设置。
-
-**完成标准：** 用户无需猜测任何目标值；diff 不含 secret；未关联的现有设置不会被清理；外部问题不会伪装成本机可修复项。
-
-## 5. 确认后原子写入
-
-只有用户在看到确认包后明确同意本次变更，才执行以下动作：
-
-1. 重读指纹；若配置已变化、存在目标文件的可写句柄，或 writer 探针仍为 unknown，停止并重新体检。
-2. 为每个待改文件创建不覆盖的 `*.pre-optimize-<YYYYMMDD-HHMMSS>.bak`，并将包含凭据的文件权限设为 `0600`。
-3. 在同一目录写临时文件、解析或加载验证成功后 rename 到目标，保留与任务无关的表和注释。
-4. 仅在用户明确要求且已安装 Codex 能验证格式时处理 `auth.json`。文件存储是有效选择，不强制迁移钥匙串；不得自行发明认证 JSON schema。
-
-**完成标准：** 写入前后的指纹、备份和确认可对应；目标文件是原子替换结果；没有越出已确认文件集合。
-
-## 6. 验证与交付
-
-1. 运行 `codex doctor --json`，再核对 `codex features list` 和 `codex debug models --bundled` 中与目标相关的能力。
-2. 验证配置加载、认证模式、权限与沙箱、MCP、Hook、Agent 和旧会话恢复。只有用户授权可能计费的网络请求后，才执行最小第三方 API 请求。
-3. 任一必须验证项失败时恢复备份，重跑相同检查并报告原始失败与回滚结果。
-4. 报告已改变、已保留、已验证、未验证和外部 blocker；不回显任何 secret 或完整 URL。
-
-**完成标准：** 所有已确认变更通过本机验证，或已完整回滚；报告包含命令、退出码和关键脱敏证据。

package/template/skills/speculo-retro/SKILL.md

@@ -1,19 +0,0 @@
----
-name: speculo-retro
-description: Extract and deduplicate friction from Speculo evidence into issue proposals; do not create issues without command confirmation.
-metadata: {"speculo-id": "speculo-retro", "speculo-kind": "skill", "speculo-legacy-name": "Speculo Retro"}
----
-
-# Speculo Retro
-
-This file is the routing entry. Read [`references/entry-procedure.md`](references/entry-procedure.md) only after this skill is selected. Read a named reference there only for the active branch.
-
-## Scope
-
-- Trigger: Extract and deduplicate friction from Speculo evidence into issue proposals; do not create issues without command confirmation.
-- Output and write owner remain those declared by the entry procedure and the owning command/workflow.
-- Do not infer missing scope, credentials, target, or authorization.
-
-## Stop
-
-Stop before side effects when the required input, owner, reference, confirmation, schema, or recovery evidence is missing; report the exact blocker and preserve any dry-run evidence.

package/template/skills/speculo-retro/references/entry-procedure.md

@@ -1,23 +0,0 @@
-# Entry procedure
-
-# Speculo Retro
-
-## 输入
-
-- 当前对话与本次使用的 commands/workflows。
-- `commands/<command>/*.md` 报告、active change 状态、archive 和 `INDEX.md` 声明的知识 store。
-- 可选已有 issues，用于语义去重。
-
-## 流程
-
-1. 读取 `references/friction-taxonomy.md`，穷尽扫描可用证据并列出原始摩擦。完成标准：每项都有来源路径或对话节点。
-2. 按 bug、friction、missing-capability、doc-gap、ergonomics 归类，合并同一根因。完成标准：每项只属于一个根因簇，合并关系可追溯。
-3. 评估影响与频率，过滤一次性噪声；低信号项标为丢弃或仅记教训。完成标准：每项都有优先级和处置理由。
-4. 读取 `references/issue-drafting-sop.md`，生成 issue-ready 提案并与已有 issue 去重。完成标准：标题、证据、问题、建议、验收、影响资产和去重结论齐全。
-
-## 输出
-
-- 按优先级排序的 `file-issue | lesson-only | discard | duplicate` 提案。
-- 合并/丢弃说明和调用方执行 `gh` 所需字段。
-
-本 skill 不写文件、不调用外部 API；command 负责报告、确认和 issue 创建。

package/template/skills/upstream-fork-sync/references/entry-procedure.md

@@ -1,78 +0,0 @@
-# Entry procedure
-
-# Upstream Fork Sync
-
-以**检查点**为主导词。每个仓库始终分开记录：本次观测到的 upstream tip、可选本地 mirror tip，以及已经由产品分支历史证明完成集成的 upstream checkpoint。Fetch 或 mirror 变化不能推进集成 checkpoint。
-
-## 1. 解析上下文
-
-1. 从当前目录向上寻找并读取 `<Path>{roots.state}/workspace.json</Path>`，验证 `path_base` 和所有 roots，再读取 `<Path>{roots.config}</Path>`；无法唯一确定项目根时停止。
-2. 读取项目 `AGENTS.md` 及其作用域内规则。项目存在工程规范时读取适用入口。
-3. 将本 Skill 的唯一持久化根解析为 `<Path>{roots.state}/skills/upstream-fork-sync/</Path>`。独立运行只写该根；不得创建 workflow change 或 command 报告。
-4. 读取 [Repository contract](repository-contract.md)，确定仓库、refs、网络刷新和副作用边界。
-
-完成标准：项目根、Skill state 根、目标仓库集合和本次是否允许 fetch 都只有一个解释。
-
-## 2. 建立稳定配置
-
-读取 `<Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path>`。不存在时，只读发现 Git 仓库、remotes、默认产品分支和 upstream tracking refs，按 [Repository contract](repository-contract.md) 创建 schema v1 配置；无法从 Git 事实唯一判断的字段一次性询问用户。配置已存在时验证，不静默改写。
-
-读取 `<Path>{roots.state}/skills/upstream-fork-sync/customization-map.md</Path>`。不存在时创建最小稳定清单，记录 fork 必须长期保留的产品不变量和审查热点；无法从项目文档或代码证明的业务约束标记为待确认。该文件不接收运行 SHA、dirty paths、冲突或本次结论。
-
-完成标准：每个 repository id 唯一，所有项目路径和 refs 可解析，稳定配置与动态运行事实分离。
-
-## 3. 创建评估 change
-
-读取 [State schema](state-schema.md) 和 [Report contract](report-contract.md)，从用户主题生成小写 ASCII kebab-case topic，然后运行：
-
-```bash
-node <Path>{roots.skills}/upstream-fork-sync/scripts/upstream-sync.mjs</Path> assess \
-  --root . \
-  --state-root <Path>{roots.state}/skills/upstream-fork-sync</Path> \
-  --repository-map <Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path> \
-  --topic <topic>
-```
-
-- 默认离线使用本地 refs；只有用户明确要求刷新网络 refs 时添加 `--fetch`。
-- 只需预览完整冻结快照时添加 `--dry-run`，此分支不写 state 或 change。
-- 正常运行创建 `<Path>{roots.state}/skills/upstream-fork-sync/{date}-{topic}[-NN]/</Path>`，已有目录永不覆盖。
-
-完成标准：脚本退出 0，change 的 state 与两份报告完整发布，根 `state.json` 只在 change 发布成功后更新。
-
-## 4. 深化风险结论
-
-逐仓库检查报告中的 Git 确认冲突、自动合并重叠和定制风险路径。对每条高风险路径使用报告冻结的 SHA 执行精确 `git diff <base>..<target> -- <path>`，再与 `customization-map.md` 的稳定不变量映射。
-
-只把路径级证据支持的语义结论补入本 change 的报告。保持 Git 冲突、自动合并重叠、定制合同风险和 dirty-worktree 重叠为四个类别；零文本冲突不得表述为集成安全。
-
-完成标准：所有冲突和定制热点都有结论或明确未验证项，报告中的命令可以从冻结 SHA 复现。
-
-## 5. 返回后续选择
-
-返回 change 路径、仓库 checkpoint、观测 upstream SHA、风险摘要和未验证项。列出适合继续处理的已安装 Work，但不自动创建 workflow change、不调用 Work、不 merge、不 commit、不 push；后续路线由用户选择。
-
-完成标准：本次 Skill 在评估 change 完整后停止，用户能用冻结产物自行选择下一 Work。
-
-## 6. 记录外部集成
-
-只有其他 Work 已完成集成且用户要求更新 checkpoint 时进入此分支。读取目标 change state，并运行：
-
-```bash
-node <Path>{roots.skills}/upstream-fork-sync/scripts/upstream-sync.mjs</Path> record-integration \
-  --root . \
-  --state-root <Path>{roots.state}/skills/upstream-fork-sync</Path> \
-  --repository-map <Path>{roots.state}/skills/upstream-fork-sync/repository-map.json</Path> \
-  --change <change> \
-  --repository <repository-id> \
-  --merge-commit <full-sha> \
-  --upstream-sha <full-sha> \
-  --verification '<command>: exit 0'
-```
-
-该入口只在 merge commit 可从产品 ref 到达、目标 upstream SHA 是其精确非第一父节点且匹配 change 冻结目标时更新状态；它不执行集成。
-
-完成标准：change state 和根 checkpoint 都已原子重读，实际 Git 历史与记录一致。
-
-## 停止条件
-
-目标 ref 缺失、保存的 checkpoint 不在产品历史、checkpoint 不在当前 upstream 历史、存在多个 merge-base、配置越界或状态 schema 非法时，停止且不移动 refs、不发布部分 change、不推进 checkpoint。返回准确 repository id、路径、refs 与 SHAs。

package/template/skills/writing-great-skills/SKILL.md

@@ -1,23 +0,0 @@
----
-name: writing-great-skills
-description: Reference guidance for explicitly requested skill authoring or review; never auto-trigger.
-metadata: {"speculo-id": "writing-great-skills", "speculo-kind": "skill", "speculo-invocation": "user-only"}
----
-
-# writing-great-skills
-
-Activation is explicit-only. Metadata is descriptive; enforce host permissions and obtain user authorization before effects.
-
-This file is the routing entry. Read [`references/entry-procedure.md`](references/entry-procedure.md) only after this skill is selected. Read a named reference there only for the active branch.
-
-## Scope
-
-- Trigger: Reference guidance for explicitly requested skill authoring or review; never auto-trigger.
-- Output and write owner remain those declared by the entry procedure and the owning command/workflow.
-- Do not infer missing scope, credentials, target, or authorization.
-
-For an authorized review or rewrite of a skill/document, read [`references/document-contract.md`](references/document-contract.md) before editing. Its fidelity checks apply to any document; this does not change this skill’s explicit-only activation policy.
-
-## Stop
-
-Stop before side effects when the required input, owner, reference, confirmation, schema, or recovery evidence is missing; report the exact blocker and preserve any dry-run evidence.