القائمة
使用本仓库的 ds CLI + Python 生成稳定结构的 A 股数据报告。只要用户想“给一个股票名称/代码生成报告”“批量前先验证单个标的报告流程”“按当前仓库固定模板重跑报告”，就应该使用这个 skill，即使用户没有明确提到 skill 名称。默认依赖本地 `ds` 已安装并登录、`python3` 可用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Local Markdown issue tracking system for managing feature requests, bugs, and version iterations within project repositories. Use when the user says "创建 issue", "新建需求", "建 bug", "issue", "需求跟踪", "版本迭代", "milestone", "里程碑", "看板", "issue 状态", "关联 PR", "更新进度", "归档", "backlog", or wants to create, update, query, move, or visualize issues stored in the local .issues/ directory. Also trigger when the user asks to generate an HTML view of an issue, check PR status, move issues between milestones or status lanes, initialize issue tracking for a project, or produce a summary of current iteration progress. Trigger even if the user just says "开个 issue" or references an issue ID like "RD-400".
Use when designing, reviewing, or refactoring a command-line interface that AI agents will invoke — covers non-interactive execution, resource/command layering, unified verbs, output trimming for token budgets, idempotency, and self-correcting error messages. Trigger this when building a new CLI, wrapping an API as a CLI, or auditing an existing CLI for agent usability.
Use when parsing, exporting, visualizing, or computing token/cost stats from local coding-agent session files (Codex rollout jsonl, Claude Code project jsonl, Kimi context/wire jsonl, OpenCode/zcode SQLite, Pi tree jsonl). Covers storage paths per agent, message schemas, assistant message ordering/dedup rules, a unified export schema, cache-aware cost calculation, and streaming-parse performance rules for 100-400MB files.
Use when organizing a monorepo, splitting a single repo into packages, evaluating an architecture migration, or reviewing structural decisions. Covers the layered apps/packages paradigm (single contract layer, one-way dependency DAG, bottom-up extraction order), ten recurring architecture principles (single data source with no fallback forks, execution-location correctness, cost-vs-pain gating for rewrites), named anti-patterns, and native-module/packaging pitfalls.
Use when bootstrapping a new project or aligning an existing one to house conventions — frontend/fullstack (bun+vite+react+tailwind v4+shadcn+oxlint/oxfmt), browser extensions (WXT/MV3), Python CLI (uv+hatchling+Typer+just), Go CLI (mise+golangci-lint+just). Provides drop-in config templates, script naming conventions per stack, icon/zip pipelines, and the concise AGENTS.md format (readable in one minute).
Use when generating a changelog, bumping a version, or publishing a release for a project that maintains Chinese + English changelogs (CHANGELOG.md / CHANGELOG_zh.md / docs/zh + docs/en). Covers commit-range analysis, user-facing wording rules, single-source versioning per language stack (Python hatchling, Go ldflags, npm multi-platform, frontend package.json), tag/CI publishing, and recovery from partially failed releases.
| name | stock-report |
| description | 使用本仓库的 ds CLI + Python 生成稳定结构的 A 股数据报告。只要用户想“给一个股票名称/代码生成报告”“批量前先验证单个标的报告流程”“按当前仓库固定模板重跑报告”，就应该使用这个 skill，即使用户没有明确提到 skill 名称。默认依赖本地 `ds` 已安装并登录、`python3` 可用。 |
这个 skill 的目标很窄：给定一个 A 股标的名称或代码，用本仓库固定的 DS 数据采集链路拉数，并生成统一版式的 HTML 报告。
它不是泛化的股票分析 skill，也不是 MCP skill。这里的真源是：
./cli-data-fetch-guide.md./scripts/fetch_and_generate_stock_report.py./scripts/generate_ds_report.py出现以下任一情况时，直接使用本 skill：
如果用户要的是：
支持两种输入：
000728.SZ国元证券如果用户给的是中文名称，脚本会先执行：
ds iid Stk search "<名称>" --output json
并先按 A 股主证券做精确匹配。
如果无法唯一确认标的，应该明确报错并要求用户提供 000728.SZ 这类准确 IID，不要猜测代码或直接取第一条。
执行前默认检查：
ds status
只有在以下条件满足时才继续：
ds 命令存在python3 可执行如果 ds status 失败，先告诉用户是环境/登录问题，不要继续生成半成品。
用 ds iid Stk search <标的名称> 确认标的的IID代码
运行：
python3 <skill_path>/scripts/fetch_and_generate_stock_report.py "<标的IID代码>"
这个脚本会自动做以下事情：
data/<股票代码>/raw/cli-data-fetch-guide.md 的固定专题清单抓取原始 JSONscripts/generate_ds_report.py 生成结构化 JSON 和 HTML 报告data/<股票代码>/run_summary.json不要临场删改这套查询清单。当前固定覆盖：
10009331000998100103410009871001006100099110009961000183100098910009781000964100096510009661000970100097110009611001348/1001352/1001351/1001353其中以下专题允许无数据：
100099810010061000978无数据时应保留空结果，并让最终报告明确显示“该标的暂无此类数据”，不要表述成抓取异常。
成功后，目标目录应至少包含：
data/<股票代码>/
├── raw/
├── basic_info.json
├── financial_data.json
├── shareholders.json
├── data_sources.md
├── run_summary.json
└── report/
└── report.html
其中 report.html 是用户主要关心的产物。
当前报告是固定 5 章结构：
关键约束：
data/601377/report/report.html 和 stock-analysis-report/template/report_template.html默认简洁交付：
如果你没有实际运行生成，不要暗示已经生成成功。
ds status 失败优先判断为环境或登录问题，提示用户先确认：
ds 是否安装iid search 没结果直接报“未识别到标的”，让用户提供更准确名称或代码。
如果该专题属于允许为空的范围：
如果不属于允许为空范围：
先检查：
不要手工改 HTML 兜底，优先修脚本真源。
需要修改或排查时，优先看：
./scripts/fetch_and_generate_stock_report.py：一键采集入口./scripts/generate_ds_report.py：HTML/JSON 生成逻辑./cli-data-fetch-guide.md：DS 查询专题清单示例 1：直接生成报告
输入：
给我生成国元证券的报告
执行：
python3 <skill_path>/scripts/fetch_and_generate_stock_report.py "国元证券"
示例 2：按代码重跑
输入：
重跑 000728.SZ 的报告
执行：
python3 <skill_path>/scripts/fetch_and_generate_stock_report.py "000728.SZ"